流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 编辑 overcloud 订阅管理环境文件，这是包含 RhsmVars 参数的文件。此文件的默认名称为 rhsm.yml。

4. 检查您的订阅管理配置是否包含 rhsm_release 参数。如果 rhsm_release 参数不存在，请添加它并将其设置为 9.2 ：

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

5. 保存 overcloud 订阅管理环境文件。

6. 创建一个 playbook，其中包含将操作系统版本锁定到所有节点上的 RHEL 9.2 的任务：

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

7. 运行 set_release.yaml playbook:

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

   • 将 <stack> 替换为您的堆栈的名称。
   • 使用 --limit 选项将内容应用到所有 RHOSP 节点。将 <undercloud>, <Controller>, <Compute> 替换为包含这些节点的环境中的 Ansible 组。不要针对 Ceph Storage 节点运行此 playbook，因为您可能具有这些节点的不同订阅。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 编辑 overcloud 订阅管理环境文件，这是包含 RhsmVars 参数的文件。此文件的默认名称为 rhsm.yml。

4. 检查订阅管理配置中的 rhsm_repos 参数。如果 rhsm_repos 参数使用 RHOSP 17.1 存储库，请将存储库改为正确的版本：

   parameter_defaults:
     RhsmVars:
       rhsm_repos:
         - rhel-9-for-x86_64-baseos-eus-rpms
         - rhel-9-for-x86_64-appstream-eus-rpms
         - rhel-9-for-x86_64-highavailability-eus-rpms
         - openstack-17.1-for-rhel-9-x86_64-rpms
         - fast-datapath-for-rhel-9-x86_64-rpms

5. 保存 overcloud 订阅管理环境文件。

6. 创建一个 playbook，其中包含将软件仓库设置为所有节点上的 RHOSP 17.1 的任务：

   $ cat > ~/update_rhosp_repos.yaml <<'EOF'
   - hosts: all
     gather_facts: false
     tasks:
       - name: change osp repos
         command: subscription-manager repos --enable=openstack-17.1-for-rhel-9-x86_64-rpms
         become: true
   EOF

7. 运行 update_rhosp_repos.yaml playbook:

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

   • 将 <stack> 替换为您的堆栈的名称。
   • 使用 --limit 选项将内容应用到所有 RHOSP 节点。将 <undercloud>、<Controller> 和 <Compute> 替换为包含这些节点的环境中的 Ansible 组。不要针对 Ceph Storage 节点运行此 playbook，因为它们通常使用不同的订阅。

8. 创建一个 playbook，其中包含一个任务，在所有 ceph 存储节点上将存储库设置为 RHOSP 17.1：

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

9. 运行 update_ceph_repos.yaml playbook:

   $ ansible-playbook -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml -f 25 ~/update_ceph_repos.yaml --limit CephStorage

   使用 --limit 选项将内容应用到 Ceph Storage 节点。

流程

1. 编辑容器准备文件。此文件的默认名称为 containers-prepare-parameter.yaml。

2. 确保每个规则集的 tag 参数设置为 17.1 ：

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       set:
         ...
         tag: '17.1'
       tag_from_label: '{version}-{release}'

   注意

   如果您不想将特定的标签用于更新，如 17.1 或 17.1.1，请删除 tag 键-值对，并只指定 tag_from_label。这使用安装的 Red Hat OpenStack Platform 版本来确定要在更新过程中使用的标签值。

3. 保存这个文件。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 登录到 Controller 节点并运行 Pacemaker 命令禁用隔离：

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

   • 将 <controller_ip > 替换为 Controller 节点的 IP 地址。您可以使用 metalsmith list 命令查找 Controller 节点的 IP 地址。
4. 在 fencing.yaml 环境文件中，将 EnableFencing 参数设置为 false，以确保隔离在更新过程中保持禁用。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 安装软件包进行验证：

   $ sudo dnf -y update openstack-tripleo-validations python3-validations-libs validations-common

4. 运行验证：

   $ validation run -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml --group pre-update

   • 将 <stack> 替换为堆栈的名称。

验证

1. 要查看验证报告的结果，请参阅使用 director 安装和管理 Red Hat OpenStack Platform 中的 查看验证历史记录。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 使用 dnf update 命令更新 director 主软件包：

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

4. 更新 undercloud 环境：

   $ openstack undercloud upgrade

5. 等待 undercloud 更新过程完成。

6. 重启 undercloud 以更新操作系统的内核和其他系统软件包：

   $ sudo reboot

