第 11 章 使用 director Operator 执行 RHOSP overcloud 的次要更新


Red Hat OpenStack Platform (RHOSP)环境的次要更新涉及更新 overcloud 节点上的 RPM 软件包和容器。您可能需要更新某些服务的配置。在次版本更新过程中,data plane 和 control plane 完全可用。您必须完成以下步骤来更新 RHOSP 环境:

  1. 为次版本更新准备您的 RHOSP 环境。
  2. 可选:更新 ovn-controller 容器。
  3. 更新包含 Pacemaker 服务的 Controller 节点和可组合节点。
  4. 更新 Compute 节点。
  5. 更新 Red Hat Ceph Storage 节点。
  6. 更新 Red Hat Ceph Storage 集群。
  7. 重新引导 overcloud 节点。

先决条件

11.1. 准备 director Operator 以进行次要更新

要准备 Red Hat OpenStack Platform (RHOSP)环境,以使用 director Operator (OSPdO)执行次要更新,请完成以下任务:

  1. 将 director Operator 更新至最新可用版本。
  2. 更新 openstackclient pod。
  3. 将 RHOSP 环境锁定到 Red Hat Enterprise Linux (RHEL)发行版本。
  4. 更新 RHOSP 软件仓库。
  5. 登录到容器 registry。
  6. 更新容器镜像准备文件。
  7. 在 overcloud 中禁用隔离。

11.1.1. 更新 director Operator

在执行 overcloud 升级前,您必须将 director Operator (OSPdO)更新至最新的 17.1 版本。要更新 OSPdO,您必须首先删除并重新安装当前的 OSPdO。要删除 OSPdO,请删除 OSPdO 订阅和 CSV。

流程

  1. 在 currentCSV 字段中检查 director Operator 的当前版本:

    $ oc get subscription osp-director-operator-subscription -n openstack -o yaml | grep currentCSV
  2. 删除目标命名空间中 director Operator 的 CSV:

    $ oc delete clusterserviceversion <current_CSV> -n openstack
    • 将 <current_CSV > 替换为第 1 步中的 currentCSV 值。
  3. 删除订阅:

    $ oc delete subscription  osp-director-operator.openstack -n openstack
  4. 安装最新的 17.1 director Operator。如需更多信息,请参阅安装 director Operator。

11.1.2. 更新 openstackclient pod

更新 openstackclient pod 容器镜像,以使用正确的 director heat 模板和 Ansible 角色。

流程

  1. 进入 openstack 项目:

    $ oc project openstack
  2. 检查 CSV 中的当前镜像值:

    $ oc get csv -n openstack -o yaml | grep -E 'name: (OPENSTACKCLIENT|HEAT_API|HEAT_ENGINE|MARIADB|RABBITMQ)_IMAGE_URL_DEFAULT' -A1

    例如,这显示了当前的镜像引用:

    - name: OPENSTACKCLIENT_IMAGE_URL_DEFAULT
      value: registry.redhat.io/rhosp-rhel9/openstack-tripleoclient@sha256:0c8068ba...
  3. 对于每个镜像,在 Red Hat Ecosystem Catalog 上找到目标 RHOSP 版本的新镜像摘要。搜索以下容器镜像:

    • openstack-tripleoclient-container for OPENSTACKCLIENT_IMAGE_URL_DEFAULT
    • openstack-heat-api-container for HEAT_API_IMAGE_URL_DEFAULT
    • openstack-heat-engine-container for HEAT_ENGINE_IMAGE_URL_DEFAULT
    • openstack-mariadb-container for MARIADB_IMAGE_URL_DEFAULT
    • openstack-rabbitmq-container for RABBITMQ_IMAGE_URL_DEFAULT

      选择目标版本的镜像(例如 17.1.13),并复制镜像摘要 URL (例如: registry.redhat.io/rhosp-rhel9/openstack-tripleoclient@sha256:<new_digest>)。

  4. 编辑 CSV,并将每个镜像摘要替换为新镜像摘要:

    $ oc edit csv

    对于每个 _IMAGE_URL_DEFAULT 条目,将 @sha256:... 摘要替换为目录中的新摘要。

  5. 删除任何现有临时 Heat 实例:

    $ oc delete openstackephemeralheat --all
  6. 从 openstackclient 自定义资源中删除当前的 imageURL,将 pod 更新至新镜像:

    $ oc patch openstackclient -n openstack openstackclient --type=json -p="[{'op': 'remove', 'path': '/spec/imageURL'}]"

11.1.3. 将 RHOSP 环境锁定到 RHEL 发行版本

