diff --git a/specs/translation_check_site.rst b/specs/translation_check_site.rst index 896ce60..a45becf 100644 --- a/specs/translation_check_site.rst +++ b/specs/translation_check_site.rst @@ -1,6 +1,7 @@ :: Copyright 2015 Łukasz Jernaś + Copyright 2017 Frank Kloeker This work is licensed under a Creative Commons Attribution 3.0 Unported License. @@ -32,33 +33,34 @@ between every translation group. Proposed Change =============== -A sample OpenStack instance should be provided to translators, which runs -the current working branch and regularly fetches updated translations. +A sample OpenStack instance should be provided to translators, which +runs the current working branch and regularly fetches updated translations. The instance should run Horizon and every module supported by the stock dashboard. - -This could be achieved by running a DevStack instance on a host, which would -fetch translation from the current translation system by a cron schedule. -The entire DevStack environment should be refreshed approximately once a week -because the environment itself is string freezed during translation peak -period. The translation update, that is translation import job, is run once -a day. The instance should be able to spawn pseudo VMs that are using fake -virt driver, create networks and all other capabilities provided by Horizon, -but should be firewalled off from the rest of the world with a periodic -cleanup of all resources. - +This could be achieved with openstack-ansible AIO. +AIO means "all in one". OpenStack components are installed in separate container +(i.e. Horizon) on a single VM. Advantages for containers are: easy to manage +(i.e. snapshot backup and recovery in case of failed updates of the horizon container). +openstack-ansible itself is reboot-save. It's not necessary to re-install +from scratch like DevStack. In the Horizon container a script is installed +to fetch the translation file periodically from the translation server via cron, +compile it and serves the new content to the dashboard. The dashboard contents +the core functionality plus core plugins. The instance should be able to spawn +pseudo VMs that are using fakevirt driver, create networks and all other +capabilities provided by Horizon, but should be firewalled off from the rest +of the world with a periodic cleanup of all resources. There is no need for SSO integration as the only required accounts are a shared admin and a user account, with the credentials known to the translation team. - +The sync cycle of the translation files is configurable. Update mechanism for +different branches or releases of the dashboard are also configurable and done +by ansible. The installed AIO should upgraded 4 times each cycle: soft/hard +string freeze, release, stable. Alternatives ------------ - As an alternative a prebuilt VM image could be created for the translators -to run on their own workstations with a simple set of scripts to update -the translations. However this might take the a similar amount of time -and also would require the translators to have sufficient hardware to run -such VM. +to run on their own workstations or cloud with a manual run of ansible +playbooks for update Horizon or sync the translation files. Implementation ============== @@ -67,13 +69,14 @@ Assignee(s) ----------- Primary assignee: - * Ying Chun Guo + * Frank Kloeker Also: - * Łukasz Jernaś - * Elizabeth K. Joseph - * Frank Kloeker - * KATO Tomoyuki + * Clark Boylan (Infrastructure side) + * Rob Cresswell (PTL Horizon) + * Andy McCrae (PTL OpenStackAnsible) + * Ian Y. Choi (PTL I18n) + * KATO Tomoyuki (I18n Core Team) Gerrit Topic ------------ @@ -110,7 +113,7 @@ teams. Documentation ------------- -Documentation related to configuration and potential DevStack debugging +Documentation related to configuration and potential AIO debugging for the infrastructure team in the system-config repository. Documentation for translators who will be using this. @@ -134,4 +137,5 @@ correctly. Dependencies ============ -This will require creation of a new puppet module. +This will require extension of openstack-ansible-os_horizon +