7. 稍等片刻，直到节点启动。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 从 stack 用户的主目录（/home/stack/images）的 images 中删除任何存在的镜像。

   $ rm -rf ~/images/*

4. 解压存档：

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

5. 将最新的镜像导入到 director：

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

6. 将您的节点配置为使用新镜像：

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

7. 验证新镜像是否存在：

   $ ls -l /var/lib/ironic/httpboot /var/lib/ironic/images

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行 update 准备命令：

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

   包含与您的环境相关的以下选项：

   • 如果 overcloud 堆栈的名称与默认名称 overcloud 不同，请在更新准备命令中包含 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
   • 如果使用自己的自定义角色，请使用 -r 选项包含自定义角色(<roles_data_file>)文件。
   • 如果使用自定义网络，请使用 -n 选项在(<network_data_file>)文件中包含您的可组合网络。
   • 如果您部署高可用性集群，请在 update preparation 命令中包含 --ntp-server 选项，或者在环境文件中包含 NtpServer 参数和值。
   • 使用 -e 选项包括任何自定义配置文件。
4. 等待更新准备过程完成。

流程

1. 验证您的 SSH 密钥大小：

   ssh-keygen -l -f ~/.ssh/id_rsa.pub

   输出示例：

   1024 SHA256:Xqz0Xz0/aJua6B3qRD7VsLr6n/V3zhmnGSkcFR6FlJw stack@director.example.local (RSA)

2. 如果您的 SSH 密钥小于 2048 位，请在继续操作前使用 ssh_key_rotation.yaml ansible playbook 替换 SSH 密钥。

   ANSIBLE_SSH_COMMON_ARGS="-o RequiredRSASize=1024" ansible-playbook \
   -i ~/config-download/<stack>/tripleo-ansible-inventory.yaml \
   /usr/share/ansible/tripleo-playbooks/ssh_key_rotation.yaml \
   --extra-vars "keep_old_key_authorized_keys=<true|false> \ backup_folder_path=</path/to/backup_folder>"

   • 将 <stack > 替换为 overcloud 堆栈的名称。
   • 根据您的备份需求替换 &lt ;true|false >。如果没有包含此变量，则默认值为 true。
   • 将 </path/to/backup_folder& gt; 替换为备份路径。如果没有包含此变量，则默认值为 /home/{{ ansible_user_id }}/backup_keys/{{ ansible_date_time.epoch }}

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 对具有 container_image_prepare 标签的任务运行 openstack overcloud external-update run 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 针对具有 ovn 标签的任务运行 openstack overcloud external-update run 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
4. 等待 ovn-controller 容器更新完成。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 使用 ha_image_update 标签运行 openstack overcloud external-update run 命令：

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

   • 如果 undercloud 堆栈的名称与默认堆栈名称 undercloud 不同，请将您的堆栈名称设置为 --stack 选项，并将 <stack_name> 替换为您的堆栈的名称。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行 update 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
4. 等待 Controller 节点更新完成。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行 update 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
4. 等待 Compute 节点更新完成。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行 update 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
4. 等待节点更新完成。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行 update 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
4. 等待 DistributedComputeHCI 节点更新完成。
5. 使用相同的进程更新 DistributedComputeHCIScaleOut 节点。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行 update 命令：

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

   • 如果 overcloud 堆栈的名称与默认堆栈名称 overcloud 不同，请将您的堆栈 名称设置为 --stack 选项，并将 < stack_name& gt; 替换为您的堆栈的名称。
4. 等待节点更新完成。

流程

1. 登录到 Controller 节点。

2. 检查集群的健康状况：

   $ sudo cephadm shell -- ceph health

   注意

   如果 Ceph Storage 集群处于健康状态，命令会返回 HEALTH_OK 的结果。如果命令返回不同的结果，请在继续更新前查看集群的状态并联系红帽支持。有关更多信息，请参阅 Red Hat Ceph Storage 升级指南中的使用 cephadm 升级 Red Hat Ceph Storage 集群，或 Red Hat Ceph Storage 6 升级指南中的使用 cephadm 升级 Red Hat Ceph Storage 集群。

3. 可选：检查 Ceph Storage 集群更新中应包含哪些镜像：

   $ openstack tripleo container image list -f value |  awk -F '//' '/ceph/ {print $2}'

4. 将集群更新至最新的 Red Hat Ceph Storage 版本：

   $ sudo cephadm shell -- ceph orch upgrade start --image <image_name>: <version>

   • 将 <image_name > 替换为 Ceph Storage 集群镜像的名称。
   • 将 &lt;version> 替换为您要更新 Ceph Storage 集群的目标版本。

5. 等待 Ceph Storage 容器更新完成。要监控更新的状态，请运行以下命令：

    sudo cephadm shell -- ceph orch upgrade status

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 针对使用 online_upgrade 标签的任务运行 openstack overcloud external-update run 命令：

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

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 登录到 Controller 节点并运行 Pacemaker 命令重新启用隔离：

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

   • 将 <controller_ip > 替换为 Controller 节点的 IP 地址。您可以使用 openstack server list 命令查找 Controller 节点的 IP 地址。
4. 在 fencing.yaml 环境文件中，将 EnableFencing 参数设置为 true。

流程

1. 登录您要重新引导的节点。

2. 可选：如果节点使用 Pacemaker 资源，请停止集群：

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

3. 重新引导节点：

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

4. 稍等片刻，直到节点启动。

验证

1. 验证服务是否已启用。

   1. 如果该节点使用 Pacemaker 服务，请检查该节点是否已重新加入集群：

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

   2. 如果该节点使用 Systemd 服务，请检查是否所有服务都已启用：

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

   3. 如果该节点使用容器化服务，则检查节点上的所有容器是否已激活：

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

流程

1. 登录到运行 ceph-mon 服务的 Ceph Monitor 或 Controller 节点，并临时禁用 Ceph Storage 集群重新平衡：

   $ sudo cephadm shell -- ceph osd set noout
   $ sudo cephadm shell -- ceph osd set norebalance

   注意

   如果您有多堆栈或分布式计算节点(DCN)架构，您必须在设置 noout 和 norebalance 标志时指定 Ceph 集群名称。例如： sudo cephadm shell -c /etc/ceph/<cluster>.conf -k /etc/ceph/<cluster>.client.keyring。

2. 选择第一个要重新引导的 Ceph Storage 节点并登录到该节点。

3. 重新引导节点：

   $ sudo reboot

4. 稍等片刻，直到节点启动。

5. 登录节点并检查 Ceph 集群状态：

   $ sudo cephadm -- shell ceph status

   确认 pgmap 报告的所有 pgs 的状态是否都正常 (active+clean)。

6. 注销节点，重新引导下一个节点，并检查其状态。重复此过程，直到您已重新引导所有 Ceph Storage 节点。

7. 完成后，登录到运行 ceph-mon 服务的 Ceph Monitor 或 Controller 节点，并启用 Ceph 集群重新平衡：

   $ sudo cephadm shell -- ceph osd unset noout
   $ sudo cephadm shell -- ceph osd unset norebalance

   注意

   如果您有多堆栈或分布式计算节点(DCN)架构，您必须在取消设置 noout 和 norebalance 标志时指定 Ceph 集群名称。例如： sudo cephadm shell -c /etc/ceph/<cluster>.conf -k /etc/ceph/<cluster>.client.keyring

8. 执行最后的状态检查，确认集群报告 HEALTH_OK：

   $ sudo cephadm shell ceph status

迁移实例工作流

1. 决定是否在重新引导节点前将实例迁移到另一个 Compute 节点。
2. 选择并禁用您要重新引导的 Compute 节点，使其不置备新实例。
3. 将实例迁移到另一个 Compute 节点中。
4. 重新引导空的 Compute 节点。
5. 启用空的 Compute 节点。

流程

1. 以 stack 用户的身份登录 undercloud。

2. 检索 Compute 节点列表，以识别您要重新引导的节点的主机名：

   (undercloud)$ source ~/overcloudrc
   (overcloud)$ openstack compute service list

   识别您要重新引导的 Compute 节点的主机名。

3. 在您要重新引导的 Compute 节点上禁用 Compute 服务：

   (overcloud)$ openstack compute service list
   (overcloud)$ openstack compute service set <hostname> nova-compute --disable

   • 将 <hostname > 替换为 Compute 节点的主机名。

4. 列出 Compute 节点上的所有实例：

   (overcloud)$ openstack server list --host <hostname> --all-projects

5. 可选： 要将实例迁移到另一个 Compute 节点，请完成以下步骤：

   1. 如果您决定将实例迁移至另一个 Compute 节点，则使用以下命令之一：

      • 要将实例迁移到其他主机，请运行以下命令：

        (overcloud) $ openstack server migrate <instance_id> --live <target_host> --wait

        • 将 <instance_id& gt; 替换为您的实例 ID。
        • 将 <target_host > 替换为您要将实例迁移到的主机。

      • 让 nova-scheduler 自动选择目标主机：

        (overcloud) $ nova live-migration <instance_id>

      • 一次性实时迁移所有实例：

        $ nova host-evacuate-live <hostname>

        注意

        nova 命令可能会引发一些弃用警告，这些警告信息可以被安全忽略。

   2. 稍等片刻，直至迁移完成。

   3. 确认迁移成功完成：

      (overcloud) $ openstack server list --host <hostname> --all-projects

   4. 继续迁移实例，直到 Compute 节点上没有保留任何实例。

6. 登录到 Compute 节点并重启节点：

   [tripleo-admin@overcloud-compute-0 ~]$ sudo reboot

7. 稍等片刻，直到节点启动。

8. 重新启用 Compute 节点：

   $ source ~/overcloudrc
   (overcloud) $ openstack compute service set <hostname>  nova-compute --enable

9. 确认是否已启用 Compute 节点：

   (overcloud) $ openstack compute service list

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 运行验证：

   $ validation run -i ~/overcloud-deploy/<stack>/tripleo-ansible-inventory.yaml --group post-update

   • 将 <stack> 替换为堆栈的名称。

验证

1. 要查看验证报告的结果，请参阅使用 director 安装和管理 Red Hat OpenStack Platform 中的 查看验证历史记录。