升级框架 (13 到 16.1)

1. 在将 Red Hat OpenStack Platform 部署从版本 13 升级到 16.1 之前，您必须将 Red Hat Ceph Storage 集群从版本 3 升级到 4。有关更多信息，请参阅 Red Hat Ceph Storage 4 安装指南中的升级 Red Hat Ceph Storage 集群。
2. 在将 Red Hat Ceph Storage 集群从版本 3 升级到 4 后，Red Hat OpenStack Platform 13 可能仍然运行 RHCSv3 客户端组件，但它们与 RHCSv4 集群兼容。
3. 您可以按照 Framework for Upgrades (13 to 16.1)文档中的升级路径，并在适用的情况下完成支持此特定场景的条件步骤。条件步骤以以下语句开头："如果您正在使用外部 Ceph 部署升级"。
4. 使用外部 Ceph 部署升级时，作为 overcloud 升级过程的一部分安装 RHCSv4 ceph-ansible。当您升级使用 director 部署的 Ceph 集群时，您可以在 overcloud 升级过程完成后安装 RHCSv4 ceph-ansible。

流程

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 创建名为 pre-upgrade-validations.sh 的 bash 脚本，并在脚本中包含以下内容：

   #!/bin/bash
   for VALIDATION in $(openstack action execution run tripleo.validations.list_validations '{"groups": ["pre-upgrade"]}' | jq ".result[] | .id")
   do
     echo "=== Running validation: $VALIDATION ==="
     STACK_NAME=$(openstack stack list -f value -c 'Stack Name')
     ID=$(openstack workflow execution create -f value -c ID tripleo.validations.v1.run_validation "{\"validation_name\": $VALIDATION, \"plan\": \"$STACK_NAME\"}")
     while [ $(openstack workflow execution show $ID -f value -c State) == "RUNNING" ]
     do
       sleep 1
     done
     echo ""
     openstack workflow execution output show $ID | jq -r ".stdout"
     echo ""
   done

4. 添加运行脚本的权限：

   $ chmod +x pre-upgrade-validations.sh

5. 运行脚本：

   $ ./pre-upgrade-validations.sh

   查看脚本输出，以确定哪些验证成功并失败：

   === Running validation: "check-ftype" ===
   
   Success! The validation passed for all hosts:
   * undercloud

流程

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

2. 创建名为 playbook-nics.yaml 的 Ansible playbook，并将以下内容复制到 playbook 中：

   ---
   - name: Rename eth devices
     hosts: all
     become: yes
     vars:
       prefix: "em"
       undercloud_conf: "/home/stack/undercloud.conf"
       osnet_conf: "/etc/os-net-config/config.json"
     tasks:
       - set_fact:
           eth_interfaces: "{{ ansible_interfaces | select('match','eth.*') | list }}"
       - debug:
           msg: "{{ eth_interfaces }}"
       - name: Update udev rules
         lineinfile:
           line: "SUBSYSTEM==\"net\", ACTION==\"add\", DRIVERS==\"?*\", ATTR{address}==\"{{ ansible_facts[item]['perm_macaddress'] | default(ansible_facts[item]['macaddress']) }}\", NAME=\"{{ item|replace('eth',prefix) }}\""
           path: /etc/udev/rules.d/70-rhosp-persistent-net.rules
           create: True
         with_items: "{{ eth_interfaces }}"
       - name: Rename eth files
         block:
           - name: Check that eth files exists
             stat:
               path: /etc/sysconfig/network-scripts/ifcfg-{{ item }}
             register: nic_result
             with_items: "{{ eth_interfaces }}"
           - name: Copy nic files using the new prefix
             copy:
               remote_src: True
               src: "{{ item.stat.path }}"
               dest: "{{ item.stat.path|replace('eth',prefix) }}"
             with_items: "{{ nic_result.results }}"
             when: item.stat.exists
           - name: Edit NAME in new network-script files
             lineinfile:
               regexp: "^NAME=.*"
               line: "NAME={{ item.item|replace('eth',prefix) }}"
               path: "{{ item.stat.path|replace('eth',prefix) }}"
             with_items: "{{ nic_result.results }}"
             when: item.stat.exists
           - name: Edit DEVICE in new network-script files
             lineinfile:
               regexp: "^DEVICE=.*"
               line: "DEVICE={{ item.item|replace('eth',prefix) }}"
               path: "{{ item.stat.path|replace('eth',prefix) }}"
             with_items: "{{ nic_result.results }}"
             when: item.stat.exists
           - name: Backup old eth network-script files
             copy:
               remote_src: True
               src: "{{ item.stat.path }}"
               dest: "{{ item.stat.path }}.bak"
             with_items: "{{ nic_result.results }}"
             when: item.stat.exists
           - name: Remove old eth network-script files
             file:
               path: "{{ item.stat.path }}"
               state: absent
             with_items: "{{ nic_result.results }}"
             when: item.stat.exists
       - name: Rename route files
         block:
           - name: Check that route files exists
             stat:
               path: /etc/sysconfig/network-scripts/route-{{ item }}
             register: route_result
             with_items: "{{ eth_interfaces }}"
           - name: Copy route files using the new prefix
             copy:
               remote_src: True
               src: "{{ item.stat.path }}"
               dest: "{{ item.stat.path|replace('eth',prefix) }}"
             with_items: "{{ route_result.results }}"
             when: item.stat.exists
           - name: Update prefix in route files that use IP command arguments format
             replace:
               regexp: "eth"
               replace: "{{ prefix }}"
               path: "{{ item.stat.path|replace('eth',prefix) }}"
             with_items: "{{ route_result.results }}"
             when: item.stat.exists
           - name: Backup old route files
             copy:
               remote_src: True
               src: "{{ item.stat.path }}"
               dest: "{{ item.stat.path }}.bak"
             with_items: "{{ route_result.results }}"
             when: item.stat.exists
           - name: Remove old route files
             file:
               path: "{{ item.stat.path }}"
               state: absent
             with_items: "{{ route_result.results }}"
             when: item.stat.exists
       - name: Perform a final regex for any remaining eth prefixes in ifcfg files
         block:
           - name: Get a list of all ifcfg files
             find:
               paths: /etc/sysconfig/network-scripts/
               patterns: 'ifcfg-*'
               excludes: '*.bak'
             register: ifcfg_files
           - name: Perform final regex on ifcfg files
             replace:
               path: "{{ item[0].path }}"
               regexp: "{{ item[1] }}"
               replace: "{{ item[1]|replace('eth',prefix) }}"
             with_nested:
               - "{{ ifcfg_files.files }}"
               - "{{ eth_interfaces }}"
       - name: Replace interface name in files referencing old eth interface
         block:
           - name: Check if undercloud.conf exists
             stat:
               path: "{{ undercloud_conf }}"
             register: undercloud_conf_stat
           - name: Replace interface name in undercloud.conf
             replace:
               path: "{{ undercloud_conf }}"
               regexp: 'eth(\d+)'
               replace: "{{ prefix }}\\1"
             when: undercloud_conf_stat.stat.exists
           - name: Check if os-net-config's config.json exists
             stat:
               path: "{{ osnet_conf }}"
             register: osnet_conf_stat
           - name: Replace interface name in config.json
             replace:
               path: "{{ osnet_conf }}"
               regexp: 'eth(\d+)'
               replace: "{{ prefix }}\\1"
             when: osnet_conf_stat.stat.exists
       - name: Patch vlan devices
         block:
           - name: Check that vlan files exists
             stat:
               path: /etc/sysconfig/network-scripts/ifcfg-{{ item }}
             register: nic_result
             when: item.startswith("vlan")
             with_items: "{{ ansible_interfaces }}"
           - name: Backup old vlan network-script files
             copy:
               remote_src: True
               src: "{{ item.stat.path }}"
               dest: "{{ item.stat.path }}.bak"
             when: item.item.startswith("vlan") and item.stat.exists
             with_items: "{{ nic_result.results }}"
           - name: Edit PHYSDEV in new network-script files
             replace:
               path: "{{ item.stat.path }}"
               regexp: "^PHYSDEV=eth"
               replace: "PHYSDEV={{ prefix }}"
             when: item.item.startswith("vlan") and item.stat.exists
             with_items: "{{ nic_result.results }}"

   注意

   您将在升级过程中使用此 playbook 在稍后阶段重命名 overcloud NIC。

3. 在 undercloud 上运行 playbook-nics.yaml playbook：

   $ ansible-playbook -c local -i localhost, playbook-nics.yaml

   playbook 将新的 NIC 前缀设置为 em。要设置不同的 NIC 前缀，请在运行 playbook 时设置 前缀 变量：

   $ ansible-playbook -c local -i localhost, -e prefix="mynic" ~/playbook-nics.yaml

   NIC 更改仅在 Leapp 升级过程完成且重新引导节点后应用。

流程

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

2. 检查 PermitRootLogin 参数的 /etc/ssh/sshd_config 文件：

   $ sudo grep PermitRootLogin /etc/ssh/sshd_config

3. 如果参数不在 /etc/ssh/sshd_config 文件中，编辑该文件并设置 PermitRootLogin 参数：

   PermitRootLogin no

4. 保存该文件。

流程

1. 检查当前启用的硬件类型列表：

   $ source ~/stackrc
   $ openstack baremetal driver list --type dynamic

2. 如果您使用未启用的硬件类型驱动程序，请使用 undercloud.conf 文件中的 enabled_hardware_types 参数启用驱动程序：

   enabled_hardware_types = ipmi,redfish,idrac

3. 保存文件并刷新 undercloud：

   $ openstack undercloud install