Red Hat OpenStack Platform (RHOSP) 17.1 在 Red Hat Enterprise Linux (RHEL) 9.2 上被支持。在执行更新之前,请将 overcloud 存储库锁定到 RHEL 9.2 版本,以避免将操作系统升级到较新的次版本。

注意

如果您的部署使用存储在 heatEnvConfigMap ConfigMap 中的 parameter_defaults 文件中的 RhsmVars,请确保 rhsm_release 参数设置为 9.2。您可以使用以下方法进行检查:

$ oc get configmap heat-env-config -n openstack -o yaml | grep -A 10 RhsmVars

如果您的 ConfigMap 具有不同的名称,请检查 OpenStackConfigGenerator 资源中使用的名称:

$ oc get openstackconfiggenerator -n openstack -o yaml | grep heatEnvConfigMap

流程

  1. 访问 openstackclient pod 的远程 shell:

    $ oc rsh openstackclient
  2. 创建名为 set_release.yaml 的 playbook,其中包含将操作系统版本锁定到所有节点上的 RHEL 9.2 的任务:

    - hosts: all
      gather_facts: false
      tasks:
        - name: set release to 9.2
          command: subscription-manager release --set=9.2
          become: true
  3. 在 openstackclient pod 上运行 set_release.yaml playbook:

    $ ansible-playbook -i /home/cloud-admin/ctlplane-ansible-inventory /home/cloud-admin/set_release.yaml --limit Controller,Compute

    使用 --limit 选项,将内容应用到所有 RHOSP 节点。不要针对 Red Hat Ceph Storage 节点运行此 playbook,因为您可能对这些节点有不同的订阅。

    注意

    要手动将节点锁定到某个版本,请登录该节点并运行 subscription-manager release 命令:

    $ sudo subscription-manager release --set=9.2
  4. 退出 openstackclient pod 的远程 shell:

    $ exit

11.1.4. 更新 RHOSP 软件仓库

更新您的软件仓库以使用 Red Hat OpenStack Platform (RHOSP) 17.1。有关每个角色的存储库的完整列表,请参阅 Overcloud 存储库。

注意

如果您的部署在 heatEnvConfigMap ConfigMap 中的 parameter_defaults 文件中使用 RhsmVars,请确保 rhsm_repos 列表与以下 playbook 启用的存储库匹配。您可以使用以下方法进行检查:

$ oc get configmap heat-env-config -n openstack -o yaml | grep -A 10 RhsmVars

如果您的 ConfigMap 具有不同的名称,请检查 OpenStackConfigGenerator 资源中使用的名称:

$ oc get openstackconfiggenerator -n openstack -o yaml | grep heatEnvConfigMap

流程

  1. 访问 openstackclient pod 的远程 shell:

    $ oc rsh openstackclient
  2. 创建名为 update_rhosp_repos.yaml 的 playbook,以启用 Controller 和 Compute 节点所需的存储库。以下示例为 Controller 和 Compute 节点启用软件仓库:

    - hosts: all
      gather_facts: false
      vars:
        repos:
          - rhel-9-for-x86_64-baseos-e4s-rpms
          - rhel-9-for-x86_64-appstream-e4s-rpms
          - rhel-9-for-x86_64-highavailability-e4s-rpms
          - openstack-17.1-for-rhel-9-x86_64-rpms
          - fast-datapath-for-rhel-9-x86_64-rpms
          - rhceph-6-tools-for-rhel-9-x86_64-rpms
      tasks:
        - name: Disable all repos
          command: "subscription-manager repos --disable '*'"
          become: true
        - name: Enable RHOSP 17.1 repos
          command: "subscription-manager repos --enable={{ item }}"
          loop: "{{ repos }}"
          become: true
  3. 在 openstackclient pod 上运行 update_rhosp_repos.yaml playbook:

    $ ansible-playbook -i /home/cloud-admin/ctlplane-ansible-inventory /home/cloud-admin/update_rhosp_repos.yaml --limit Controller,Compute

    使用 --limit 选项,将内容应用到所有 RHOSP 节点。不要针对 Red Hat Ceph Storage 节点运行此 playbook,因为它们使用不同的订阅。

  4. 创建名为 update_ceph_repos.yaml 的 playbook,以便在所有 Red Hat Ceph Storage 节点上启用所需的存储库:

    - hosts: all
      gather_facts: false
      vars:
        repos:
          - rhel-9-for-x86_64-baseos-rpms
          - rhel-9-for-x86_64-appstream-rpms
          - openstack-17.1-deployment-tools-for-rhel-9-x86_64-rpms
          - openstack-17.1-for-rhel-9-x86_64-rpms
          - rhceph-6-tools-for-rhel-9-x86_64-rpms
          # - fast-datapath-for-rhel-9-x86_64-rpms 
    1
    
      tasks:
        - name: Disable all repos
          command: "subscription-manager repos --disable '*'"
          become: true
        - name: Enable Ceph Storage repos
          command: "subscription-manager repos --enable={{ item }}"
          loop: "{{ repos }}"
          become: true
    1
    如果在 Ceph Storage 节点上使用了 OVS,则启用 fast-datapath-for-rhel-9-x86_64-rpms。
  5. 在 openstackclient pod 上运行 update_ceph_repos.yaml playbook:

    $ ansible-playbook -i /home/cloud-admin/ctlplane-ansible-inventory /home/cloud-admin/update_ceph_repos.yaml --limit CephStorage

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

  6. 退出 openstackclient pod 的远程 shell:

    $ exit

