Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

57.50. overcloud 更新准备

使用 Heat 根据更新的模板更新和呈现新的 Ansible playbook。这些 playbook 将呈现并在更新运行步骤中使用，以执行 overcloud 节点的次要更新。

使用方法：

openstack overcloud update prepare [--templates [TEMPLATES]]
                                          [--stack STACK]
                                          [--timeout <TIMEOUT>]
                                          [--libvirt-type {kvm,qemu}]
                                          [--ntp-server NTP_SERVER]
                                          [--no-proxy NO_PROXY]
                                          [--overcloud-ssh-user OVERCLOUD_SSH_USER]
                                          [--overcloud-ssh-key OVERCLOUD_SSH_KEY]
                                          [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
                                          [--overcloud-ssh-enable-timeout OVERCLOUD_SSH_ENABLE_TIMEOUT]
                                          [--overcloud-ssh-port-timeout OVERCLOUD_SSH_PORT_TIMEOUT]
                                          [--environment-file <HEAT ENVIRONMENT FILE>]
                                          [--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
                                          [--roles-file ROLES_FILE]
                                          [--networks-file NETWORKS_FILE]
                                          [--vip-file VIP_FILE] [--no-cleanup]
                                          [--update-plan-only]
                                          [--validation-errors-nonfatal]
                                          [--validation-warnings-fatal]
                                          [--disable-validations]
                                          [--inflight-validations] [--dry-run]
                                          [--run-validations]
                                          [--skip-postconfig]
                                          [--force-postconfig]
                                          [--skip-deploy-identifier]
                                          [--answers-file ANSWERS_FILE]
                                          [--disable-password-generation]
                                          [--deployed-server]
                                          [--provision-nodes]
                                          [--config-download]
                                          [--no-config-download]
                                          [--config-download-only]
                                          [--setup-only]
                                          [--config-dir CONFIG_DIR]
                                          [--config-type CONFIG_TYPE]
                                          [--no-preserve-config]
                                          [--output-dir OUTPUT_DIR]
                                          [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
                                          [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
                                          [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
                                          [-b [<baremetal_deployment.yaml>]]
                                          [--network-config] [--limit LIMIT]
                                          [--tags TAGS]
                                          [--skip-tags SKIP_TAGS]
                                          [--ansible-forks ANSIBLE_FORKS]
                                          [--disable-container-prepare]
                                          [--working-dir WORKING_DIR]
                                          [--heat-type {pod,container,native}]
                                          [--heat-container-api-image <HEAT_CONTAINER_API_IMAGE>]
                                          [--heat-container-engine-image <HEAT_CONTAINER_ENGINE_IMAGE>]
                                          [--rm-heat] [--skip-heat-pull]
                                          [--disable-protected-resource-types]
                                          [-y]
                                          [--allow-deprecated-network-data]
Copy to Clipboard Toggle word wrap

Expand
表 57.80. 命令参数
valueSummary

--templates [TEMPLATES]

包含要部署的 heat 模板的目录

--stack STACK

创建或更新的堆栈名称

--timeout <TIMEOUT>, -t <TIMEOUT>

部署超时（以分钟为单位）。

--libvirt-type {kvm,qemu}

libvirt 域类型。

--ntp-server NTP_SERVER

overcloud 节点的 ntp。

--no-proxy NO_PROXY

以逗号分隔的主机列表，它们不应该被代理。

--overcloud-ssh-user OVERCLOUD_SSH_USER

用于 ssh 访问 overcloud 节点的用户

--overcloud-ssh-key OVERCLOUD_SSH_KEY

ssh 访问 overcloud 节点的密钥路径。Whenundefined，密钥将被自动检测。

--overcloud-ssh-network OVERCLOUD_SSH_NETWORK

用于 ssh 访问 overcloud 节点的网络名称。

--overcloud-ssh-enable-timeout OVERCLOUD_SSH_ENABLE_TIMEOUT

这个选项不再起作用。

--overcloud-ssh-port-timeout OVERCLOUD_SSH_PORT_TIMEOUT

ssh 端口变为活动状态的超时。

--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE>

要传递给 heat stack- create 或 heat stack-update 命令的环境文件。（可以多次指定。）

--environment-directory <HEAT ENVIRONMENT DIRECTORY>

自动添加到 heat stack-create 或 heat stack-update 命令的环境文件目录。可多次指定。目录中的文件以升序加载。

--roles-file ROLES_FILE, -r ROLES_FILE

角色文件，覆盖 --templates 目录中默认的 roles_data.yaml。可以是绝对路径，也可以是相对于 --templates 的路径

--networks-file NETWORKS_FILE, -n NETWORKS_FILE

networks 文件，覆盖 --templates 目录中默认的 network_data_default.yaml

--VIP-file VIP_FILE

描述网络虚拟 ips 的配置文件。

--no-cleanup

不要清理临时文件，只记录其位置

--update-plan-only

deprecated：仅更新计划。不要执行实际部署。注意：将在以后的版本中移动到离散命令。不再支持。

--validation-errors-nonfatal

尽管验证错误，允许部署继续进行。请注意，当出现错误时尝试部署可能会失败。

--validation-warnings-fatal

退出配置预检查中是否存在警告。

--disable-validations

弃用。完全禁用部署前验证。这些验证是内置的预部署验证。要启用 tripleo-validations 的外部验证，请使用 --run-validations 标志。这些验证现在通过 tripleo-validations 中的外部验证运行。

--inflight-validations

在部署期间激活动态验证。动态验证提供了一种可靠的方法来确保部署的服务在激活后运行。默认值为 False。

--dry-run

仅运行验证，但不应用任何更改。

--run-validations

从 tripleo-validations 项目运行外部验证。

--skip-postconfig

跳过 overcloud 部署后配置。

--force-postconfig

强制进行 overcloud 部署后配置。

--skip-deploy-identifier

跳过生成 DeployIdentifier 参数的唯一标识符。只有在配置实际更改时，才会触发软件配置部署步骤。这个选项应该与 Caution 一起使用，只有在确信不需要运行软件配置时，比如在扩展某些角色时。

--answers-file ANSWERS_FILE

到带有参数和参数的 yaml 文件的路径。

--disable-password-generation

禁用密码生成。

--deployed-server

弃用：使用预置备的 overcloud 节点。现在默认设置，此 CLI 选项无效。

--provision-nodes

使用 heat 置备 overcloud 节点。

--config-download

弃用：通过 config-download 机制运行部署。现在这是默认设置，此 CLI 选项无效。

--no-config-download， --stack-only

禁用 config-download 工作流，仅创建堆栈并下载配置。没有软件配置、设置或任何更改都应用到 overcloud 节点。

--config-download-only

禁用堆栈创建和设置，仅运行 config-download 工作流以应用软件配置。需要之前完成 config-download 设置，可使用 --stack-only 和 --setup-only 或完整部署

--setup-only

禁用堆栈和 config-download 工作流，以应用软件配置，仅运行设置以启用 ssh 连接。

--config-dir CONFIG_DIR

推送配置文件的目录

--config-type CONFIG_TYPE

仅在调用"--setup-only"时使用。要从部署中提取的对象类型，默认为所有可用的键

--no-preserve-config

仅在调用"--setup-only"时使用。如果指定，将删除并重新创建 --config-dir （如果已存在）。默认为使用现有的 dir 位置并覆盖文件。默认情况下，不会保留来自堆栈的 --config- dir 中的文件。

--output-dir OUTPUT_DIR

使用 --config- download 时保存输出的目录。如果没有指定，则使用 <working-dir>/config- download。

--override-ansible-cfg OVERRIDE_ANSIBLE_CFG

到 ansible 配置文件的路径。文件中配置将默认覆盖 config-download 使用的任何配置。

--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT

用于 config-download 步骤的超时（以分钟为单位）。如果未设置，则默认为在堆栈操作后从 --timeout 参数中保留的时间。

--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER

用于部署操作的 python 解释器路径。如果从 python3 系统在 python2 主机上部署，则可能需要使用它，反之亦然。

-b [<baremetal_deployment.yaml>], --baremetal-deployment [<baremetal_deployment.yaml>]

部署裸机节点、网络和虚拟 IP 地址，如 baremetal_deployment.yaml 以及 overcloud 中定义的。如果没有给出 baremetal_deployment YAML 文件，则使用 working-dir 中的 tripleo-<stack_name>-baremetal- deployment.yaml 文件。

--network-config

将网络配置应用到置备的节点。（意味着 "--network-ports"）

--limit LIMIT

标识单个节点或逗号分隔的节点列表的字符串，将限制为 config-download Ansible playbook 执行。例如：--limit "compute-0,compute-1,compute-5"。

--tags TAGS

运行 config- download ansible-playbook 命令时要使用的标签列表。

--skip-tags SKIP_TAGS

运行 config- download ansible-playbook 命令时要跳过的标签列表。

--ansible-forks ANSIBLE_FORKS

用于 config- download ansible-playbook 命令的 ansible fork 数量。

--disable-container-prepare

禁用容器准备操作，以防止更新容器标签并获取新的容器。如果您跳过此，但没有配置容器参数，则部署操作可能会失败。

--working-dir WORKING_DIR

将存储所有输入、输出和生成的文件的部署工作目录。默认为 "$HOME/overcloud-deploy/<stack>"

--heat-type {pod,container,native}

用于执行部署的 heat 流程类型。pod （默认）：使用临时 Heat pod。容器（预期）：使用临时 Heat 容器。原生（预期）：使用临时 Heat 进程。

--Heat-container-api-image <HEAT_CONTAINER_API_IMAGE>

启动 heat-api 进程时要使用的容器镜像。仅在 --heat-type=pod 时使用。默认为：localhost/tripleo/openstack-heat-api:ephemeral

--Heat-container-engine-image <HEAT_CONTAINER_ENGINE_IMAGE>

启动 heat- engine 进程时要使用的容器镜像。仅在 --heat-type=pod 时使用。默认为：localhost/tripleo/openstack-heat- engine:ephemeral

--rm-heat

如果指定，--heat-type 是 container 或 pod，则之前临时 Heat 进程中的任何现有容器或 pod 将被删除。如果 --heat-type 是原生的，则忽略。

--skip-heat-pull

当 --heat-type 是 pod 或容器时，假设容器镜像已拉取

--disable-protected-resource-types

禁用受保护的资源类型覆盖。内部使用的资源类型受到保护，且无法在用户环境中覆盖。设置此参数会禁用保护，允许在用户环境中覆盖受保护的资源类型。

-y,--yes

使用 -y 或 --yes 来跳过部署操作前所需的任何确认。请谨慎使用！

--allow-deprecated-network-data

把它设置为允许使用已弃用的网络数据 yaml 定义模式。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat