升级框架（13 到 16.2）

1. 在将 Red Hat OpenStack Platform 部署从版本 13 升级到 16.2 之前，您必须将 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 到 16.2）文档中所述的升级路径，并在适用的情况下完成支持此特定情况的条件步骤。条件步骤的开头为以下语句："如果您正在升级使用外部 Ceph 部署"。
4. 在使用外部 Ceph 部署升级时，您将安装 RHCSv4 ceph-ansible 作为 overcloud 升级过程的一部分。当您升级使用 director 部署的 Ceph 集群时，您要在 overcloud 升级过程完成后安装 RHCSv4 ceph-ansible。

流程

1. 在环境文件的 parameter_defaults 部分中，如果 DeleteOnRHELUnregistration 参数设置为 true，请将 参数设置为 false。
2. 运行 openstack overcloud update prepare 命令。
3. 运行 openstack undercloud upgrade 命令。

流程

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

   只有 Leapp 升级过程完成后才会应用 NIC 更改，并重新引导节点。

流程

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

2. 检查 /etc/ssh/sshd_config 文件，以查找 PermitRootLogin 参数：

   $ 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 存储库映射），附加到 Leapp 程序所需的知识基本文档数据，以便从 RHEL 7 原位升级到 RHEL 8，并将这些文件放在 /etc/leapp/files/ 目录中。

4. 更新您的红帽订阅：

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

     $ sudo subscription-manager refresh

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

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

     注意

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

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

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

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

   $ 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. 删除 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.2，必须将 RHEL 8 次版本设置为 8.4 ：

    $ export LEAPP_UNSUPPORTED=1
    $ export LEAPP_DEVEL_TARGET_RELEASE=8.4

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

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

    注意

    如果您在执行 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-eus-rpms --enablerepo rhel-8-for-x86_64-appstream-eus-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.2 转换，特别是与新版本的 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. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 在自定义模板中，添加 BaseTripleoPackages 变量，以在部署中包含其他软件包。例如：

   BaseTripleoPackages:
   - jq
   - lvm2
   - net-snmp
   - openstack-selinux
   - os-net-config
   - puppet-tripleo
   - python3-heat-agent*
   - python3-openstackclient

步骤

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

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

   $ sudo subscription-manager release --set=8.4

步骤

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.2-for-rhel-8-x86_64-rpms \
   --enable=fast-datapath-for-rhel-8-x86_64-rpms

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

3. 将 container-tools 软件仓库模块设置为版本 3.0：

   [stack@director ~]$ sudo dnf module reset container-tools
   [stack@director ~]$ sudo dnf module enable -y container-tools:3.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. 添加 transitional 容器参数，以在 ContainerImagePrepare 参数中设置。根据您的部署类型，以以下方式设置参数。

   • 如果您的部署使用了使用 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_* 参数定义 overcloud 使用的当前 Red Hat Ceph Storage 容器镜像。overcloud 需要 ceph3_* 和 ceph_* 参数才能从 Red Hat Ceph Storage 3 转换到 4。
     • 如果您使用 Red Hat Satellite Server 进行容器镜像存储，请将命名空间设置为 Red Hat Satellite 服务器上的镜像位置。

   • 如果您的部署使用外部 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 定义容器镜像，升级过程用于数据库迁移。
     • ceph_* 参数定义 overcloud 使用的当前 Red Hat Ceph Storage 4 容器镜像。
     • 如果您使用 Red Hat Satellite Server 进行容器镜像存储，请将命名空间设置为 Red Hat Satellite 服务器上的镜像位置。