4. 运行以下命令，为您的电源管理类型替换 OLDDRIVER 和 NEWDRIVER 变量：

   $ source ~/stackrc
   $ OLDDRIVER="pxe_ipmitool"
   $ NEWDRIVER="ipmi"
   $ for NODE in $(openstack baremetal node list --driver $OLDDRIVER -c UUID -f value) ; do openstack baremetal node set $NODE --driver $NEWDRIVER; done

流程

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

2. 禁用 undercloud 上的主要 OpenStack 服务：

   $ sudo systemctl stop 'openstack-*' httpd haproxy mariadb 'rabbitmq*' docker xinetd

3. 从 undercloud 中删除主要的 OpenStack 服务，但 OpenvSwitch 和升级所需的某些 Python 2 软件包除外：

   $ sudo yum -y remove '*el7ost*' 'galera*' 'haproxy*' \
       httpd 'mysql*' 'pacemaker*' xinetd python-jsonpointer \
       qemu-kvm-common-rhev qemu-img-rhev 'rabbit*' \
       'redis*' \
       -- \
       -'*openvswitch*' -python-docker -python-PyMySQL \
       -python-pysocks -python2-asn1crypto -python2-babel \
       -python2-cffi -python2-cryptography -python2-dateutil \
       -python2-idna -python2-ipaddress -python2-jinja2 \
       -python2-jsonpatch -python2-markupsafe -python2-pyOpenSSL \
       -python2-requests -python2-six -python2-urllib3 \
       -python-httplib2 -python-passlib -python2-netaddr -ceph-ansible

4. 从 /etc/httpd 和 / var/lib/docker 目录中删除 内容：

   $ sudo rm -rf /etc/httpd /var/lib/docker

流程

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

2. 安装 Leapp 工具和 jq：

   $ sudo yum install leapp
   $ sudo yum install jq

3. 下载额外所需的数据文件(RPM 软件包更改和 RPM 存储库映射)附加到 知识库文章 Data required by the Leapp utility for an in-place upgrade from RHEL 7 to RHEL 8，并将这些文件放在 /etc/leapp/files/ 目录中。

4. 更新您的红帽订阅：

   • 如果您的 undercloud 使用红帽客户门户网站进行注册，请刷新当前订阅以获取对 Red Hat Enterprise Linux 8.2 内容的访问权限：

     $ sudo subscription-manager refresh

   • 如果您的 undercloud 使用 Red Hat Satellite 服务器进行注册，请将 undercloud 重新注册到与您的 Red Hat OpenStack Platform (RHOSP) 16.1 激活码关联的内容视图。

     $ sudo subscription-manager register --force --org ORG --activationkey ACTIVATION_KEY

     注意

     为 Red Hat OpenStack Platform 16.1 创建的内容视图必须包含 Red Hat Enterprise Linux 8.2 的内容。

5. Red Hat OpenStack Platform 16.1 使用 Open vSwitch 的较新版本。通过 to_remove 和 to_install 事务文件替换 Open vSwitch 版本：

   $ echo 'openvswitch2.11' | sudo tee -a /etc/leapp/transaction/to_remove
   $ echo 'openvswitch2.13' | sudo tee -a /etc/leapp/transaction/to_install

6. 使用 to_keep 事务文件升级保留 ceph-ansible 的 Red Hat Ceph Storage 3 版本：

   $ echo 'ceph-ansible' | sudo tee -a /etc/leapp/transaction/to_keep

7. 调整 RHEL 8 中不再支持的内核模块：

   $ if [ -f /usr/share/leapp-repository/repositories/system_upgrade/el7toel8/actors/kernel/checkkerneldrivers/files/removed_drivers.txt ]; then
       for module in pata_acpi floppy; do
           sudo sed -i "/^${module}$/d" /usr/share/leapp-repository/repositories/system_upgrade/el7toel8/actors/kernel/checkkerneldrivers/files/removed_drivers.txt
       done
   else
       for module in pata_acpi floppy; do
           jq ". | del(.data[] | select(.driver_name == \"${module}\"))" /etc/leapp/files/device_driver_deprecation_data.json | sudo tee /etc/leapp/files/device_driver_deprecation_data.json_modified
           mv /etc/leapp/files/device_driver_deprecation_data.json_modified /etc/leapp/files/device_driver_deprecation_data.json
       done
   fi

8. 运行 leapp answer 命令并指定 Leapp 回答来删除 pam_pkcs11 模块：

   $ sudo leapp answer --add --section remove_pam_pkcs11_module_check.confirm=True

9. 可选：如果您的环境使用 TLS-Everywhere 架构部署，并使用已弃用的 authconfig 工具在您的系统中配置身份验证，请使用 authselect 工具配置 RHEL 8 系统：

   $ sudo leapp answer --add --section authselect_check.confirm=True

   有关 Leapp 升级过程中身份验证配置的更多信息，请参阅 从 RHEL 7 升级到 RHEL 8 中的已知问题。

10. 设置 LEAPP_DEVEL_TARGET_RELEASE 和 LEAPP_UNSUPPORTED 环境变量，以指定您要升级到的 RHEL 8 次版本。对于 RHOSP 16.1，您必须将 RHEL 8 次版本设置为 8.2 ：

    $ export LEAPP_UNSUPPORTED=1
    $ export LEAPP_DEVEL_TARGET_RELEASE=8.2

    每次使用带有 LEAPP_DEVEL 前缀的环境变量时，都必须使用 LEAPP_UNSUPPORTED 环境变量。

11. 从 Leapp 进程中删除持久性网络名称 actor ：

    注意

    如果您在执行 Leapp 升级过程前没有重命名网络接口名称，则接口名称可能会在升级到 RHEL 8.2 后有所变化。有关重命名网络接口名称的详情请参考 第 4.3 节 “为 undercloud 节点使用可预测的 NIC 名称”。

    $ sudo rm -f /usr/share/leapp-repository/repositories/system_upgrade/el7toel8/actors/persistentnetnamesdisable/actor.py

12. 启动 Leapp 升级过程：

    $ sudo -E leapp upgrade --debug --enablerepo rhel-8-for-x86_64-baseos-tus-rpms --enablerepo rhel-8-for-x86_64-appstream-tus-rpms --enablerepo fast-datapath-for-rhel-8-x86_64-rpms --enablerepo ansible-2.9-for-rhel-8-x86_64-rpms

    使用 --enablerepo 选项设置您要在 Leapp 升级过程中启用的软件仓库。您必须包含这些软件仓库才能促进 Red Hat OpenStack Platform 16.1 转换，特别是 Open vSwitch 的较新版本。

13. 等待 leapp upgrade 命令成功完成。

14. 在您的根目录中创建空的 .autorelabel 文件：

    $ sudo touch /.autorelabel

    重启后，SELinux 会检测此文件并自动重新标记文件系统。

15. 重新引导 undercloud：

    $ sudo reboot

16. 从 DNF 配置中定义的事务排除中删除 Leapp 软件包：

    $ sudo dnf config-manager --save --setopt exclude=''

流程

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

2. 使用 subscription-manager release 命令将 undercloud 锁定为特定版本：

   $ sudo subscription-manager release --set=8.2

步骤

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

2. 禁用所有默认的软件仓库，然后启用所需的 Red Hat Enterprise Linux 软件仓库：

   [stack@director ~]$ sudo subscription-manager repos --disable=*
   [stack@director ~]$ sudo subscription-manager repos --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 --enable=ansible-2.9-for-rhel-8-x86_64-rpms --enable=openstack-16.1-for-rhel-8-x86_64-rpms --enable=fast-datapath-for-rhel-8-x86_64-rpms --enable=advanced-virt-for-rhel-8-x86_64-eus-rpms

   这些仓库包括了安装 director 所需的软件包。

3. 将 container-tools 存储库模块设置为版本 2.0:

   [stack@director ~]$ sudo dnf module reset container-tools
   [stack@director ~]$ sudo dnf module enable -y container-tools:2.0

4. 同步操作系统以确保您的系统软件包与操作系统版本匹配：

   [stack@director ~]$ sudo dnf distro-sync -y
   [stack@director ~]$ sudo reboot

步骤

1. 安装用于安装和配置 director 的命令行工具：

   [stack@director ~]$ sudo dnf install -y python3-tripleoclient

步骤

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

2. 生成默认的容器镜像准备文件：

   $ sudo openstack tripleo container image prepare default \
     --local-push-destination \
     --output-env-file containers-prepare-parameter.yaml

   此命令包括以下附加选项：

   • --local-push-destination，在 undercloud 上设置 registry 作为存储容器镜像的位置。这意味着 director 从 Red Hat Container Catalog 拉取必要的镜像并将其推送到 undercloud 上的 registry 中。director 将该 registry 用作容器镜像源。如果直接从 Red Hat Container Catalog 拉取镜像，请忽略这个选项。

   • --output-env-file 是环境文件名称。此文件的内容包括用于准备您的容器镜像的参数。在本例中，文件的名称是 containers-prepare-parameter.yaml。

     注意

     您可以使用相同的 containers-prepare-parameter.yaml 文件为 undercloud 和 overcloud 定义容器镜像源。

3. 修改 containers-prepare-parameter.yaml 以符合您的需求。

流程

1. 以 stack 用户身份登录 undercloud 主机。
2. 编辑 containers-prepare-parameter.yaml 文件。

