Red Hat OpenStack Platform の最新状態の維持

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. RhsmVars パラメーターが含まれるオーバークラウドのサブスクリプション管理用環境ファイルを編集します。通常、このファイルのデフォルト名は rhsm.yml です。

4. サブスクリプション管理の設定で、rhsm_releaseパラメーターが含まれているかどうかを確認してください。rhsm_release パラメーターが存在しない場合は、追加して 8.4 に設定します。

   parameter_defaults:
     RhsmVars:
       …​
       rhsm_username: "myusername"
       rhsm_password: "p@55w0rd!"
       rhsm_org_id: "1234567"
       rhsm_pool_ids: "1a85f9223e3d5e43013e3d6e8ff506fd"
       rhsm_method: "portal"
       rhsm_release: "8.4"

5. オーバークラウドのサブスクリプション管理用環境ファイルを保存します。

6. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

7. すべてのノードでオペレーティングシステムのバージョンを RHEL8.4 にロックするタスクを含めて、Playbook を作成します。

   $ cat > ~/set_release.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: set release to 8.4
         command: subscription-manager release --set=8.4
         become: true
   EOF

8. set_release.yaml Playbook を実行します。

   $ ansible-playbook -i ~/inventory.yaml -f 25 ~/set_release.yaml --limit <undercloud>,<Controller>,<Compute>

   • --limit オプションを使用して、コンテンツをすべての RHOSP ノードに適用します。<undercloud>、<Controller>、<Compute> を、それらのノードを含む環境内の Ansible グループに置き換えます。
   • これらのノードに別のサブスクリプションを使用している場合は、Ceph Storage ノードに対してこの Playbook を実行することはできません。

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. RhsmVars パラメーターが含まれるオーバークラウドのサブスクリプション管理用環境ファイルを編集します。通常、このファイルのデフォルト名は rhsm.yml です。

4. サブスクリプション管理の設定で rhsm_repos パラメーターを確認します。このパラメーターに TUS リポジトリーが含まれていない場合、該当するリポジトリーを TUS バージョンに変更します。

   parameter_defaults:
     RhsmVars:
       rhsm_repos:
         - rhel-8-for-x86_64-baseos-tus-rpms
         - rhel-8-for-x86_64-appstream-tus-rpms
         - rhel-8-for-x86_64-highavailability-tus-rpms
         - ansible-2.9-for-rhel-8-x86_64-rpms
         - openstack-16.2-for-rhel-8-x86_64-rpms
         - rhceph-4-tools-for-rhel-8-x86_64-rpms
         - fast-datapath-for-rhel-8-x86_64-rpms

5. オーバークラウドのサブスクリプション管理用環境ファイルを保存します。

6. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

7. すべてのノードでリポジトリーを RHEL 8.4 TUS に設定するタスクを含む Playbook を作成します。

   $ cat > ~/change_tus.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change to tus repos
         command: subscription-manager repos --disable=rhel-8-for-x86_64-baseos-eus-rpms --disable=rhel-8-for-x86_64-appstream-eus-rpms --disable=rhel-8-for-x86_64-highavailability-eus-rpms --enable=rhel-8-for-x86_64-baseos-tus-rpms --enable=rhel-8-for-x86_64-appstream-tus-rpms --enable=rhel-8-for-x86_64-highavailability-tus-rpms
         become: true
   EOF

   • 環境に標準リポジトリーが含まれている場合は、以下のリポジトリーを無効にします。

     • rhel-8-for-x86_64-baseos-rpms
     • rhel-8-for-x86_64-appstream-rpms
     • rhel-8-for-x86_64-highavailability-rpms

8. change_tus.yaml Playbook を実行します。

   $ ansible-playbook -i ~/inventory.yaml -f 25 ~/change_tus.yaml --limit <undercloud>,<Controller>,<Compute>

   • すべての Red Hat OpenStack Platform ノードにコンテンツを適用するには、--limit オプションを使用します。<undercloud>、<Controller>、<Compute> を、それらのノードを含む環境内の Ansible グループに置き換えます。
   • これらのノードに別のサブスクリプションを使用している場合は、Ceph Storage ノードに対してこの Playbook を実行することはできません。

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. RhsmVars パラメーターが含まれるオーバークラウドのサブスクリプション管理用環境ファイルを編集します。通常、このファイルのデフォルト名は rhsm.yml です。