4. 将 neutron_driver 参数更改为 openvswitch ：

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

   升级在整个过程中保持 Open vSwitch 兼容性。完成升级到 Red Hat OpenStack Platform 16.2 后，您可以将 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>
    --ansible_ssh_user heat-admin

   如果不使用默认的 overcloud 堆栈名称，请将 &lt ;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

   注意

   确保包含要检查的软件包列表。您可以使用命令中的 --extra-vars 或 --extra-vars-file 通过 CLI 提供列表。如需更多信息，请参阅 tripleo validator run 的命令参数。

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"

   将 <controller_ip > 替换为 Controller 节点的 IP 地址。您可以使用 openstack server list 命令查找 Controller 节点的 IP 地址。

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:
     UpgradeLeappCommandOptions: " --enablerepo rhel-8-for-x86_64-baseos-eus-rpms --enablerepo rhel-8-for-x86_64-appstream-eus-rpms --enablerepo rhel-8-for-x86_64-highavailability-eus-rpms --enablerepo ansible-2.9-for-rhel-8-x86_64-rpms --enablerepo fast-datapath-for-rhel-8-x86_64-rpms "

   有关您可以在环境文件中配置的升级参数的更多信息，请参阅升级 参数。

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

流程

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

   只有 Leapp 升级过程完成后才会应用 NIC 更改，并重新引导节点。

流程

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 文件，并在 provisioning 网络上添加 DockerInsecureRegistryAddress 参数，其中包含 undercloud 的 control plane 主机名和 undercloud 的 IP 地址：

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

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

流程

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

2. 设置计算命名格式：

   • 如果您使用自定义 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. 查找 stackrc undercloud 凭证文件：

   [stack@director ~]$ source ~/stackrc

3. 打开环境文件。

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

   parameter_defaults:
     <Role>ExtraConfig:
       nova::compute::libvirt::sysinfo_serial: auto

5. 将更新保存到环境文件。
6. 将该文件添加到 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-eus-rpms
         - rhel-8-for-x86_64-appstream-eus-rpms
         - rhel-8-for-x86_64-highavailability-eus-rpms
         …​
       rhsm_username: "myusername"
       rhsm_password: "p@55w0rd!"
       rhsm_org_id: "1234567"
       rhsm_pool_ids: "1a85f9223e3d5e43013e3d6e8ff506fd"
       rhsm_method: "portal"
       rhsm_release: 8.4

   • 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-eus-rpms
           - rhel-8-for-x86_64-appstream-eus-rpms
           - rhel-8-for-x86_64-highavailability-eus-rpms
           - ansible-2.9-for-rhel-8-x86_64-rpms
           - openstack-16.2-for-rhel-8-x86_64-rpms
           - fast-datapath-for-rhel-8-x86_64-rpms
         rhsm_username: "myusername"
         rhsm_password: "p@55w0rd!"
         rhsm_org_id: "1234567"
         rhsm_pool_ids: "55d251f1490556f3e75aa37e89e10ce5"
         rhsm_method: "portal"
         rhsm_release: 8.4
     ComputeParameters:
       RhsmVars:
         rhsm_repos:
           - rhel-8-for-x86_64-baseos-eus-rpms
           - rhel-8-for-x86_64-appstream-eus-rpms
           - rhel-8-for-x86_64-highavailability-eus-rpms
           - ansible-2.9-for-rhel-8-x86_64-rpms
           - openstack-16.2-for-rhel-8-x86_64-rpms
           - fast-datapath-for-rhel-8-x86_64-rpms
         rhsm_username: "myusername"
         rhsm_password: "p@55w0rd!"
         rhsm_org_id: "1234567"
         rhsm_pool_ids: "55d251f1490556f3e75aa37e89e10ce5"
         rhsm_method: "portal"
         rhsm_release: 8.4
     CephStorageParameters:
       RhsmVars:
         rhsm_repos:
           - rhel-8-for-x86_64-baseos-rpms
           - rhel-8-for-x86_64-appstream-rpms
           - rhel-8-for-x86_64-highavailability-rpms
           - ansible-2.9-for-rhel-8-x86_64-rpms
           - openstack-16.2-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.4

   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.4

   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 变量，使其适合您的卫星服务器。

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 network topology，请检查 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. 运行升级准备命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --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 <stack_name>] |jq .overcloud_Controller.hosts[0]

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

3. 升级 bootstrap Controller 节点：

   1. 在 bootstrap Controller 节点上执行操作系统的 Leapp 升级：

      $ openstack overcloud upgrade run [--stack <stack>] --tags system_upgrade --limit <bootstrap_controller_node>

      • 将 <bootstrap_controller_node > 替换为环境中 bootstrap Controller 节点的主机名，如 overcloud-controller-0。

      • 如果您不使用默认的 overcloud 堆栈名称 overcloud，请包含 --stack 可选参数，并将 &lt ;stack& gt; 替换为 overcloud 堆栈的名称。

        在 Leapp 升级过程中，bootstrap Controller 节点会被重启。

   2. 将数据库的最新版本从现有节点复制到 bootstrap 节点：

      $ openstack overcloud external-upgrade run [--stack <stack>] --tags system_upgrade_transfer_data

      重要

      此命令会导致 control plane 上的中断。在 RHOSP 升级完成并且 control plane 再次激活前，您无法对 overcloud 执行任何标准操作。

   3. 在后续步骤中，在 Compute 节点上启动临时 16.2 容器，以帮助加快工作负载迁移。

      $ openstack overcloud upgrade run --stack <stack> --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

   4. 在没有标签的情况下升级 overcloud：

      $ openstack overcloud upgrade run --stack <stack> --limit <bootstrap_controller_node>

   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 节点上执行操作系统的 Leapp 升级：

      $ openstack overcloud upgrade run --stack <stack> --tags system_upgrade --limit <controller_node>

      • 将 <controller_node > 替换为要升级的 Controller 节点的主机名，如 overcloud-controller-1。

        Controller 节点作为 Leapp 升级的一部分重启。

   3. 升级 Controller 节点，将其添加到新 Pacemaker 集群中之前升级的节点：

      $ openstack overcloud upgrade run --stack <stack> --limit <bootstrap_controller_node,controller_node_1,controller_node_n>

      • 将 < bootstrap_controller_node,controller_node_1,controller_node_n > 替换为您目前升级的 Controller 节点列表，以及您要添加到 Pacemaker 集群的额外 Controller 节点，例如 overcloud-controller-0、overcloud-controller-1、overcloud-controller-2。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

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

   $ tripleo-ansible-inventory --list [--stack <stack_name>] |jq .overcloud_Controller.hosts[0]

   • 可选：将 <stack_name > 替换为堆栈的名称。如果未指定，则默认值为 overcloud。

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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

   2. 使用 system_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_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run [--stack <stack_name>] --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      此命令在 Compute 节点上启动临时 16.2 容器，以帮助在升级 Compute 节点时协助工作负载迁移。

   5. 在没有标签的情况下运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --limit overcloud-controller-0

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

      重要

      当此命令完成后，control plane 变为活跃的。您可以对 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

   3. 在下一个 Controller 节点上使用 system_upgrade 标签运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-controller-1

      这个命令执行以下操作：

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

   4. 在没有标签的情况下运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --limit overcloud-controller-0,overcloud-controller-1

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

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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-controller-2

      这个命令执行以下操作：

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

   4. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 标签运行升级命令：

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

   这个命令执行以下操作：

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

4. 在没有标签的情况下运行升级命令：

   $ 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. 运行升级最终化命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --networks-file 可组合网络(network_data)文件。
   • 如果您使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行升级准备命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --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 <stack_name>] |jq .overcloud_Controller.hosts[0]

   • 可选：将 <stack_name > 替换为堆栈的名称。如果未指定，则默认值为 overcloud。

3. 升级 bootstrap Controller 节点：

   1. 使用 system_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_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run [--stack <stack_name>] --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      此命令在 Compute 节点上启动临时 16.2 容器，以帮助在升级 Compute 节点时协助工作负载迁移。

   4. 在没有标签的情况下运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --limit overcloud-controller-0

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

      重要

      当此命令完成后，control plane 变为活跃的。您可以对 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 标签运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-controller-1

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --limit overcloud-controller-0,overcloud-controller-1

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