3. 在 ContainerImagePrepare 参数的 set 中添加 transitional 容器参数。根据您的部署类型，以以下方法之一设置参数。

   • 如果您的部署使用了使用 director 部署的 Red Hat Ceph Storage 集群，请添加以下参数：

     parameter_defaults:
       ContainerImagePrepare:
       - push_destination: true
         set:
           ...
           name_prefix_stein: openstack-
           name_suffix_stein: ''
           namespace_stein: registry.redhat.io/rhosp15-rhel8
           tag_stein: 15.0
           ceph3_namespace: registry.redhat.io/rhceph
           ceph3_tag: latest
           ceph3_image: rhceph-3-rhel7
           ...

     • *_stein 参数定义 Red Hat OpenStack Platform 15 的容器镜像，升级过程用于数据库迁移。
     • ceph3 authenticate 参数定义 overcloud 使用的当前 Red Hat Ceph Storage 容器镜像。对于从 Red Hat Ceph Storage 3 转换到 4，overcloud 需要 ceph 3uildDefaults 和 cephuildDefaults 参数。
     • 如果您使用 Red Hat Satellite Server 进行容器镜像存储，请将命名空间设置为 Red Hat Satellite Server 上的镜像位置。

   • 如果您的部署使用外部 Ceph Storage 集群，请添加以下参数：

     parameter_defaults:
       ContainerImagePrepare:
       - push_destination: true
         set:
           ...
           name_prefix_stein: openstack-
           name_suffix_stein: ''
           namespace_stein: registry.redhat.io/rhosp15-rhel8
           tag_stein: 15.0
           ceph_namespace: registry.redhat.io/rhceph
           ceph_tag: latest
           ceph_image: rhceph-4-rhel8
           ...

     • *_stein 参数定义 Red Hat OpenStack Platform 15 的容器镜像，升级过程用于数据库迁移。
     • cephui ldDefaults 参数定义 overcloud 使用的当前 Red Hat Ceph Storage 4 容器镜像。
     • 如果您使用 Red Hat Satellite Server 进行容器镜像存储，请将命名空间设置为 Red Hat Satellite Server 上的镜像位置。

4. 将 neutron_driver 参数更改为 openvswitch ：

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       set:
         ...
         neutron_driver: openvswitch
         ...

   升级在整个流程中保留 Open vSwitch 兼容性。完成升级到 Red Hat OpenStack Platform 16.1 后，您要将 overcloud 从 Open vSwitch 迁移到 Open Virtual Network (OVN)。

5. 保存 containers-prepare-parameter.yaml 文件。

流程

1. 以 stack 用户身份登录 undercloud 主机。
2. 编辑 undercloud.conf 文件。

3. 在文件中的 DEFAULT 部分添加以下参数：

   container_images_file = /home/stack/containers-prepare-parameter.yaml

   此参数定义 containers-prepare-parameter.yaml 环境文件的位置，以便 director 从正确的位置拉取 undercloud 的容器镜像。

4. 检查 generate_service_certificate 参数。此参数的默认值从 false 改为 true，它在升级过程中在 undercloud 上启用 SSL/TLS。
5. 如果您迁移到可预测的 NIC 命名规则，请检查 local_interface 参数。
6. 如果您在 Red Hat OpenStack Platform 13 中设置 masquerade_network 参数，请删除此参数，并为每个子网设置 masquerade = true。
7. 检查 文件中的所有其他参数是否有任何更改。
8. 保存该文件。

流程

1. 运行以下命令升级 undercloud 上的 director：

   $ openstack undercloud upgrade

   此命令会启动 director 配置脚本。director 升级其软件包并配置其服务，以符合 undercloud.conf 中的设置。这个脚本会需要一些时间来完成。

   注意

   在继续操作前，director 配置脚本会提示确认。使用 -y 选项绕过此确认：

   $ openstack undercloud upgrade -y

2. 该脚本还会自动启动 undercloud 上所有的 OpenStack Platform 服务容器。您可以通过 systemd 资源管理每个服务。检查 systemd 资源：

   $ sudo systemctl list-units "tripleo_*"

   每个 systemd 服务控制一个容器。使用以下命令来检查已启用的容器：

   $ sudo podman ps

3. 该脚本将 stack 用户添加到 docker 组，以确保 stack 用户能够访问容器管理命令。使用以下命令刷新 stack 用户权限：

   $ exec su -l stack

   命令会提示您再次登录。输入 stack 用户密码。

4. 运行以下命令初始化 stack 用户来使用命令行工具：

   $ source ~/stackrc

   提示信息现在指示，OpenStack 命令在对 undercloud 验证身份并执行命令；

   (undercloud) $

流程

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

2. source stackrc 文件：

   $ source ~/stackrc

3. 为所有节点创建一个静态清单文件：

   $ tripleo-ansible-inventory --static-yaml-inventory ~/inventory.yaml --stack STACK_NAME

   如果您不使用默认的 overcloud 堆栈名称，请使用 --stack STACK NAME选项设置堆栈名称，将 STACK NAME 替换为堆栈的名称。

4. 要在您的环境中执行 Ansible playbook，请运行 ansible-playbook 命令，并使用 -i 选项包含动态清单工具的完整路径。例如：

   (undercloud) $ ansible-playbook -i ~/inventory.yaml PLAYBOOK

流程

1. source stackrc 文件：

   $ source ~/stackrc

2. 使用 --group pre-upgrade 选项运行 openstack tripleo validator run 命令，并包含 /usr/libexec/platform-python python 运行时环境：

   $ openstack tripleo validator run --group pre-upgrade --python-interpreter /usr/libexec/platform-python -i inventory.yaml

3. 查看验证报告的结果。要查看特定验证的详细输出，请根据报告中具体验证的 UUID 运行 openstack tripleo validator show run --full 命令：

   $ openstack tripleo validator show run  --full <UUID>

流程

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

2. source stackrc 文件：

   $ source ~/stackrc

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

   $ ssh heat-admin@CONTROLLER_IP "sudo pcs property set stonith-enabled=false"

4. 在 fencing.yaml 环境文件中，将 EnableFencing 参数设置为 false，以确保隔离在升级过程中保持禁用。

流程

1. 选择一个环境文件，检查它是否有 ExtraConfig 参数：

   $ grep ExtraConfig ~/templates/custom-config.yaml

2. 如果结果在所选文件中显示 ExtraConfig 参数（如 ControllerExtraConfig），请检查该文件中的完整参数结构。

3. 如果参数包含 SECTION/parameter 语法 和值 的任何 puppet Hierdata，则它可能已被替换为实际 Puppet 类的参数。例如：

   parameter_defaults:
     ExtraConfig:
       neutron::config::dhcp_agent_config:
         'DEFAULT/dnsmasq_local_resolv':
           value: 'true'

4. 检查 director 的 Puppet 模块，以查看参数现在存在于 Puppet 类中。例如：

   $ grep dnsmasq_local_resolv

   如果是，请更改为新接口。

5. 以下是演示语法更改的示例：

   • 示例 1：

     parameter_defaults:
       ExtraConfig:
         neutron::config::dhcp_agent_config:
           'DEFAULT/dnsmasq_local_resolv':
             value: 'true'

     更改：

     parameter_defaults:
       ExtraConfig:
         neutron::agents::dhcp::dnsmasq_local_resolv: true

   • 示例 2：

     parameter_defaults:
       ExtraConfig:
         ceilometer::config::ceilometer_config:
           'oslo_messaging_rabbit/rabbit_qos_prefetch_count':
             value: '32'

     更改：

     parameter_defaults:
       ExtraConfig:
         oslo::messaging::rabbit::rabbit_qos_prefetch_count: '32'

流程

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

2. 在 templates 目录中 创建一个名为 upgrade-environment.yaml 的环境文件：

   $ touch templates/upgrades-environment.yaml

3. 编辑该文件并添加以下强制内容：

   parameter_defaults:
     UpgradeLeappDevelSkip: "LEAPP_UNSUPPORTED=1 LEAPP_DEVEL_TARGET_RELEASE=8.2"
     LeappInitCommand: |
       for module in pata_acpi floppy; do sudo sed -i "/^${module}$/d" /usr/share/leapp-repository/repositories/system_upgrade/el7toel8/actors/kernel/checkkerneldrivers/files/removed_drivers.txt; done
       sudo rm -f /usr/share/leapp-repository/repositories/system_upgrade/el7toel8/actors/persistentnetnamesdisable/actor.py
       sudo yum -y remove mariadb-server* || true
     UpgradeInitCommand: "sudo dnf config-manager --save --setopt exclude=''"

   • UpgradeLeappDevelSkip 会跳过 Leapp 检查，并在 Leapp 运行时设置环境变量。
   • LeappInitCommand 会传递在每个 overcloud 节点上运行的命令或脚本片断，并为 Leapp 升级准备节点。
   • UpgradeInitCommand 传递在每个 overcloud 节点上运行的命令或脚本片断。dnf config-manager --save --setopt exclude='' 命令从 DNF exclude 中删除 Leapp 软件包，以便成功删除 python2 软件包。

4. 可选： 如果您在环境中使用 TLS-Everywhere 并希望从 authconfig 迁移到 authselect，请将 authselect_check.confirm 参数设置为 True 以避免 bug BZ#1978228 - OSP13→16.2 Leapp upgrade failed with TLSEverywhere:

   parameter_defaults:
     LeappInitCommand: |
       sudo leapp answer --section authselect_check.confirm=True --add

   否则，将值设为 False。

   注意

   使用 | 语法将多个命令传递给 LeappInitCommand 参数：

   parameter-defaults:
     LeappInitCommand: |
       <command_1>
       <command_2>

5. 保存 upgrade -environment.yaml 文件。

流程

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

2. source stackrc 文件：

   $ source ~/stackrc

