ここでは、更新済みのContainer Managementを切り戻す手順について説明します。
以下の事項が前提です。
Automation Manager コンテナおよびContainer Managementが更新されていること。
「13.3.1 メディアパック配置場所の設定」の手順を実施済みであること。
「13.3.4 flannel」および「13.3.5 Ingress Controller」の手順を実施済みであること。
Log ManagementおよびMetrics Managementが切り戻されていること。
注意
本作業中、Container Managementで動作するアプリケーションの通信に影響があるため、業務影響を考慮し、実施可能なタイミングで実施してください。
Container Managementの切り戻しでは、Kubernetes nodeサーバーを1台ずつ、配備されたアプリケーション(コンテナ)を別のKubernetes nodeサーバーに退避させながら切り戻しを行います。そのため、切り戻し後にアプリケーションが一部のKubernetes nodeサーバーに偏って配置される場合があります。偏って配置された場合でも正常に動作するようリソース使用量を考慮し、切り戻しを計画してください。 詳細は「設計ガイド(FJCS仕様)」-「Automation Managerに関する設定」-「Container Managementに関する設定」を参照してください。
更新、および、切り戻しの操作は多重実行できません。各操作はシーケンシャルに実行してください。
Automation Managerコンテナにログインし、以下の手順を行うことでContainer Managementの切り戻しができます。 コマンドで使用する<環境識別子>は、「インストールガイド(FJCS仕様)」- 「インストール手順」実施時に環境を一意に識別するために指定した任意の文字列を指定します。
事前準備
以下のコマンドを実行し、更新に必要なファイルを生成します。
# cd /data/playbook # ansible-playbook -i inventories/<環境識別子>/hosts play_create_playbook_for_update_tool.yml
Container Managementの切り戻し
# cd /data/playbook # ansible-playbook -i inventories/<環境識別子>/hosts play_backout_container_mng.yml
コマンドを実行すると、以下のメッセージが表示されます。誤って実行した場合や前提条件を満たしていない場合は、「n」を入力し、Enterキーを押下することで切り戻しを中断できます。切り戻しを継続する場合は「y」を入力し、Enterキーを押下します。
[Please confirm] ============================================================== [WARNING] Do you want to backout Container Management? (y/n) ============================================================== :
注意
Kubernetesの切り戻し処理では、nodeサーバーを1台ずつ、配備されたPodを別のnodeサーバーに退避させながらメンテナンスします。 メンテナンス中のnodeサーバーにアプリケーションへのリクエストを振り分けないように、メンテナンス前後に以下のメッセージが出力され切り戻し処理が一時停止されます。 「操作ガイド(FJCS仕様)」の手順に従い、API Proxyからnodeサーバーへの振り分け停止および再開を実施してください。
メンテナンス前には以下のメッセージが表示されます。
【メッセージ】
[backout/container_mng/k8s_cluster : confirm] ====================================================== [WARNING] Backout the version of k8s_node [<IPアドレス>] to <バージョン>. Please prepare to continue working on other k8s nodes instead of the [<IPアドレス>]. If you are ready to continue, please press enter key. ======================================================
【説明】
<IPアドレス>のKubernetes nodeサーバーを<バージョン>に切り戻します。 <IPアドレス>のKubernetes nodeサーバーへの振り分けを停止してください。 振り分け停止後、Enterキーを押下し、処理を再開してください。
メンテナンス後には以下のメッセージが表示されます。
【メッセージ】
[backout/container_mng/k8s_cluster : confirm] ====================================================== [WARNING] k8s_node [<IPアドレス>] has been backout to <バージョン>. Please prepare to resume work on k8s_node [<IPアドレス>]. If you are ready to continue, please press enter key. ======================================================
【説明】
<IPアドレス>のKubernetes nodeサーバーを<バージョン>に切り戻しました。 <IPアドレス>のKubernetes nodeサーバーへの振り分けを再開してください。 振り分け再開後、Enterキーを押下し、処理を再開してください。
【正常終了時】
正常終了時は下記のようにunreachable=0, failed=0となり、XX、YYは任意の整数が記載されています。
PLAY RECAP ********************************************************************* 127.0.0.1 : ok=XX changed=YY unreachable=0 failed=0
【異常終了時】
異常終了時は下記のようにunreachable, failedのAAおよびBBは1以上の任意の整数が記載されています。
PLAY RECAP ********************************************************************* 127.0.0.1 : ok=XX changed=YY unreachable=AA failed=BB