翻訳の確認方法¶

実際に使われる環境を使って翻訳を確認することは重要なことです。このページでは、翻訳の確認方法について説明します。

ドキュメント¶

docs.openstack.org を使った確認方法¶

翻訳されたドキュメントを OpenStack ドキュメントサイトで見ることができます。更新は 1 日 1 回行われます。ほとんどのコンテンツは以下のいずれかからリンクが張られています。

http://docs.openstack.org/<lang> には、リリース版のドキュメントが置かれます。 http://docs.openstack.org/ で "Languages" から開いてください。

翻訳されたドキュメントを作成するには、各レポジトリーの doc-tools-check-languages.conf ファイルを更新して、 BOOKS に ["ja"]="install-guide" のようなエントリーを追加する必要があります。

stable ブランチのドキュメントの場合 (例えば Liberty 版のインストールガイドなど)、対応する stable ブランチの doc-tools-check-languages.conf ファイルを直接更新する必要があります。

特定のブランチ向けに生成されたドキュメントは http://docs.openstack.org/<branch>/<language>/<document> に配置されます。例えば、 Liberty 版の Ubuntu 向けのインストールガイドのリンクは http://docs.openstack.org/liberty/ja/install-guide-ubuntu/ です。

To add a link to a generated document, you need to update the file www/<lang>/index.html in the master branch of the openstack-manuals repository. Note that the web pages are published from master branch, which contains the pages for all releases, such as Liberty. Therefore, you don't need to update the file www/<lang>/index.html in the stable branch.

You can also check:

OpenStack 開発者ドキュメント¶

Currently, we do not support translations for OpenStack developer documents: http://docs.openstack.org/<project>

OpenStack Dashboard¶

OpenStack-Ansible を実行する方法¶

OpenStack-Ansible (OSA) は、 OpenStack 環境のデプロイや設定を行う Ansible プレイブックやロールを提供しています。このプロジェクトの中で「翻訳確認サイト」という機能が開発されました。 OSA インスタンスは、 translation platform から翻訳ストリングを取得し、コンパイルを行ってから、 Horizon で参照できるようにします。 OSA を実行するには、 2 個か 4 個の CPU コア、少なくとも 8GB のメモリーと 70 GB のディスクを持ったマシンが必要です。

$ BRANCH=master
$ git clone -b ${BRANCH} https://github.com/openstack/openstack-ansible /opt/openstack-ansible
$ cd /opt/openstack-ansible
$ ./scripts/gate-check-commit.sh translations

tests/vars/bootstrap-aio-vars.yml で AIO でインストールするコンポーネントを設定できます。自身の環境に依存しますが、インストールには 1〜2 時間かかります。 AIO の設定の詳しい情報については OSA AIO ドキュメントを参照してください。

定期的に翻訳されたファイルを取得するには、以下のコマンドを手動か cron で実行します。

$ cd /opt/openstack-ansible/playbooks; \
  openstack-ansible os-horizon-install.yml \
  -e horizon_translations_update=True \
  -e horizon_translations_project_version=master \
  --tags "horizon-config"

DevStack を実行する方法¶

別のお手軽な方法は、自分の手元の環境で DevStack を実行して翻訳を確認する方法です。 DevStack を実行するには、 local.conf を準備する必要がありますが、心配しないでください。 local.conf ファイルの例がいくつもインターネット上で共有されていますし、最も簡単な例は以下にあります。これまでの経験上、 DevStack を快適に実行するのに必要なマシンスペックは、 CPU コアが 2 か 4、メモリーが 8GB、ディスクが 20 GB です。 OpenStack の主要プロジェクトだけを動かしたい場合は、マシンに必要なメモリーは 2〜4 GB ともっと少なくなります。

$ BRANCH=master
$ git clone https://opendev.org/openstack/devstack.git
$ cd devstack
$ git checkout $BRANCH
<prepare local.conf>
$ ./stack.sh
<wait and wait... it takes 20 or 30 minutes>

$BRANCH は適切なブランチに置き換えてください。 master, stable/newton, stable/mitaka など。

以下の例は、 Newton リリースで、コアコンポーネント (keystone, nova, glance, neutron, cinder) と horizon, swift, heat を動かすための local.conf です。 horizon のコードが対応しているコンポーネントが選択されています。

[[local|localrc]]
BRANCH=stable/newton
# NOTE: We need to specify a branch explicitly until DevStack stable branch
# is prepared. At now, swift has no stable/newton branch.
CINDER_BRANCH=$BRANCH
GLANCE_BRANCH=$BRANCH
HEAT_BRANCH=$BRANCH
HORIZON_BRANCH=$BRANCH
KEYSTONE_BRANCH=$BRANCH
NEUTRON_BRANCH=$BRANCH
NOVA_BRANCH=$BRANCH
SWIFT_BRANCH=master

# When OS_CLOUD envvar is set, DevStack will be confused.
unset OS_CLOUD

# Ensure to fetch the latest repository when rerunning DevStack
RECLONE=True

# Translation check site usually does not use tempest.
disable_service tempest

enable_service heat h-api h-api-cfn h-api-cw h-eng
enable_service s-proxy s-object s-container s-account

enable_plugin neutron https://git.openstack.org/openstack/neutron $BRANCH
enable_service q-qos

enable_plugin neutron-vpnaas https://git.openstack.org/openstack/neutron-vpnaas $BRANCH

LOGFILE=$DEST/logs/devstack.log
SCREEN_HARDSTATUS="%{= rw} %H %{= wk} %L=%-w%{= bw}%30L> %n%f %t*%{= wk}%+Lw%-17< %-=%{= gk} %y/%m    /%d %c"
LOGDAYS=2
IDENTITY_API_VERSION=3

ADMIN_PASSWORD=change_me
MYSQL_PASSWORD=change_me
RABBIT_PASSWORD=change_me
SERVICE_PASSWORD=change_me

最新の翻訳の入手方法¶

翻訳はそれぞれのプロジェクトのリポジトリーに毎日取り込まれます。したがって、ほとんどの場合、自分で Zanata から翻訳を取得する必要はありません。必要なことは、最新の Horizon コードを取得することだけです。

DevStack を実行している場合、以下の 2 つの方法があります。

1 つ目の方法は horizon ノードのみを更新する方法です。以下のシェルスクリプトは、最新の horizon のコードを取得し、翻訳メッセージカタログをコンパイルし、 apache httpd サーバーをリロードします。 $BRANCH は適切なブランチ (master, stable/newton, stable/mitaka など) に置き換えてください。

#!/bin/bash

# Target branch: master, stable/pike, ...
BRANCH=stable/pike

cd /opt/stack/horizon

# Remove stale compiled python files
find horizon -name '*.pyc' | xargs rm
find openstack_dashboard -name '*.pyc' | xargs rm

# Fetch the latest code from git
git checkout $BRANCH
git remote update origin
git merge origin/$BRANCH

python manage.py compilemessages
python manage.py collectstatic --noinput
python manage.py compress --force
sudo service apache2 reload

もう 1 つの方法は、 DevStack の再実行です。 stack.sh を実行する前に local.conf に RECLONE=True を追加してください。こうすることで、 DevStack は horizon や他のプロジェクトの最新のコードを取得するようになります。

$ cd devstack
$ ./unstack.sh
<Ensure RECLONE=True in your local.conf>
$ ./stack.sh
<It takes 10 or 15 minutes>

CLI (コマンドラインインターフェース)¶

TBD

サーバープロジェクト¶

TBD

翻訳の確認方法