3. 为环境中所有节点创建一个静态清单文件：

   $ tripleo-ansible-inventory --static-yaml-inventory ~/inventory.yaml --stack STACK_NAME

   如果您不使用默认的 overcloud 堆栈名称，请使用 --stack STACK NAME选项设置堆栈名称，将 STACK NAME 替换为堆栈的名称。

4. 要将 leapp 数据复制到 overcloud 节点 ， 请运行以下命令：

   $ ansible -i ~/inventory.yaml --become -m synchronize -a "src=/etc/leapp/files dest=/etc/leapp/" overcloud

流程

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

2. 在所有 overcloud 节点上运行 playbook-nics.yaml playbook：

   $ ansible-playbook -i ~/inventory.yaml playbook-nics.yaml

   playbook 将新的 NIC 前缀设置为 em。要设置不同的 NIC 前缀，请在运行 playbook 时设置 前缀 变量：

   $ ansible-playbook -i ~/inventory.yaml -e prefix="mynic" playbook-nics.yaml

   NIC 更改仅在 Leapp 升级过程完成且重新引导节点后应用。

流程

1. 搜索使用可组合服务的自定义环境文件。您通常将自定义环境文件存储在 /home/stack/templates 目录中：

   $ cd ~/templates/
   $ grep "OS::TripleO::Services" *

   在这种情况下，其中一个文件显示过时的映射：

     OS::TripleO::Services::CephMgr: /usr/share/openstack-tripleo-heat-templates/docker/services/ceph-ansible/ceph-mgr.yaml

2. 识别 /usr/share/openstack-tripleo-heat-templates/ 中的新的 ceph-mgr.yaml 位置。此文件现在位于 'deployment/ceph-ansible' 目录中：

   $ find /usr/share/openstack-tripleo-heat-templates/ -name ceph-mgr.yaml
   /usr/share/openstack-tripleo-heat-templates/deployment/ceph-ansible/ceph-mgr.yaml

3. 在自定义环境文件中编辑服务：

   resource_registry:
     OS::TripleO::Services::CephMgr: /usr/share/openstack-tripleo-heat-templates/deployment/ceph-ansible/ceph-mgr.yaml

   保存该文件。

流程

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

2. 获取 undercloud 上的 control plane 主机名：

   $ sudo hiera container_image_prepare_node_names
   ["undercloud.ctlplane.localdomain"]

3. 编辑 containers-prepare-parameter.yaml 文件，并添加 DockerInsecureRegistryAddress 参数，其中包含 undercloud 的 control plane 主机名和 provisioning 网络上的 undercloud 的 IP 地址：

   parameter_defaults:
     DockerInsecureRegistryAddress:
     - undercloud.ctlplane.localdomain:8787
     - 192.168.24.1:8787
     ...

   您还必须将 overcloud registry 的端口号附加到主机名和 IP 地址值。端口号为 8787。

流程

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

2. 设置 Compute 命名格式：

   • 如果使用自定义 roles_data 文件，请编辑自定义 roles_data 文件并为 Compute 角色设置 HostnameFormatDefault 参数：

     - name: Compute
       …​
       HostnameFormatDefault: '%stackname%-compute-%index%'
       …​

     保存自定义 roles_data 文件。

   • 如果您在 openstack-tripleo-heat-templates 中使用默认的 roles_data 文件，请在环境文件中设置命名格式。使用节点数目和类型编辑环境文件，它们通常命名为 node-info.yaml。将 ComputeHostnameFormat 参数添加到 parameter_defaults 部分：

     parameter_defaults:
       …​
       ComputeHostnameFormat: '%stackname%-compute-%index%'
       …​

     保存 node-info.yaml 文件。

流程

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

2. Source stackrc 文件：

   [stack@director ~]$ source ~/stackrc

3. 打开环境文件。

4. 在您的环境文件中添加以下配置，以指定实例序列号基于主机的序列号：

   parameter_defaults:
     <Role>ExtraConfig:
       nova::config::nova_config:
         libvirt/sysinfo_serial:
           value: auto

5. 保存对环境文件的更新，并将该文件添加到 overcloud 升级和部署命令中。

流程

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 编辑自定义 overcloud 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
     …​

   overcloud 部署使用 HAProxy 中的新服务来确定是否启用了 SSL/TLS。

   注意

   如果这是 enable-tls.yaml 文件的 resource_registry 部分中的唯一资源，请删除完整的 resource_registry 部分。

5. 保存 SSL/TLS 公共端点文件。

流程

1. 编辑后配置模板。

2. 在 parameters 部分下，添加 EndpointMap 参数及其子参数：

   parameters:
     servers:
       type: json
     nameserver_ip:
       type: string
     DeployIdentifier:
       type: string
     EndpointMap:
       default: {}
       type: json

3. 保存模板。

流程

1. 从将来的部署操作中排除 rhel-registration 环境文件。在大多数情况下，排除以下文件：

   • rhel-registration/environment-rhel-registration.yaml
   • rhel-registration/rhel-registration-resource-registry.yaml

2. 如果您使用自定义 roles_data 文件，请确保 roles_data 文件中的每个角色都包含 OS::TripleO::Services::Rhsm 可组合服务。例如：

   - name: Controller
     description: |
       Controller role that has all the controller services loaded and handles
       Database, Messaging and Network functions.
     CountDefault: 1
     ...
     ServicesDefault:
       ...
       - OS::TripleO::Services::Rhsm
       ...

3. 为 rhsm 可组合服务参数添加环境文件，以备将来部署操作。

流程

1. 创建名为 templates/rhsm.yml 的环境文件，以存储配置。

2. 在环境文件中包含您的配置。例如：

   resource_registry:
     OS::TripleO::Services::Rhsm: /usr/share/openstack-tripleo-heat-templates/deployment/rhsm/rhsm-baremetal-ansible.yaml
   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
         …​
       rhsm_username: "myusername"
       rhsm_password: "p@55w0rd!"
       rhsm_org_id: "1234567"
       rhsm_pool_ids: "1a85f9223e3d5e43013e3d6e8ff506fd"
       rhsm_method: "portal"
       rhsm_release: 8.2

   • resource_registry 部分将 rhsm 可组合服务与 OS::TripleO::Services::Rhsm 资源相关联，该资源可在每个角色上可用。
   • RhsmVars 变量向 Ansible 传递参数来配置红帽注册。
3. 保存环境文件。

流程

1. 创建名为 templates/rhsm.yml 的环境文件，以存储配置。

2. 在环境文件中包含您的配置。例如：

   resource_registry:
     OS::TripleO::Services::Rhsm: /usr/share/openstack-tripleo-heat-templates/deployment/rhsm/rhsm-baremetal-ansible.yaml
   parameter_defaults:
     ControllerParameters:
       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
           - advanced-virt-for-rhel-8-x86_64-eus-rpms
           - openstack-16.1-for-rhel-8-x86_64-rpms
           - fast-datapath-for-rhel-8-x86_64-rpms
         rhsm_username: "myusername"
         rhsm_password: "p@55w0rd!"
         rhsm_org_id: "1234567"
         rhsm_pool_ids: "55d251f1490556f3e75aa37e89e10ce5"
         rhsm_method: "portal"
         rhsm_release: 8.2
     ComputeParameters:
       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
           - advanced-virt-for-rhel-8-x86_64-eus-rpms
           - openstack-16.1-for-rhel-8-x86_64-rpms
           - fast-datapath-for-rhel-8-x86_64-rpms
         rhsm_username: "myusername"
         rhsm_password: "p@55w0rd!"
         rhsm_org_id: "1234567"
         rhsm_pool_ids: "55d251f1490556f3e75aa37e89e10ce5"
         rhsm_method: "portal"
         rhsm_release: 8.2
     CephStorageParameters:
       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.1-deployment-tools-for-rhel-8-x86_64-rpms
         rhsm_username: "myusername"
         rhsm_password: "p@55w0rd!"
         rhsm_org_id: "1234567"
         rhsm_pool_ids: "68790a7aa2dc9dc50a9bc39fabc55e0d"
         rhsm_method: "portal"
         rhsm_release: 8.2

   resource_registry 将 rhsm 可组合服务与 OS::TripleO::Services::Rhsm 资源相关联，该资源可在每个角色上可用。

   ControllerParameters、ComputeParameters 和 CephStorageParameters 参数各自使用单独的 RhsmVars 参数，将订阅详情传递给对应的角色。

   注意

   在 CephStorageParameters 参数中设置 RhsmVars 参数，以使用特定于 Ceph Storage 的 Red Hat Ceph Storage 订阅和存储库。确保 rhsm_repos 参数包含标准 Red Hat Enterprise Linux 软件仓库，而不是 Controller 和 Compute 节点所需的延长更新支持(EUS)存储库。

3. 保存环境文件。

流程

1. 从将来的部署操作中排除 rhel-registration 环境文件。在大多数情况下，排除以下文件：

   • rhel-registration/environment-rhel-registration.yaml
   • rhel-registration/rhel-registration-resource-registry.yaml

2. 如果您使用自定义 roles_data 文件，请确保 roles_data 文件中的每个角色都包含 OS::TripleO::Services::Rhsm 可组合服务。例如：

   - name: Controller
     description: |
       Controller role that has all the controller services loaded and handles
       Database, Messaging and Network functions.
     CountDefault: 1
     ...
     ServicesDefault:
       ...
       - OS::TripleO::Services::Rhsm
       ...

3. 为 rhsm 可组合服务参数添加环境文件，以备将来部署操作。

流程

1. 创建名为 templates/rhsm.yml 的环境文件，以存储配置。