11.1.5. 登录到容器 registry

如果自上次部署运行以来 overcloud 节点已重启,则容器 registry 登录会话可能会已过期。您必须确保所有 overcloud 节点都可以向容器 registry 进行身份验证,以便在更新过程中拉取更新的容器镜像。

流程

  1. 访问 openstackclient pod 的远程 shell:

    $ oc rsh openstackclient
  2. 创建名为 registry-login.yaml 的 playbook,以登录到所有节点上的容器 registry:

    - hosts: all
      gather_facts: false
      tasks:
        - name: Login to container registry
          command: podman login registry.redhat.io --username <username> --password <password>
          become: true
    • 将 <username &gt ; 和 <password > 替换为您的红帽容器 registry 凭证。

      注意

      您可以在 ContainerImageRegistryCredentials 参数下的 heatEnvConfigMap ConfigMap 中找到为部署配置的 registry 凭证:

      $ oc get configmap heat-env-config -n openstack -o yaml | grep -A 5 ContainerImageRegistryCredentials
  3. 在所有 overcloud 节点的 openstackclient pod 上运行 registry-login.yaml playbook:

    $ ansible-playbook -i /home/cloud-admin/ctlplane-ansible-inventory /home/cloud-admin/registry-login.yaml --limit overcloud

    使用-- limit overcloud 选项在所有 overcloud 节点上运行,并排除 openstackclient pod 本身。如果您的部署使用自定义角色名称,请相应地调整限制,如 example- limit Controller,Compute,CephStorage。

  4. 验证节点上的登录是否成功:

    $ ssh <controller-0.ctlplane> "sudo podman login --get-login registry.redhat.io"
  5. 退出 openstackclient pod 的远程 shell:

    $ exit

11.1.6. 更新容器镜像准备文件

容器准备文件是包含 ContainerImagePrepare 参数的文件。您可以使用此文件定义用于 overcloud 获取容器镜像的规则。

在更新环境之前,请检查 heatEnvConfigMap ConfigMap 中的 文件,以确保获取正确的镜像版本。

流程

  1. 编辑容器准备文件。此文件的默认名称为 containers-prepare-parameter.yaml。
  2. 确保为每个规则集将 tag 参数设置为 17.1 :

    parameter_defaults:
      ContainerImagePrepare:
      - push_destination: false
        set:
          ...
          tag: '17.1'
        tag_from_label: '{version}-{release}'
    注意

    如果您不想将特定的标签用于更新,如 17.1 或 17.1.1,请删除 tag 键-值对,并只指定 tag_from_label。tag_from_label 标签使用安装的 Red Hat OpenStack Platform (RHOSP)版本来决定在更新过程中使用的标签值。如需有关版本标记的更多信息,请参阅自定义 Red Hat OpenStack Platform 部署中的 容器镜像标记指南。

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

11.1.7. 在 overcloud 中禁用隔离

在更新 overcloud 之前,请确保禁用隔离。

如果在 Controller 节点更新过程中在您的环境中部署隔离,overcloud 可能会将某些节点检测到为禁用状态,并尝试隔离操作,这可能会导致意外的结果。

如果您在 overcloud 中启用了隔离,则必须在更新期间暂时禁用隔离。

流程

  1. 访问 openstackclient pod 的远程 shell:

    $ oc rsh openstackclient
  2. 登录到 Controller 节点并运行 Pacemaker 命令来禁用隔离:

    $ ssh <controller-0.ctlplane> "sudo pcs property set stonith-enabled=false"
    • 将 <controller-0.ctlplane > 替换为 Controller 节点的名称。
  3. 退出 openstackclient pod 的远程 shell:

    $ exit
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部