5. 升级最终的 Controller 节点：

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

      $ sudo pcs status

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

      Error: cluster is not currently running on this node

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

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-controller-2

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 标签运行升级命令：

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

   这个命令执行以下操作：

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

4. 在没有标签的情况下运行升级命令：

   $ 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. 运行升级最终化命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --networks-file 可组合网络(network_data)文件。
   • 如果您使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行升级准备命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --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 <stack_name>] |jq .overcloud_Controller.hosts[0]

   • 可选：将 <stack_name > 替换为堆栈的名称。如果未指定，则默认值为 overcloud。

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

      这个命令执行以下操作：

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

      这一步是准备 Ceph Storage 服务进行 Leapp 升级的简明措施。

   2. 在每个 control plane 节点上执行操作系统的 Leapp 升级：

      $ openstack overcloud upgrade run --stack <stack_name> --tags system_upgrade --limit overcloud-controller-0,overcloud-database-0,overcloud-networker-0,overcloud-ceph-0

      control plane 节点作为 Leapp 升级的一部分重启。

      重要

      如果 Ceph 节点升级失败，请确保 controller-0 已完成升级，然后再进行剩余升级。

   3. 将数据库的最新版本从现有节点复制到 bootstrap 节点：

      $ openstack overcloud external-upgrade run --stack <stack_name> --tags system_upgrade_transfer_data

      重要

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

   4. 使用 nova_hybrid_state 标签运行升级命令，仅运行 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.2 容器，以帮助在升级 Compute 节点时协助工作负载迁移。

   5. 在没有标签的情况下运行升级命令：

      $ 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 变为活跃的。您可以对 overcloud 执行标准操作。

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

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      这一步是准备 Ceph Storage 服务进行 Leapp 升级的简明措施。

   3. 使用 system_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. 在没有标签的情况下运行升级命令：

      $ 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 升级。除了此节点外，将之前升级的 bootstrap 节点包括在 --limit 选项中。

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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      这一步是准备 Ceph Storage 服务进行 Leapp 升级的简明措施。

   3. 使用 system_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. 在没有标签的情况下运行升级命令：

      $ 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 标签运行升级命令：

   $ 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. 在没有标签的情况下运行升级命令：

   $ 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 标签运行升级命令：

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

   2. 在没有标签的情况下运行升级命令：

      $ 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. 运行升级最终化命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --networks-file 可组合网络(network_data)文件。
   • 如果您使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. 关闭工作负载。

2. 如果您部署了 director 的 Ceph，请将 Ceph systemd 文件切换到 podman：

   $ openstack overcloud external-upgrade run --stack overcloud --tags ceph_systemd -e ceph_ansible_limit=controller-0,controller-1,controller-2,ceph-0,ceph-1,ceph-2,networker-0,networker-1

   • 将 controller-0,controller-1,controller-2,ceph-0,ceph-1,ceph-2,networker-0,networker-1 替换为环境中角色的服务器名称。

   • 要升级包含 Ceph 的 Compute 节点，请在 openstack overcloud external-upgrade run 命令中包含 Compute 节点的主机名。例如：

     $ openstack overcloud upgrade run --stack overcloud --tags ceph_systemd -e ceph_ansible_limit=overcloud-compute-0,overcloud-compute-1

     此外，在第 4 和 5 步的命令中包括 Compute 节点的主机名。

3. 停止节点上的所有 RHOSP 服务：

   $ openstack overcloud external-upgrade run --stack overcloud --tags system_upgrade_stop_services

4. 在所有节点上运行系统升级。如果您部署了 director 集成的 Ceph，请在同一 --limit 命令中包含所有 Ceph 节点：

   $ openstack overcloud upgrade run --stack overcloud --tags system_upgrade --limit controller-0,controller-1,controller-2,ceph-0,ceph-1,ceph-2,networker-0,networker-1