2. 在环境文件中包含您的配置。例如：

   resource_registry:
     OS::TripleO::Services::Rhsm: /usr/share/openstack-tripleo-heat-templates/deployment/rhsm/rhsm-baremetal-ansible.yaml
   parameter_defaults:
     RhsmVars:
       rhsm_activation_key: "myactivationkey"
       rhsm_method: "satellite"
       rhsm_org_id: "ACME"
       rhsm_server_hostname: "satellite.example.com"
       rhsm_baseurl: "https://satellite.example.com/pulp/repos"
       rhsm_release: 8.2

   resource_registry 将 rhsm 可组合服务与 OS::TripleO::Services::Rhsm 资源相关联，该资源可在每个角色上可用。

   RhsmVars 变量向 Ansible 传递参数来配置红帽注册。

3. 保存环境文件。

流程

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

2. 创建名为 playbook-satellite.yaml 的文件，并将以下内容粘贴到文件中：

   - name: Pre-install leapp
     hosts: overcloud
     become: yes
     tasks:
       - name: Pre-install leapp
         yum:
           name:
             - leapp
             - leapp-repository
           state: installed
       - name: Remove katello-host-tools-fact-plugin
         yum:
           name:
             - katello-host-tools-fact-plugin
           state: removed
       - name: Register system
         redhat_subscription:
           activationkey: "osp16-key"
           org_id: "ACME"
           server_hostname: "satellite.example.com"
           rhsm_baseurl: "https://satellite.example.com/pulp/repos"
           force_register: True

   修改 redhat_subscription 变量，以适合您的 Satellite 服务器。

3. 运行 playbook：

   $ ansible-playbook -i ~/inventory.yaml playbook-satellite.yaml

1. 升级 undercloud，但保留 ceph-ansible版本 3
2. 启动 overcloud 升级

3. 对托管 Ceph Storage 容器化服务的每个节点执行以下任务：

   1. 将 Ceph Storage 容器化服务迁移到 Podman
   2. 升级操作系统
   3. 升级 OpenStack Platform 服务，该服务重新启动 Ceph Storage 版本 3 容器化服务
4. 完成 overcloud 升级
5. 将 ceph-ansible 升级到 undercloud 上的版本 4
6. 升级到 overcloud 上的 Red Hat Ceph Storage 4

流程

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

2. 运行 dnf 命令检查 ceph-ansible 软件包的版本：

   $ sudo dnf info ceph-ansible

   命令输出显示 ceph-ansible 软件包的版本 3：

   Installed Packages
   Name         : ceph-ansible
   Version      : 3.xx.xx.xx
   ...

流程

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

2. 编辑包含 overcloud Ceph Storage 配置的环境文件。此文件通常命名为 ceph-config.yaml，您可以在 templates 目录中找到它：

   $ vi /home/stack/templates/ceph-config.yaml

3. 将 CephAnsibleRepo 参数添加到 parameter_defaults 部分：

   parameter_defaults:
     ...
     CephAnsibleRepo: rhceph-4-tools-for-rhel-8-x86_64-rpms
     ...

   CephAnsibleRepo 设置包含 ceph-ansible 的存储库。验证框架使用此参数来检查是否在 undercloud 上安装了 ceph-ansible。

4. 保存 ceph-config.yaml 文件。

流程

1. 登录正在运行 ceph-mon 服务的节点。此节点通常是 Controller 节点或独立 Ceph 监控节点。

2. 输入以下命令查看 Ceph 集群的状态：

   $ docker exec ceph-mon-$HOSTNAME ceph -s

3. 确认集群的运行状况是 HEALTH_OK，并且所有 OSD 都为 up。

流程

1. 启用 Ceph 工具存储库：

   [stack@director ~]$ sudo subscription-manager repos --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms

2. 安装 ceph-ansible 软件包：

   [stack@director ~]$ sudo dnf install -y ceph-ansible

流程

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

2. 编辑包含 overcloud Ceph Storage 配置的环境文件。此文件通常命名为 ceph-config.yaml，您可以在 templates 目录中找到它：

   $ vi /home/stack/templates/ceph-config.yaml

3. 将 CephAnsibleRepo 参数添加到 parameter_defaults 部分：

   parameter_defaults:
     ...
     CephAnsibleRepo: rhceph-4-tools-for-rhel-8-x86_64-rpms
     ...

   CephAnsibleRepo 设置包含 ceph-ansible 的存储库。验证框架使用此参数来检查是否在 undercloud 上安装了 ceph-ansible。

4. 保存 ceph-config.yaml 文件。

流程

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

2. source stackrc 文件：

   $ source ~/stackrc

3. 在 undercloud 上，创建一个名为 update-nic-templates.sh 的文件，并在文件中包含以下内容：

   #!/bin/bash
   STACK_NAME="overcloud"
   ROLES_DATA="/usr/share/openstack-tripleo-heat-templates/roles_data.yaml"
   NETWORK_DATA="/usr/share/openstack-tripleo-heat-templates/network_data.yaml"
   NIC_CONFIG_LINES=$(openstack stack environment show $STACK_NAME | grep "::Net::SoftwareConfig" | sed -E 's/ *OS::TripleO::// ; s/::Net::SoftwareConfig:// ; s/ http.*user-files/ /')
   echo "$NIC_CONFIG_LINES" | while read LINE; do
       ROLE=$(echo "$LINE" | awk '{print $1;}')
       NIC_CONFIG=$(echo "$LINE" | awk '{print $2;}')
   
       if [ -f "$NIC_CONFIG" ]; then
           echo "Updating template for $ROLE role."
           python3 /usr/share/openstack-tripleo-heat-templates/tools/merge-new-params-nic-config-script.py \
               --tht-dir /usr/share/openstack-tripleo-heat-templates \
               --roles-data $ROLES_DATA \
               --network-data $NETWORK_DATA \
               --role-name "$ROLE" \
               --discard-comments yes \
               --template "$NIC_CONFIG"
       else
           echo "No NIC template detected for $ROLE role. Skipping $ROLE role."
       fi
   done

   • 如果使用自定义 overcloud 名称，请将 STACK_NAME 变量设置为 overcloud 的名称。overcloud 堆栈的默认名称为 overcloud。
   • 如果您使用自定义 roles_data 文件，请将 ROLES_DATA 变量设置为自定义文件的位置。如果您使用默认的 roles_data 文件，请将变量保留为 /usr/share/openstack-tripleo-heat-templates/roles_data.yaml
   • 如果您使用自定义 network_data 文件，请将 NETWORK_DATA 变量设置为自定义文件的位置。如果您使用默认的 network_data 文件，请将变量保留为 /usr/share/openstack-tripleo-heat-templates/network_data.yaml
   • 运行 /usr/share/openstack-tripleo-heat-templates/tools/merge-new-params-nic-config-script.py -h 以查看添加到脚本的选项列表。

4. 在脚本中添加可执行权限：

   $ chmod +x update-nic-templates.sh

5. 可选：如果您为 RHOSP 环境使用 spine-leaf 网络拓扑，请检查 roles_data.yaml 文件，并确保它为您的部署的 NIC 模板使用正确的角色名称。该脚本使用 roles_data.yaml 文件中的 deprecated_nic_config_name 参数的值。

6. 运行脚本：

   $ ./update-nic-templates.sh

   该脚本保存每个自定义 NIC 模板的副本，并使用缺少的参数更新每个模板。该脚本还会跳过任何没有自定义模板的角色：

   No NIC template detected for BlockStorage role. Skipping BlockStorage role.
   Updating template for CephStorage role.
   The original template was saved as: /home/stack/templates/custom-nics/ceph-storage.yaml.20200903144835
   The update template was saved as: /home/stack/templates/custom-nics/ceph-storage.yaml
   Updating template for Compute role.
   The original template was saved as: /home/stack/templates/custom-nics/compute.yaml.20200903144838
   The update template was saved as: /home/stack/templates/custom-nics/compute.yaml
   Updating template for Controller role.
   The original template was saved as: /home/stack/templates/custom-nics/controller.yaml.20200903144841
   The update template was saved as: /home/stack/templates/custom-nics/controller.yaml
   No NIC template detected for ObjectStorage role. Skipping ObjectStorage role.

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行 upgrade preparation 命令：

   $ openstack overcloud upgrade prepare \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
3. 等待升级准备完成。

4. 下载容器镜像：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags container_image_prepare

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 通过在 undercloud 节点上运行以下命令来识别 bootstrap Controller 节点：

   $ tripleo-ansible-inventory --list --stack overcloud |jq .overcloud_Controller.hosts[0]

3. 升级 bootstrap Controller 节点：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack <stack_name> --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-0

      将 <stack_name > 替换为您的堆栈的名称。

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。

      • 作为 Leapp 升级的一部分执行重启。

        重要

        下一个命令会在 control plane 上造成中断。在接下来的几个步骤中，您无法对 overcloud 执行任何标准操作。

   3. 使用 system_upgrade_transfer_data 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags system_upgrade_transfer_data

      此命令将现有节点中的数据库的最新版本复制到 bootstrap 节点。

   4. 使用 nova_hybrid_state 标签运行 upgrade 命令，仅运行 upgrade_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run --stack STACK NAME --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      这个命令会在 Compute 节点上启动临时 16.1 容器，以便在稍后的步骤升级 Compute 节点时协助工作负载迁移。

   5. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0

      此命令执行 Red Hat OpenStack Platform 升级。

      重要

      当此命令完成后，control plane 会变为 active。您可以对 overcloud 执行标准操作。

   6. 验证升级后，新的 Pacemaker 集群是否已启动，并且 control plane 服务（如 galera、rabbit、haproxy 和 redis）是否正在运行：

      $ sudo pcs status

