ここでは、CI Managementを旧バージョンから本バージョンにアップデートする手順について説明します。
以下の事項が前提です。
Automation Managerが本バージョンにアップデート済みであること。
「更新ツールの実行準備」の[更新時]の手順を実施済みであること。
注意
アップデート作業中、CI Managementの各サービスは使用できません。
更新ツールでは「概説書」のサポート範囲で、既存のデータおよびオープンソースの設定ファイルを、アップデート後のオープンソースに適用します。オープンソースの設定ファイルや機能に対して個別に追加・設定した場合は更新後、設定を引き継げない場合があります。個別に機能・設定を追加した場合は、該当のオープンソースを業務とは異なる環境で再現・更新することで引き継ぎ可能であることを検証し、更新ツールを実行してください。
オープンソースのアップデートの際、非互換である機能の取り込みが含まれる可能性があります。切り戻しによっても更新前に復元できない場合に備え、更新前に必ずバックアップを取得してください。バックアップ方法は「運用ガイド」を参照してください。
更新、および、切り戻しの操作は多重実行できません。各操作はシーケンシャルに実行してください。
Automation Managerコンテナにログインし、以下の手順を行うことでCI Managementのアップデートができます。
CI Managementのアップデート
以下のコマンドを実施しCI Managementをアップデートできます。
<環境識別子>は、「第2章 インストール手順」実施時に環境を一意に識別するために指定した任意の文字列を指定します。
# cd /data/playbook # ansible-playbook -i inventories/<環境識別子>/hosts play_update_ci_mng.yml
コマンドを実行すると、以下のメッセージが表示されます。誤って実行した場合や前提・業務無停止の条件を満たしていない場合は、「n」を入力し、Enterキーを押下することでアップデートを中断できます。アップデートを継続する場合は「y」を入力し、Enterキーを押下します。
[Please confirm] ============================================================== [WARNING] Do you want to run Update CI Management? (y/n) ============================================================== :
参考
【オプション説明】
Ansibleのコマンドオプションを利用することで、CI Managementのアップデートをサーバ単位およびオープンソース単位で実施できます。
これにより、CI Managementの利用状況に合わせてアップデートを計画することができます。
ただし、旧バージョンと本バージョンが混在する状態での動作は保証されません。本オプションを利用する場合は、速やかに全てのサーバおよびオープンソースをアップデートすることを推奨します。
--limitオプション
指定したサーバを対象にアップデートを実行します。
# ansible-playbook -i inventories/<環境識別子>/hosts play_update_ci_mng.yml --limit=<サーバ>
指定値 | 対象サーバ |
---|---|
gitlab | GitLabサーバ |
gitlab_runner | GitLab Runnerサーバ |
--tagsオプション
指定したtagのオープンソースを対象にアップデートを実行します。
# ansible-playbook -i inventories/<環境識別子>/hosts play_update_ci_mng.yml --tags=<tag>
指定値 | 対象オープンソース |
---|---|
gitlab | GitLab、GitLab Mattermost |
gitlab_runner | GitLab Runner |
redmine | Redmine |
sonarqube | SonarQube |
docker | Docker |
【正常終了時】
正常終了時は下記のようにunreachable=0, failed=0となり、XX、YYは任意の整数が記載されています。
PLAY RECAP ********************************************************************* 127.0.0.1 : ok=XX changed=YY unreachable=0 failed=0
【異常終了時】
異常終了時は下記のようにunreachable, failedのAAおよびBBは任意の整数が記載されています。
PLAY RECAP ********************************************************************* 127.0.0.1 : ok=XX changed=YY unreachable=AA failed=BB