搜索

3.7. 升级前进行最后的检查

download PDF

在开始升级前,请对所有准备步骤进行最终检查。

3.7.1. upgrade 命令概述

升级过程涉及您在进程的特定阶段运行的不同命令。

重要

本节仅包含每个命令的信息。您必须以特定顺序运行这些命令,并提供特定于 overcloud 的选项。等待您收到说明,以便在适当的步骤中运行这些命令。

3.7.1.1. OpenStack overcloud 升级准备

此命令执行 overcloud 升级的初始准备步骤,其中包括将 undercloud 上的当前 overcloud 计划替换为新的 OpenStack Platform 17.1 overcloud 计划和更新的环境文件。此命令的功能与 openstack overcloud deploy 命令类似,并使用许多相同的选项。

在运行 openstack overcloud upgrade prepare 命令前,您必须执行 overcloud 采用。有关 overcloud 采用的更多信息,请参阅 执行 overcloud 采用

3.7.1.2. OpenStack overcloud 升级运行

此命令执行升级过程。director 根据新的 OpenStack Platform 17.1 overcloud 计划创建一组 Ansible playbook,并在整个 overcloud 上运行快速转发任务。这包括通过 16.2 到 17.1 的每个 OpenStack Platform 版本运行升级过程。

除了标准升级过程外,这个命令还可以对 overcloud 节点上的操作系统执行 Leapp 升级。使用 --tags 选项运行这些任务。

为 Leapp 升级任务标签

system_upgrade
合并了 system_upgrade_preparesystem_upgrade_runsystem_upgrade_reboot 的任务。
system_upgrade_prepare
使用 Leapp 准备操作系统升级的任务。
system_upgrade_run
运行 Leapp 和升级操作系统的任务。
system_upgrade_reboot
重启系统并完成操作系统升级的任务。

3.7.1.3. OpenStack overcloud external-upgrade run

此命令在标准升级过程外执行升级任务。director 根据新的 OpenStack Platform 17.1 overcloud 计划创建一组 Ansible playbook,并使用 --tags 选项运行特定的任务。

用于容器管理的外部任务标签

container_image_prepare
将容器镜像拉取到 undercloud registry 的任务,并为 overcloud 使用准备镜像。

3.7.2. 升级参数

您可以使用升级参数修改升级过程的行为。

参数描述

UpgradeInitCommand

在所有 overcloud 节点上运行的命令或脚本片段以初始化升级过程。例如,仓库开关。

UpgradeInitCommonCommand

升级过程所需的常用命令。这通常不应该由 Operator 修改,并在 major-upgrade-composable-steps.yaml 和 major-upgrade-converge.yaml 环境文件中设置和取消设置。

UpgradeLeappCommandOptions

附加到 Leapp 命令的其他命令行选项。

UpgradeLeappDebug

运行 Leapp 时打印调试输出。默认值为 true

UpgradeLeappDevelSkip

在 development/testing 中运行 Leapp 时,通过设置 env 变量跳过 Leapp 检查。例如: LEAPP_DEVEL_SKIP_RHSM=1。

UpgradeLeappEnabled

使用 Leapp 进行操作系统升级。默认值为 false

UpgradeLeappPostRebootDelay

等待机器重启并响应 test 命令的最大(秒)。默认值为 120

UpgradeLeappRebootTimeout

通过 Leapp 进行 OS 升级阶段的超时(秒)。默认值为 3600

UpgradeLeappToInstall

Leapp 升级后要安装的软件包列表。

UpgradeLeappToRemove

Leapp 升级过程中要删除的软件包列表。

3.7.3. 部署中包含的自定义文件

如果部署中的任何 overcloud 节点都是专用的 Object Storage (swift)节点,您必须复制默认的 roles_data.yaml 文件,并编辑 ObjectStorage 以删除 deprecated_server_resource_name: 'SwiftStorage'。然后使用 --roles-file 选项将文件传递到 openstack overcloud upgrade prepare 命令。

3.7.4. 要包括在部署中的新环境文件

除了常规的 overcloud 环境文件外,还必须包含新的环境文件,以便于升级到 Red Hat OpenStack Platform (RHOSP) 17.1。

File备注

/home/stack/templates/upgrades-environment.yaml

此文件包含特定于升级的参数。此文件只在升级的持续时间内是必需的。

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

包含源和准备步骤的文件。这是与 undercloud 升级一起使用的相同文件。

/home/stack/templates/ceph.yaml

此文件包含 Ceph Storage 覆盖所需的参数。

运行以下命令,将这些文件添加到环境文件列表的末尾:

  • OpenStack overcloud 升级准备
  • OpenStack overcloud 部署

3.7.5. 从部署中删除的环境文件

删除特定于 OpenStack Platform Red Hat OpenStack Platform 16.2 的任何环境文件:

  • Red Hat OpenStack Platform 16.2 容器镜像列表
  • Red Hat OpenStack Platform 16.2 客户门户网站或 Satellite rhel-registration 脚本

运行以下命令,从包含的环境文件列表中删除这些文件:

  • OpenStack overcloud 升级准备
  • OpenStack overcloud 部署

3.7.6. 升级 IPA 服务

如果环境中无处启用了 TLS,请为 Nova Host Manager 角色添加额外的权限,以允许创建 DNS 区域条目。

先决条件

检查您的环境中是否包含 Nova 主机管理权限:

$ ipa privilege-show "Nova Host Management"

如果您已有这个权限,请跳过以下步骤。

流程

  1. stack 用户身份登录 undercloud 主机。
  2. 查找 stackrc undercloud 凭证文件:

    $ source ~/stackrc
  3. 添加 Nova 主机管理权限

    $ kinit admin
    $ ipa privilege-add-permission 'Nova Host Management' --permission 'System: Modify Realm Domains'
  4. 创建名为 ipa_environment.yaml 的环境文件,并包含以下配置:

    resource_registry:
      OS::TripleO::Services::IpaClient: /usr/share/openstack-tripleo-heat-templates/deployment/ipa/ipaservices-baremetal-ansible.yaml
    
    parameter_defaults:
      IdMServer: $IPA_FQDN
      IdMDomain: $IPA_DOMAIN
      IdMInstallClientPackages: False
  5. 保存环境文件。

3.7.7. 升级清单

使用以下清单来确定升级 overcloud 的就绪情况:

complete

验证正常工作的 overcloud。

Y / N

对 overcloud control plane 执行 Relax-and-Recover (ReaR)备份。如需更多信息,请参阅 Red Hat OpenStack Platform 16.2 备份和恢复 undercloud 和 control plane 节点

Y / N

创建在 undercloud 节点上运行的数据库的备份。如需更多信息,请参阅 Red Hat OpenStack Platform 17.1 备份和恢复 undercloud 和 control plane 节点中的创建 undercloud 节点备份

Y / N

更新了 Red Hat OpenStack Platform 17.1 存储库的注册详情,并将环境文件转换为使用基于 Ansible 的方法。

Y / N

更新了网络配置模板。

Y / N

使用 Red Hat OpenStack Platform 17.1 的新环境文件更新了您的环境文件列表。

Y / N

可选: 如果您的部署包含专用 Object Storage (swift)节点:

复制 roles_data.yaml 文件,删除了 deprecated_server_resource_name: 'SwiftStorage',并将该文件传递给 openstack overcloud upgrade prepare 命令。

Y / N

删除了仅与 Red Hat OpenStack Platform 16.2 相关的旧环境文件,如旧的 Red Hat registration 和容器镜像位置文件。

Y / N

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.