4. 升级下一个 Controller 节点：

   1. 验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-1

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   3. 在下一个 Controller 节点上运行带有 system_upgrade 标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1

      此命令执行 Red Hat OpenStack Platform 升级。除了此节点外，在 --limit 选项中包含之前升级的 bootstrap 节点。

5. 升级最终 Controller 节点：

   1. 验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-2

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   3. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1,overcloud-controller-2

      此命令执行 Red Hat OpenStack Platform 升级。在 --limit 选项中包含所有 Controller 节点。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 选择 Ceph Storage 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephstorage-0

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephstorage-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 可选：如果您使用 Ceph 订阅并已将 director 配置为将 overcloud-minimal 镜像用于 Ceph 存储节点，则必须完成以下步骤：

      1. 登录到节点并取消设置 Red Hat Enterprise Linux (RHEL)次版本：

         $ sudo subscription-manager release --unset

      2. 在节点上，执行系统更新：

         $ sudo dnf -y update

      3. 重新引导节点：

         $ sudo reboot

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephstorage-0

      此命令运行 config-download playbook，并在 Ceph Storage 节点上配置可组合服务。此步骤不会将 Ceph Storage 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

3. 选择下一个 Ceph Storage 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephstorage-1

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephstorage-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephstorage-1

      此命令运行 config-download playbook，并在 Ceph Storage 节点上配置可组合服务。此步骤不会将 Ceph Storage 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

4. 选择最终的 Ceph Storage 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephstorage-2

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephstorage-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephstorage-2

      此命令运行 config-download playbook，并在 Ceph Storage 节点上配置可组合服务。此步骤不会将 Ceph Storage 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 迁移您的实例。有关迁移策略的更多信息，请参阅 在 Compute 节点间迁移虚拟机。

3. 使用 system_upgrade 标签运行 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0

   这个命令执行以下操作：

   • 对操作系统执行 Leapp 升级。
   • 作为 Leapp 升级的一部分执行重启。

4. 运行没有标签的 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-compute-0

   此命令执行 Red Hat OpenStack Platform 升级。

5. 要并行升级多个 Compute 节点，请将 --limit 选项设置为您要升级的节点列表。首先执行 system_upgrade 任务：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

   然后执行标准 OpenStack 服务升级：

   $ openstack overcloud upgrade run --stack STACK NAME  --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 编辑 containers-prepare-parameter.yaml 文件，并删除以下参数及其值：

   • ceph3_namespace
   • ceph3_tag
   • ceph3_image
   • name_prefix_stein
   • name_suffix_stein
   • namespace_stein
   • tag_stein
3. 要在 overcloud 中重新启用隔离，请在 fence .yaml 环境文件中将 EnableFencing 参数设置为 true。

4. 运行 upgrade finalization 命令：

   $ openstack overcloud upgrade converge \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 将 EnableFencing 参数设置为 true 的环境文件(fencing.yaml)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行 upgrade preparation 命令：

   $ openstack overcloud upgrade prepare \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
3. 等待升级准备完成。

4. 下载容器镜像：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags container_image_prepare

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 通过在 undercloud 节点上运行以下命令来识别 bootstrap Controller 节点：

   $ tripleo-ansible-inventory --list --stack overcloud |jq .overcloud_Controller.hosts[0]

3. 升级 bootstrap Controller 节点：

   1. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。

      • 作为 Leapp 升级的一部分执行重启。

        重要

        下一个命令会在 control plane 上造成中断。在接下来的几个步骤中，您无法对 overcloud 执行任何标准操作。

   2. 使用 system_upgrade_transfer_data 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags system_upgrade_transfer_data

      此命令将现有节点中的数据库的最新版本复制到 bootstrap 节点。

   3. 使用 nova_hybrid_state 标签运行 upgrade 命令，仅运行 upgrade_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run --stack STACK NAME --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      这个命令会在 Compute 节点上启动临时 16.1 容器，以便在稍后的步骤升级 Compute 节点时协助工作负载迁移。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0

      此命令执行 Red Hat OpenStack Platform 升级。

      重要

      当此命令完成后，control plane 会变为 active。您可以对 overcloud 执行标准操作。

   5. 验证升级后，新的 Pacemaker 集群是否已启动，并且 control plane 服务（如 galera、rabbit、haproxy 和 redis）是否正在运行：

      $ sudo pcs status

4. 升级下一个 Controller 节点：

   1. 验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 在下一个 Controller 节点上运行带有 system_upgrade 标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1

      此命令执行 Red Hat OpenStack Platform 升级。除了此节点外，在 --limit 选项中包含之前升级的 bootstrap 节点。

5. 升级最终 Controller 节点：

   1. 验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1,overcloud-controller-2

      此命令执行 Red Hat OpenStack Platform 升级。在 --limit 选项中包含所有 Controller 节点。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 迁移您的实例。有关迁移策略的更多信息，请参阅 在 Compute 节点间迁移虚拟机。

3. 使用 system_upgrade 标签运行 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0

   这个命令执行以下操作：

   • 对操作系统执行 Leapp 升级。
   • 作为 Leapp 升级的一部分执行重启。

4. 运行没有标签的 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-compute-0

   此命令执行 Red Hat OpenStack Platform 升级。

5. 要并行升级多个 Compute 节点，请将 --limit 选项设置为您要升级的节点列表。首先执行 system_upgrade 任务：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

   然后执行标准 OpenStack 服务升级：

   $ openstack overcloud upgrade run --stack STACK NAME  --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 编辑 containers-prepare-parameter.yaml 文件，并删除以下参数及其值：

   • ceph3_namespace
   • ceph3_tag
   • ceph3_image
   • name_prefix_stein
   • name_suffix_stein
   • namespace_stein
   • tag_stein
3. 要在 overcloud 中重新启用隔离，请在 fence .yaml 环境文件中将 EnableFencing 参数设置为 true。

4. 运行 upgrade finalization 命令：

   $ openstack overcloud upgrade converge \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 将 EnableFencing 参数设置为 true 的环境文件(fencing.yaml)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行 upgrade preparation 命令：

   $ openstack overcloud upgrade prepare \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
3. 等待升级准备完成。

4. 下载容器镜像：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags container_image_prepare

流程

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 在 undercloud 节点上，运行以下命令来识别 bootstrap Controller 节点：

   $ tripleo-ansible-inventory --list --stack overcloud |jq .overcloud_Controller.hosts[0]

4. 升级 overcloud-controller-0、overcloud-database-0、overcloud-networker-0 和 overcloud-ceph-0 control plane 节点：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack <stack_name> --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-0,overcloud-database-0,overcloud-networker-0,overcloud-ceph-0

      将 <stack_name > 替换为您的堆栈的名称。

      这个命令执行以下操作：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-0 &
      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-database-0 &
      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-networker-0 &
      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-ceph-0 &

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。

      • 作为 Leapp 升级的一部分执行重启。

        重要

        下一个命令会在 control plane 上造成中断。在接下来的几个步骤中，您无法对 overcloud 执行任何标准操作。

   3. 使用 system_upgrade_transfer_data 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags system_upgrade_transfer_data

      此命令将现有节点中的数据库的最新版本复制到 bootstrap 节点。

   4. 使用 nova_hybrid_state 标签运行 upgrade 命令，仅运行 upgrade_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run --stack STACK NAME --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      这个命令会在 Compute 节点上启动临时 16.1 容器，以便在稍后的步骤升级 Compute 节点时协助工作负载迁移。

   5. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-database-0,overcloud-networker-0,overcloud-ceph-0 --playbook all

      此命令执行 Red Hat OpenStack Platform 升级。

      重要

      当此命令完成后，control plane 会变为 active。您可以对 overcloud 执行标准操作。

   6. 可选：在 bootstrap Contoller 节点上，验证升级后，新的 Pacemaker 集群是否已启动，以及 galera、rabbit、haproxy 和 redis 等 control plane 服务是否正在运行：

      $ sudo pcs status

5. 升级 overcloud-controller-1、overcloud-database-1、overcloud-networker-1 和 overcloud-ceph-1 control plane 节点：

   1. 登录 overcloud-controller-1 节点，并验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-1,overcloud-database-1,overcloud-networker-1,overcloud-ceph-1

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   3. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-1,overcloud-database-1,overcloud-networker-1,overcloud-ceph-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1,overcloud-database-0,overcloud-database-1,overcloud-networker-0,overcloud-networker-1,overcloud-ceph-0,overcloud-ceph-1

      此命令执行 Red Hat OpenStack Platform 升级。除了此节点外，在 --limit 选项中包含之前升级的 bootstrap 节点。

6. 升级 overcloud-controller-2、 overcloud-database- 2、overcloud-networker-2 和 overcloud-ceph-2 control plane 节点：

   1. 登录 overcloud-controller-2 节点，并验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-2,overcloud-database-2,overcloud-networker-2,overcloud-ceph-2

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   3. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-2,overcloud-database-2,overcloud-networker-2,overcloud-ceph-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1,overcloud-controller-2,overcloud-database-0,overcloud-database-1,overcloud-database-2,overcloud-networker-0,overcloud-networker-1,overcloud-networker-2,overcloud-ceph-0,overcloud-ceph-1,overcloud-ceph-2

      此命令执行 Red Hat OpenStack Platform 升级。在 --limit 选项中包含所有 control plane 节点。

流程

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 迁移您的实例。有关迁移策略的更多信息，请参阅 在 Compute 节点间迁移虚拟机。