4. サブスクリプション管理の設定で rhsm_repos パラメーターを確認します。rhsm_repos パラメーターで RHOSP 16.1 リポジトリーおよび Ansible 2.8 リポジトリーが使用されている場合は、リポジトリーを正しいバージョンに変更します。

   parameter_defaults:
     RhsmVars:
       rhsm_repos:
         - rhel-8-for-x86_64-baseos-tus-rpms
         - rhel-8-for-x86_64-appstream-tus-rpms
         - rhel-8-for-x86_64-highavailability-tus-rpms
         - ansible-2.9-for-rhel-8-x86_64-rpms
         - openstack-16.2-for-rhel-8-x86_64-rpms
         - fast-datapath-for-rhel-8-x86_64-rpms

5. オーバークラウドのサブスクリプション管理用環境ファイルを保存します。

6. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

7. すべての RHOSP ノードで、リポジトリーを RHOSP 16.2 に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/update_rhosp_repos.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change osp repos
         command: subscription-manager repos --disable=openstack-16.1-for-rhel-8-x86_64-rpms --enable=openstack-16.2-for-rhel-8-x86_64-rpms --disable=ansible-2.8-for-rhel-8-x86_64-rpms --enable=ansible-2.9-for-rhel-8-x86_64-rpms
         become: true
   EOF

8. update_rhosp_repos.yaml Playbook を実行します。

   $ ansible-playbook -i ~/inventory.yaml -f 25 ~/update_rhosp_repos.yaml --limit <undercloud>,<Controller>,<Compute>

   • --limit オプションを使用して、コンテンツをすべての RHOSP ノードに適用します。<undercloud>、<Controller>、<Compute> を、それらのノードを含む環境内の Ansible グループに置き換えます。
   • これらのノードに別のサブスクリプションを使用している場合は、Ceph Storage ノードに対してこの Playbook を実行することはできません。

9. すべての Ceph Storage ノードで、リポジトリーを RHOSP 16.2 に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/update_ceph_repos.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change ceph repos
         command: subscription-manager repos --disable=openstack-16-deployment-tools-for-rhel-8-x86_64-rpms --enable=openstack-16.2-deployment-tools-for-rhel-8-x86_64-rpms --disable=ansible-2.8-for-rhel-8-x86_64-rpms --enable=ansible-2.9-for-rhel-8-x86_64-rpms
         become: true
   EOF

10. update_ceph_repos.yaml Playbook を実行します。

    $ ansible-playbook -i ~/inventory.yaml -f 25 ~/update_ceph_repos.yaml --limit CephStorage

    --limit オプションを使用して、コンテンツを Ceph Storage ノードに適用します。

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. オーバークラウドの静的なインベントリーファイルを作成します。

   $ tripleo-ansible-inventory --ansible_ssh_user heat-admin --static-yaml-inventory ~/inventory.yaml

   デフォルトのオーバークラウド名 overcloud 以外のオーバークラウド名を使用する場合は、--plan オプションを使用して実際のオーバークラウドの名前を設定します。

4. すべてのノードで container-tools モジュールをバージョン 3.0 に設定するタスクが含まれる Playbook を作成します。

   $ cat > ~/container-tools.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: disable default dnf module for container-tools
         command: dnf module reset -y container-tools
         become: true
       - name: set dnf module for container-tools:3.0
         command: dnf module enable -y container-tools:3.0
         become: true
   EOF

5. すべてのノードに対して container-tools.yaml Playbook を実行します。

   $ ansible-playbook -i ~/inventory.yaml -f 25 ~/container-tools.yaml

手順

1. コンテナー準備ファイルを編集します。通常、このファイルのデフォルト名は containers-prepare-parameter.yaml です。