5. 在没有标签的情况下运行升级：

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

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行升级准备命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --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 <stack_name>] |jq .overcloud_Controller.hosts[0]

   • 可选：将 <stack_name > 替换为堆栈的名称。如果未指定，则默认值为 overcloud。

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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

   2. 使用 system_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_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run [--stack <stack_name>] --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      此命令在 Compute 节点上启动临时 16.2 容器，以帮助在升级 Compute 节点时协助工作负载迁移。

   5. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

   2. 在下一个节点上，使用 system_upgrade 标签运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-database-0

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 标签运行升级命令：

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

   这个命令执行以下操作：

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

3. 在没有标签的情况下运行升级命令：

   $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

      这个命令执行以下操作：

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

   3. 在没有标签的情况下运行升级命令：

      $ 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 标签运行升级命令：

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

   这个命令执行以下操作：

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

4. 在没有标签的情况下运行升级命令：

   $ 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. 运行升级最终化命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --networks-file 可组合网络(network_data)文件。
   • 如果您使用自定义堆栈名称，请使用 --stack 选项传递名称。
5. 等待堆栈同步完成。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行升级准备命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --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 <stack_name>] |jq .overcloud_Controller.hosts[0]

   • 可选：将 <stack_name > 替换为堆栈的名称。如果未指定，则默认值为 overcloud。

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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

   2. 使用 system_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_steps_playbook.yaml playbook：

      $ openstack overcloud upgrade run [--stack <stack_name>] --playbook upgrade_steps_playbook.yaml --tags nova_hybrid_state --limit all

      此命令在 Compute 节点上启动临时 16.2 容器，以帮助在升级 Compute 节点时协助工作负载迁移。

   5. 在没有标签的情况下运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --limit overcloud-controller-0

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

      重要

      当此命令完成后，control plane 变为活跃的。您可以对 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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

   3. 在下一个 Controller 节点上使用 system_upgrade 标签运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-controller-1

      这个命令执行以下操作：

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

   4. 在没有标签的情况下运行升级命令：

      $ openstack overcloud upgrade run [--stack <stack_name>] --limit overcloud-controller-0,overcloud-controller-1

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

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 存储容器的 systemd 单元以使用 Podman 管理。
      • 使用 ceph_ansible_limit 变量将操作限制为所选 Controller 节点。

      此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

      $ openstack overcloud upgrade run [--stack <stack_name>] --tags system_upgrade --limit overcloud-controller-2

      这个命令执行以下操作：

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

   4. 在没有标签的情况下运行升级命令：

      $ 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_systemd 标签运行外部升级命令：

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

   这个命令执行以下功能：

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

   此步骤是一种初步措施，可为 leapp 升级准备 Ceph Storage 服务。

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

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

   这个命令执行以下操作：

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

5. 在没有标签的情况下运行升级命令：

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

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

6. 要并行升级多个 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. 运行升级最终化命令：

   $ 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)。
   • 使用注册和订阅参数(-e)的环境文件(rhsm.yaml)。
   • 带有新容器镜像位置(-e)的环境文件(containers-prepare-parameter.yaml)。在大多数情况下，这与 undercloud 使用的环境文件相同。
   • 用于维护 OVS 兼容性的环境文件(neutron-ovs.yaml)。
   • 与部署相关的任何自定义配置环境文件(-e)。
   • 如果适用，您的自定义角色(roles_data)文件使用 --roles-file。
   • 适用，使用 --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. 在具有 Ceph MON 容器的节点上，以 heat-admin 用户身份登录，如 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 没有默认为 文件存储。如果 osd_objectstore 参数存在于任何自定义 heat 环境文件中，您必须明确定义值 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. 登录 undercloud 并提供 overcloud 身份验证文件：

   $ source ~/overcloudrc

2. 识别升级后保留的遥测端点：

   $ openstack endpoint list | grep -i -e aodh -e gnocchi -e panko

3. 删除缺少端点的用户：

   $ openstack user delete aodh gnocchi panko