4. 使用 system_upgrade 标签运行 upgrade 命令：

   $ openstack overcloud upgrade run -y --stack STACK NAME --tags system_upgrade --limit 'Compute[0:19]' > upgrade-compute-00-19.log 2>&1 &
   $ openstack overcloud upgrade run -y --stack STACK NAME --tags system_upgrade --limit 'Compute[20:29]' > upgrade-compute-20-29.log 2>&1 &
   $ openstack overcloud upgrade run -y --stack STACK NAME --tags system_upgrade --limit 'Compute[40:59]' > update-compute-40-59.log 2>&1 &
   $ openstack overcloud upgrade run -y --stack STACK NAME --tags system_upgrade --limit 'Compute[60:79]' > update-compute-60-79.log 2>&1 &

   这个命令执行以下操作：

   • 对操作系统执行 Leapp 升级。
   • 作为 Leapp 升级的一部分执行重启。

5. 运行没有标签的 upgrade 命令：

   $ openstack overcloud upgrade run -y --stack STACK NAME --limit 'Compute[0:19]' > upgrade-compute-00-19.log 2>&1 &
   $ openstack overcloud upgrade run -y --stack STACK NAME --limit 'Compute[20:29]' > upgrade-compute-20-29.log 2>&1 &
   $ openstack overcloud upgrade run -y --stack STACK NAME --limit 'Compute[40:59]' > update-compute-40-59.log 2>&1 &
   $ openstack overcloud upgrade run -y --stack STACK NAME --limit 'Compute[60:79]' > update-compute-60-79.log 2>&1 &

   此命令执行 Red Hat OpenStack Platform 升级。

6. 可选： 要升级所选 Compute 节点，请使用 --limit 选项以及您要升级的节点列表。以下示例并行升级 overcloud-compute-0、overcloud-compute-1、overcloud-compute-2 节点。

   1. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

   2. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME  --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 编辑 containers-prepare-parameter.yaml 文件，并删除以下参数及其值：

   • ceph3_namespace
   • ceph3_tag
   • ceph3_image
   • name_prefix_stein
   • name_suffix_stein
   • namespace_stein
   • tag_stein
3. 要在 overcloud 中重新启用隔离，请在 fence .yaml 环境文件中将 EnableFencing 参数设置为 true。

4. 运行 upgrade finalization 命令：

   $ openstack overcloud upgrade converge \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 将 EnableFencing 参数设置为 true 的环境文件(fencing.yaml)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行 upgrade preparation 命令：

   $ openstack overcloud upgrade prepare \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
3. 等待升级准备完成。

4. 下载容器镜像：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags container_image_prepare

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 通过在 undercloud 节点上运行以下命令来识别 bootstrap 节点：

   $ tripleo-ansible-inventory --list --stack overcloud |jq .overcloud_Controller.hosts[0]

3. 升级 bootstrap 节点：

   1. 如果节点包含 Ceph Storage 容器，请使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack <stack_name> --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-0

      将 <stack_name > 替换为您的堆栈的名称。

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 使用 system_upgrade_transfer_data 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags system_upgrade_transfer_data

      此命令将现有节点中的数据库的最新版本复制到 bootstrap 节点。

   4. 使用 nova_hybrid_state 标签运行 upgrade 命令，仅运行 upgrade_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run --stack STACK NAME --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      这个命令会在 Compute 节点上启动临时 16.1 容器，以便在稍后的步骤升级 Compute 节点时协助工作负载迁移。

   5. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0

      此命令执行 Red Hat OpenStack Platform 升级。

4. 升级每个基于 Pacemaker 的节点：

   1. 如果节点包含 Ceph Storage 容器，请使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-database-0

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 在下一个节点上运行带有 system_upgrade 标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-database-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-database-0

      此命令执行 Red Hat OpenStack Platform 升级。除了此节点外，在 --limit 选项中包含任何之前升级的节点。

5. 在每个基于 Pacemaker 的节点上重复升级过程，直到您升级了所有基于 Pacemaker 的节点。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 使用 system_upgrade 标签运行 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-networker-0

   这个命令执行以下操作：

   • 对操作系统执行 Leapp 升级。
   • 作为 Leapp 升级的一部分执行重启。

3. 运行没有标签的 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-networker-0

   此命令执行 Red Hat OpenStack Platform 升级。

4. 在每个节点上重复升级过程，直到您升级了所有基于 Controller 的节点。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 选择 Ceph MON 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephmon-0

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephmon-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephmon-0

      此命令运行 config-download playbook，并在 Ceph MON 节点上配置可组合服务。此步骤不会将 Ceph MON 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

3. 选择下一个 Ceph MON 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephmon-1

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephmon-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephmon-1

      此命令运行 config-download playbook，并在 Ceph MON 节点上配置可组合服务。此步骤不会将 Ceph MON 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

4. 选择最终的 Ceph MON 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephmon-2

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephmon-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephmon-2

      此命令运行 config-download playbook，并在 Ceph MON 节点上配置可组合服务。此步骤不会将 Ceph MON 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 选择 Ceph Storage 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephstorage-0

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephstorage-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 可选：如果您使用 Ceph 订阅并已将 director 配置为将 overcloud-minimal 镜像用于 Ceph 存储节点，则必须完成以下步骤：

      1. 登录到节点并取消设置 Red Hat Enterprise Linux (RHEL)次版本：

         $ sudo subscription-manager release --unset

      2. 在节点上，执行系统更新：

         $ sudo dnf -y update

      3. 重新引导节点：

         $ sudo reboot

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephstorage-0

      此命令运行 config-download playbook，并在 Ceph Storage 节点上配置可组合服务。此步骤不会将 Ceph Storage 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

3. 选择下一个 Ceph Storage 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephstorage-1

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephstorage-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephstorage-1

      此命令运行 config-download playbook，并在 Ceph Storage 节点上配置可组合服务。此步骤不会将 Ceph Storage 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

4. 选择最终的 Ceph Storage 节点并升级操作系统：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-cephstorage-2

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-cephstorage-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   3. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-cephstorage-2

      此命令运行 config-download playbook，并在 Ceph Storage 节点上配置可组合服务。此步骤不会将 Ceph Storage 节点升级到 Red Hat Ceph Storage 4。Red Hat Ceph Storage 4 升级会在以后的步骤中进行。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 迁移您的实例。有关迁移策略的更多信息，请参阅 在 Compute 节点间迁移虚拟机。

3. 使用 system_upgrade 标签运行 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0

   这个命令执行以下操作：

   • 对操作系统执行 Leapp 升级。
   • 作为 Leapp 升级的一部分执行重启。

4. 运行没有标签的 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-compute-0

   此命令执行 Red Hat OpenStack Platform 升级。

5. 要并行升级多个 Compute 节点，请将 --limit 选项设置为您要升级的节点列表。首先执行 system_upgrade 任务：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

   然后执行标准 OpenStack 服务升级：

   $ openstack overcloud upgrade run --stack STACK NAME  --limit overcloud-compute-0,overcloud-compute-1,overcloud-compute-2

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 编辑 containers-prepare-parameter.yaml 文件，并删除以下参数及其值：

   • ceph3_namespace
   • ceph3_tag
   • ceph3_image
   • name_prefix_stein
   • name_suffix_stein
   • namespace_stein
   • tag_stein
3. 要在 overcloud 中重新启用隔离，请在 fence .yaml 环境文件中将 EnableFencing 参数设置为 true。

4. 运行 upgrade finalization 命令：

   $ openstack overcloud upgrade converge \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 将 EnableFencing 参数设置为 true 的环境文件(fencing.yaml)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行 upgrade preparation 命令：

   $ openstack overcloud upgrade prepare \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
3. 等待升级准备完成。

4. 下载容器镜像：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags container_image_prepare

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 通过在 undercloud 节点上运行以下命令来识别 bootstrap Controller 节点：

   $ tripleo-ansible-inventory --list --stack overcloud |jq .overcloud_Controller.hosts[0]

3. 升级 bootstrap Controller 节点：

   1. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack <stack_name> --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-0

      将 <stack_name > 替换为您的堆栈的名称。

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   2. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-0

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。

      • 作为 Leapp 升级的一部分执行重启。

        重要

        下一个命令会在 control plane 上造成中断。在接下来的几个步骤中，您无法对 overcloud 执行任何标准操作。

   3. 使用 system_upgrade_transfer_data 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags system_upgrade_transfer_data

      此命令将现有节点中的数据库的最新版本复制到 bootstrap 节点。

   4. 使用 nova_hybrid_state 标签运行 upgrade 命令，仅运行 upgrade_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run --stack STACK NAME --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      这个命令会在 Compute 节点上启动临时 16.1 容器，以便在稍后的步骤升级 Compute 节点时协助工作负载迁移。

   5. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0

      此命令执行 Red Hat OpenStack Platform 升级。

      重要

      当此命令完成后，control plane 会变为 active。您可以对 overcloud 执行标准操作。

   6. 验证升级后，新的 Pacemaker 集群是否已启动，并且 control plane 服务（如 galera、rabbit、haproxy 和 redis）是否正在运行：

      $ sudo pcs status

4. 升级下一个 Controller 节点：

   1. 验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-1

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   3. 在下一个 Controller 节点上运行带有 system_upgrade 标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-1

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1

      此命令执行 Red Hat OpenStack Platform 升级。除了此节点外，在 --limit 选项中包含之前升级的 bootstrap 节点。