2. それぞれのルールセットについて、tag パラメーターが 16.2 に設定されていることを確認します。

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       set:
         …​
         tag: '16.2'
       tag_from_label: '{version}-{release}'

   注記

   更新に特定のタグ (16.2 や 16.2.2 等) を使用しない場合は、tag キーと値のペアを削除し、tag_from_label のみを指定します。これにより、更新プロセスの一部として使用するタグの値を決定する際に、インストールされた Red Hat OpenStack Platform バージョンが使用されます。

3. このファイルを保存します。

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. カスタムのオーバークラウド SSL/TLS パブリックエンドポイントファイルを編集します。通常、このファイルの名前は ~/templates/enable-tls.yaml です。

4. resource_registry から NodeTLSData リソースを削除します。

   resource_registry:
     OS::TripleO::NodeTLSData: /usr/share/openstack-tripleo-heat-templates/puppet/extraconfig/tls/tls-cert-inject.yaml
     ...

   オーバークラウドデプロイメントは、HAProxy の新しいサービスを使用して SSL/TLS が有効かどうかを判断します。

   注記

   これがenable-tls.yaml ファイルの resource_registry セクションにある唯一のリソースである場合、resource_registry セクションをすべて削除します。

5. SSL/TLS パブリックエンドポイントファイルを保存します。

6. Red Hat OpenStack Platform 16.1 から更新する場合、すべての更新前チェックに合格するには、Red Hat Identity Manager (IdM) でパーミッションを更新する必要があります。IdM を実行しているサーバーに ssh を使用してログインし、次のコマンドを実行します。

   $ kinit admin
   $ ipa privilege-add-permission 'Nova Host Management' --permission 'System: Modify Realm Domains'

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. source コマンドで stackrc ファイルを読み込みます。

   $ source ~/stackrc

3. コントローラーノードにログインし、Pacemaker コマンドを実行してフェンシングを無効にします。

   $ ssh heat-admin@<controller_ip> "sudo pcs property set stonith-enabled=false"

   <controller_ip> を、コントローラーノードの IP アドレスに置き換えます。コントローラーノードの IP アドレスは、openstack server list コマンドで確認できます。

4. fencing.yaml環境ファイルで、EnableFencingパラメーターをfalseに設定し、更新プロセス中にフェンシングが無効のままとなるようにします。

手順

1. アンダークラウドノードで、stackユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. dnfupdateコマンドを使用して director メインパッケージを更新します。

   $ sudo dnf update -y python3-tripleoclient* tripleo-ansible ansible

4. openstack undercloudupgradeコマンドを使用してアンダークラウド環境を更新します。

   $ openstack undercloud upgrade

5. アンダークラウドの更新プロセスが完了するまで待ちます。

6. アンダークラウドをリブートして、オペレーティングシステムのカーネルとその他のシステムパッケージを更新します。

   $ sudo reboot

7. ノードがブートするまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. stack ユーザーのホーム下の images ディレクトリー (/home/stack/images) から既存のイメージを削除します。

   $ rm -rf ~/images/*

3. アーカイブをデプロイメントします。

   $ cd ~/images
   $ for i in /usr/share/rhosp-director-images/overcloud-full-latest-16.2.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-16.2.tar; do tar -xvf $i; done
   $ cd ~

4. director に最新のイメージをインポートします。

   $ openstack overcloud image upload --update-existing --image-path /home/stack/images/

5. ノードが新しいイメージを使用するように設定します。

   $ openstack overcloud node configure $(openstack baremetal node list -c UUID -f value)

6. 新規イメージが存在することを確認します。

   $ openstack image list
   $ ls -l /var/lib/ironic/httpboot

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. 更新準備コマンドを実行します。

   $ openstack overcloud update prepare \
       --templates \
       --stack <stack_name> \
       -r <roles_data_file> \
       -n <network_data_file> \
       -e <environment_file> \
       -e <environment_file> \
       ...

   以下のオプションの中で、お使いの環境に適切なオプションを追加します。

   • オーバークラウドスタックの名前がデフォルトの名前 overcloud とは異なる場合は、更新の準備コマンドに --stack オプションを追加し、<stack_name> を実際のスタック名に置き換えます。
   • 専用のカスタムロールを使用する場合は、カスタムロール (<roles_data>) のファイルを追加します (-r)。
   • カスタムネットワークを使用する場合は、コンポーザブルネットワーク (<network_data>) のファイルを追加します (-n)
   • 高可用性クラスターをデプロイする場合は、更新の準備コマンドに --ntp-server オプションを追加するか、環境ファイルに NtpServer パラメーターおよび値を追加します。
   • すべてのカスタム設定環境ファイル (-e)
3. 更新の準備プロセスが完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. container_image_prepare タグの付いたタスクに対して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags container_image_prepare

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. ovn タグを持つタスクに対して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags ovn

   • オーバークラウドスタックの名前がデフォルトのスタック名 overcloud と異なる場合は、スタック名を --stack オプションで設定し、<stack_name> をスタックの名前に置き換えます。
4. ovn-controller コンテナーの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit Controller

3. コントローラーノードの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit Compute

3. Compute ノードの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit ComputeHCI

   • <stack_name> をスタックの名前に置き換えます。指定されていない場合、デフォルトは overcloud です。
3. ノードの更新が完了するまで待ちます。

4. Ceph Storage の更新コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags ceph

5. Compute HCI ノードの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. 更新コマンドを実行します。

   $ openstack overcloud update run --stack <stack_name> --limit DistributedComputeHCI

3. DistributedComputeHCI ノードの更新が完了するまで待ちます。

4. Ceph Storage の更新コマンドを実行します。

   $ openstack overcloud external-update run --stack <stack_name> --tags ceph

5. DistributedComputeHCI ノードの更新が完了するまで待ちます。
6. 同じプロセスを使用して、DistributedComputeHCIScaleOut ノードを更新します。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. グループノードを更新します。

   グループ内のすべてのノードを更新するには、以下のコマンドを実行します。

   $ openstack overcloud update run --limit <GROUP_NAME>

   グループ内の単一ノードを更新するには、以下のコマンドを実行します。

   $ openstack overcloud update run --limit <GROUP_NAME> [NODE_INDEX]

   注記

   ノードを個別に更新する場合は、必ずすべてのノードを更新してください。

   グループ内の最初のノードのインデックスはゼロ (0) です。たとえば、CephStorage という名前のグループの最初のノードを更新するには、以下を実行します。

   openstack overcloud update run --limit CephStorage[0]

3. ノードの更新が完了するまで待ちます。

4. Ceph Storage container update コマンドを実行して ceph-ansible を外部プロセスとして実行し、Red Hat Ceph Storage 4 コンテナーを更新します。

   $ openstack overcloud external-update run --tags ceph

5. Ceph Storage コンテナーの更新が完了するまで待ちます。

手順

1. stackrc ファイルを取得します。

   $ source ~/stackrc

2. online_upgrade のタグを使用するタスクに対して openstack overcloud external-update run コマンドを実行します。

   $ openstack overcloud external-update run --tags online_upgrade

手順

1. アンダークラウドに stack ユーザーとしてログインします。

2. stackrc ファイルを取得します。

   $ source ~/stackrc

3. フェンシングが無効になっており、openstack overcloud update converge を実行しない場合は、フェンシングを再度有効化する必要があります。

   1. コントローラーノードにログインし、Pacemaker コマンドを実行してフェンシングを再度有効にします。

      $ ssh tripleo-admin@<controller_ip> "sudo pcs property set stonith-enabled=true"

      • <controller_ip> を、コントローラーノードの IP アドレスに置き換えます。コントローラーノードの IP アドレスは、openstack server list コマンドで確認できます。
   2. fencing.yaml 環境ファイルで、EnableFencing パラメーターの値を true に設定します。

4. オプション: 更新完了コマンドを実行します。

   $ openstack overcloud update converge \
       --templates \
       --stack <stack_name> \
       -r <roles_data_file> \
       -n <network_data_file> \
       -e <environment_file> \
       -e <environment_file> \
       ...
       ...

   以下のオプションの中で、お使いの環境に適切なオプションを追加します。

   • EnableFencing パラメーターが true に設定された fencing.yaml 環境ファイル。
   • オーバークラウドスタックの名前がデフォルトの名前 overcloud とは異なる場合は、更新の準備コマンドに --stack オプションを追加し、<stack_name> を実際のスタック名に置き換えます。
   • カスタムロールを使用する場合は、カスタムロール ( <roles_data>) ファイル (-r) を含めます。
   • カスタムネットワークを使用する場合は、コンポーザブルネットワーク (<network_data>) のファイルを追加します (-n)

   • すべてのカスタム設定環境ファイル (-e)

     更新の最終処理が完了するまで待ちます。

手順

1. リブートするノードにログインします。

2. オプション: ノードが Pacemaker リソースを使用している場合は、クラスターを停止します。

   [heat-admin@overcloud-controller-0 ~]$ sudo pcs cluster stop

3. ノードをリブートします。

   [heat-admin@overcloud-controller-0 ~]$ sudo reboot

4. ノードがブートするまで待ちます。

検証

1. サービスが有効になっていることを確認します。

   1. ノードが Pacemaker サービスを使用している場合は、ノードがクラスターに再度加わったか確認します。

      [heat-admin@overcloud-controller-0 ~]$ sudo pcs status

   2. ノードが Systemd サービスを使用している場合は、すべてのサービスが有効化されていることを確認します。

      [heat-admin@overcloud-controller-0 ~]$ sudo systemctl status

   3. ノードがコンテナー化されたサービスを使用している場合は、ノード上の全コンテナーがアクティブであることを確認します。

      [heat-admin@overcloud-controller-0 ~]$ sudo podman ps

手順

1. ceph-mon サービスを実行している Ceph Monitor または Controller ノードにログインし、Ceph Storage クラスターのリバランスを一時的に無効にします。

   $ sudo podman exec -it ceph-mon-controller-0 ceph osd set noout
   $ sudo podman exec -it ceph-mon-controller-0 ceph osd set norebalance

   注記

   マルチスタックまたは分散コンピュートノード (DCN) アーキテクチャーを使用している場合は、 nooutフラグとnorebalanceフラグの設定時にクラスター名を指定する必要があります。例: sudo podman exec -it ceph-mon-controller-0 ceph osd set noout --cluster <cluster_name>

2. 再起動する最初の Ceph Storage ノードを選択し、そのノードにログインします。

3. ノードをリブートします。

   $ sudo reboot

4. ノードがブートするまで待ちます。

5. ノードにログインして、クラスターのステータスを確認します。

   $ sudo podman exec -it ceph-mon-controller-0 ceph status

   pgmap により、すべての pgs が正常な状態 (active+clean) として報告されることを確認します。

6. ノードからログアウトして、次のノードを再起動し、ステータスを確認します。全 Ceph Storage ノードが再起動されるまで、このプロセスを繰り返します。

7. 完了したら、ceph-mon サービスを実行している Ceph Monitor または Controller ノードにログインし、クラスターの再調整を再度有効にします。

   $ sudo podman exec -it ceph-mon-controller-0 ceph osd unset noout
   $ sudo podman exec -it ceph-mon-controller-0 ceph osd unset norebalance

   注記

   マルチスタックまたは分散コンピュートノード (DCN) アーキテクチャーを使用している場合は、 nooutフラグとnorebalanceフラグの設定解除時にクラスター名を指定する必要があります。例: sudo podman exec -it ceph-mon-controller-0 ceph osd set noout --cluster <cluster_name>

8. 最終のステータスチェックを実行して、クラスターが HEALTH_OK を報告していることを確認します。

   $ sudo podman exec -it ceph-mon-controller-0 ceph status

インスタンスの移行ワークフロー

1. Compute ノードを再起動する前に、インスタンスを別のノードに移行するか決定します。
2. 再起動する Compute ノードを選択して無効にし、新規インスタンスをプロビジョニングしないようにします。
3. インスタンスを別の Compute ノードに移行します。
4. 空の Compute ノードを再起動します。
5. 空の Compute ノードを有効にします。