5. 升级最终 Controller 节点：

   1. 验证旧集群是否不再运行：

      $ sudo pcs status

      当集群没有运行时，会显示类似如下的错误：

      Error: cluster is not currently running on this node

   2. 使用 ceph_systemd 标签运行外部升级命令：

      $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-controller-2

      这个命令执行以下功能：

      • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

   3. 使用 system_upgrade 标签运行 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-controller-2

      这个命令执行以下操作：

      • 对操作系统执行 Leapp 升级。
      • 作为 Leapp 升级的一部分执行重启。

   4. 运行没有标签的 upgrade 命令：

      $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-controller-0,overcloud-controller-1,overcloud-controller-2

      此命令执行 Red Hat OpenStack Platform 升级。在 --limit 选项中包含所有 Controller 节点。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 迁移您的实例。有关迁移策略的更多信息，请参阅 在 Compute 节点间迁移虚拟机。
3. 使用 Ceph MON 服务注销节点，再返回到 undercloud。

4. 使用 ceph_systemd 标签运行外部升级命令：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-computehci-0

   这个命令执行以下功能：

   • 更改控制 Ceph Storage 容器的 systemd 单元以使用 Podman 管理。
   • 使用 ceph_ansible_limit 变量将操作限制为所选 Ceph Storage 节点。

   此步骤是为 leapp 升级准备 Ceph Storage 服务的主要措施。

5. 使用 system_upgrade 标签运行 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-computehci-0

   这个命令执行以下操作：

   • 对操作系统执行 Leapp 升级。
   • 作为 Leapp 升级的一部分执行重启。

6. 运行没有标签的 upgrade 命令：

   $ openstack overcloud upgrade run --stack STACK NAME --limit overcloud-computehci-0

   此命令执行 Red Hat OpenStack Platform 升级。

7. 要并行升级多个 Compute 节点，请将 --limit 选项设置为您要升级的节点列表。首先使用 ceph_systemd 标签运行外部升级命令：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph_systemd -e ceph_ansible_limit=overcloud-computehci-0,overcloud-computehci-1,overcloud-computehci-2

   然后执行 system_upgrade 任务：

   $ openstack overcloud upgrade run --stack STACK NAME --tags system_upgrade --limit overcloud-computehci-0,overcloud-computehci-1,overcloud-computehci-2

   然后执行标准 OpenStack 服务升级：

   $ openstack overcloud upgrade run --stack STACK NAME  --limit overcloud-computehci-0,overcloud-computehci-1,overcloud-computehci-2

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 编辑 containers-prepare-parameter.yaml 文件，并删除以下参数及其值：

   • ceph3_namespace
   • ceph3_tag
   • ceph3_image
   • name_prefix_stein
   • name_suffix_stein
   • namespace_stein
   • tag_stein
3. 要在 overcloud 中重新启用隔离，请在 fence .yaml 环境文件中将 EnableFencing 参数设置为 true。

4. 运行 upgrade finalization 命令：

   $ openstack overcloud upgrade converge \
       --stack STACK NAME \
       --templates \
       -e ENVIRONMENT FILE
       …​
       -e /home/stack/templates/upgrades-environment.yaml \
       -e /home/stack/templates/rhsm.yaml \
       -e /home/stack/containers-prepare-parameter.yaml \
       -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml \
       …​

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

   • 环境文件 (upgrades-environment.yaml) 带有特定于升级的参数 (-e)。
   • 将 EnableFencing 参数设置为 true 的环境文件(fencing.yaml)。
   • 环境文件(rhsm.yaml)，以及注册和订阅参数(-e)。
   • 包含新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这是 undercloud 使用的环境文件。
   • 环境文件(neutron-ovs.yaml)，以保持 OVS 兼容性。
   • 与您的部署相关的任何自定义配置文件(-e)。
   • 如果适用，使用 --roles-file 的自定义角色(roles_data)文件。
   • 如果适用，使用 --networks-file 的可组合网络(network_data)文件。
   • 如果使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. 启用 Ceph 工具存储库：

   [stack@director ~]$ sudo subscription-manager repos --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms

2. 安装 ceph-ansible 软件包：

   [stack@director ~]$ sudo dnf install -y ceph-ansible

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 使用 ceph 标签运行 Ceph Storage 外部升级过程：

   $ openstack overcloud external-upgrade run --stack STACK NAME --tags ceph

3. 等待 Ceph Storage 升级完成。

流程

1. 以 heat-admin 用户身份登录具有 Ceph MON 容器的节点，如 Controller 节点或独立 Ceph MON 节点。例如，在标准 overcloud 部署中，overcloud-controller-1 使用 Ceph MON 容器。

2. 查询 Ceph 集群，以查看 OSD 正在使用哪些驱动程序：

   [heat-admin@overcloud-controller-1 ~]$ sudo -i
   [root@overcloud-controller-1 ~]# podman exec -it ceph-mon-overcloud-controller-1 sh -c "ceph -f json osd metadata" | jq -c 'sort_by(.hostname) | .[] | ["host", .hostname, "osd_id", .id, "objectstore", .osd_objectstore]'
   [root@overcloud-controller-1 ~]#

3. 如果任一行返回 "objectstore": "filestore"，则该节点需要 OSD 迁移。

流程

1. 确保 CephAnsibleDisksConfig 参数中的 osd_objectstore 不默认为 filestore。如果任何自定义 heat 环境文件中存在 osd_objectstore 参数，则必须明确定义 bluestore 的值。

   parameter_defaults:
     CephAnsibleDisksConfig:
       devices:
         - /dev/sdb
         - /dev/sdc
         - /dev/sdd
       osd_scenario: lvm
      osd_objectstore: bluestore

   注意

   如果您使用任何特定的 FileStore 配置，例如日志，请确保相应地更新配置。有关高级配置的更多信息，请参阅 Deploying an overcloud with containerized Red Hat Ceph 指南中的 Mapping the Ceph Storage Node Disk Layout。

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

3. 使用 ceph_fstobs 标签输入 openstack overcloud external-upgrade run 命令。将 <NODE_NAME > 替换为您要升级的 Ceph OSD 节点的名称。您可以使用 openstack server list 命令查找节点名称。

   [stack@undercloud ~] $ openstack overcloud external-upgrade run --tags ceph_fstobs -e ceph_ansible_limit=<NODE_NAME> | tee oc-fstobs.log

4. 登录具有 Ceph MON 服务的节点，并查询 Ceph 集群来检查您升级的节点 OSD 的状态。在开始迁移下一个 OSD 节点前，您必须确保您已成功迁移升级：

   [heat-admin@overcloud-controller-1 ~]$ sudo -i
   [root@overcloud-controller-1 ~]# podman exec -it ceph-mon-overcloud-controller-1 sh -c "ceph -f json osd metadata" | jq -c '.[] | select(.hostname == "<NODE_NAME>") | ["host", .hostname, "osd_id", .id, "objectstore", .osd_objectstore]'
   [root@overcloud-controller-1 ~]# exit

   将 <NODE_NAME> 替换为迁移的节点的名称。如果结果显示 OSD 使用 BlueStore，则其迁移成功。

5. 可选： 要查看特定 OSD 的更多详情，请输入以下命令：

   [root@overcloud-controller-1 ~]# podman exec -it ceph-mon-overcloud-controller-1 sh -c "ceph osd metadata <ID>"

   将 <ID> 替换为您要查询的 OSD 的 ID。

6. 在下一个节点上启动迁移过程前，您必须等待集群同步。

   [root@overcloud-controller-1 ~]# podman exec -it ceph-mon-overcloud-controller-1 sh -c  "ceph  -s"

   Review the command output and ensure that the health of the cluster is `HEALTH_OK` and the PGs are in the `active+clean` state.

7. 在下一个节点上启动迁移过程前，您必须等待集群重新平衡过程完成。要遵循状态，请运行以下命令：

   [heat-admin@overcloud-controller-0 ~]$ sudo podman exec ceph-mon-<NODE_NAME> ceph -w

   将 <NODE_NAME> 替换为迁移的节点的名称。

8. 为存储集群中的每个节点重复迁移过程。

流程

1. 以 heat-admin 用户身份登录到托管在其中一个 Controller 节点上的 ceph-mon 容器。

2. 查询 Ceph 集群：

   [heat-admin@overcloud-controller-1 ~]$ sudo -i
   [root@overcloud-controller-1 ~]# podman exec -it ceph-mon-overcloud-controller-1 sh -c "ceph -f json osd metadata" | jq -c 'sort_by(.hostname) | .[] | ["host", .hostname, "osd_id", .id, "objectstore", .osd_objectstore]'
   [root@overcloud-controller-1 ~]#

流程

1. 删除不必要的软件包

   $ sudo dnf -y remove --exclude=python-pycadf-common python2*

2. 从 /httpboot 和 /tftpboot 目录中删除包含 Red Hat OpenStack 13 中使用的旧镜像的内容：

   $ sudo rm -rf /httpboot /tftpboot

流程

1. source stackrc 文件：

   $ source ~/stackrc

2. 使用 --group post-upgrade 选项运行 openstack tripleo validator run 命令：

   $ openstack tripleo validator run --group post-upgrade

3. 查看验证报告的结果。要查看特定验证的详细输出，请根据报告中具体验证的 UUID 运行 openstack tripleo validator show run --full 命令：

   $ openstack tripleo validator show run --full <UUID>

流程

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

2. source stackrc 文件：

   $ source ~/stackrc

3. 安装包含 overcloud QCOW2 归档的软件包：

   $ sudo dnf install rhosp-director-images rhosp-director-images-ipa

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

   $ rm -rf ~/images/*

5. 解压存档：

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

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

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

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

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