director 的安装和使用

步骤

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

2. 创建 stack 用户：

   [root@director ~]# useradd stack

3. 为该用户设置密码：

   [root@director ~]# passwd stack

4. 进行以下操作，以使用户在使用 sudo 时无需输入密码：

   [root@director ~]# echo "stack ALL=(root) NOPASSWD:ALL" | tee -a /etc/sudoers.d/stack
   [root@director ~]# chmod 0440 /etc/sudoers.d/stack

5. 切换到新的 stack 用户：

   [root@director ~]# su - stack
   [stack@director ~]$

6. 为系统镜像和 heat 模板创建目录：

   [stack@director ~]$ mkdir ~/images
   [stack@director ~]$ mkdir ~/templates

   director 使用系统镜像和 heat 模板来创建 overcloud 环境。红帽建议创建这些目录来帮助您组织本地文件系统。

7. 检查 undercloud 的基础和完整主机名：

   [stack@director ~]$ hostname
   [stack@director ~]$ hostname -f

   如果上述命令没有显示正确的完全限定主机名或报告错误，则使用 hostnamectl 设置主机名：

   [stack@director ~]$ sudo hostnamectl set-hostname undercloud.example.com
   [stack@director ~]$ sudo hostnamectl set-hostname --transient undercloud.example.com

8. 如果您所使用的 DNS 服务器无法解析 undercloud 主机完全限定域名 (FQDN)，请编辑 /etc/hosts 并为系统主机名包含一个条目。/etc/hosts 中的 IP 地址必须与您计划用于 undercloud 公共 API 的地址匹配。例如，如果系统使用 undercloud.example.com 作为 FQDN，使用 10.0.0.1 作为 IP 地址，则将以下行添加到 /etc/hosts：

   10.0.0.1  undercloud.example.com undercloud

9. 如果您计划让 Red Hat OpenStack Platform director 位于 overcloud 或其身份提供程序之外的独立域，则必须将额外的域添加到 /etc/resolv.conf：

   search overcloud.com idp.overcloud.com

   重要

   您必须为 DNS 启用端口扩展(dns_domain_ports)的 DNS 域，以便内部解析 RHOSP 环境中端口的名称。使用 NeutronDnsDomain 默认值 openstacklocal 意味着网络服务不会内部解析 DNS 的端口名称。如需更多信息，请参阅网络指南中的指定 DNS 分配给端口的名称。

步骤

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

2. 在红帽 Content Delivery Network 或 Red Hat Satellite 注册您的系统。例如，运行以下命令在 Content Delivery Network 中注册系统。根据提示输入您的客户门户网站用户名和密码：

   [stack@director ~]$ sudo subscription-manager register

3. 查找 Red Hat OpenStack Platform (RHOSP) director 的权利池 ID：

   [stack@director ~]$ sudo subscription-manager list --available --all --matches="Red Hat OpenStack"
   Subscription Name:   Name of SKU
   Provides:            Red Hat Single Sign-On
                        Red Hat Enterprise Linux Workstation
                        Red Hat CloudForms
                        Red Hat OpenStack
                        Red Hat Software Collections (for RHEL Workstation)
                        Red Hat Virtualization
   SKU:                 SKU-Number
   Contract:            Contract-Number
   Pool ID:             Valid-Pool-Number-123456
   Provides Management: Yes
   Available:           1
   Suggested:           1
   Service Level:       Support-level
   Service Type:        Service-Type
   Subscription Type:   Sub-type
   Ends:                End-date
   System Type:         Physical

4. 找到 Pool ID 值并附加 Red Hat OpenStack Platform 16.2 权利：

   [stack@director ~]$ sudo subscription-manager attach --pool=Valid-Pool-Number-123456

5. 将 undercloud 锁定到 Red Hat Enterprise Linux 8.4：

   $ 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 update -y
   [stack@director ~]$ sudo reboot

步骤

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

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

流程

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. 生成默认的容器镜像准备文件：

   $ 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. 编辑 containers-prepare-parameter.yaml 文件以排除 Ceph Storage 容器：

   parameter_defaults:
     ContainerImagePrepare:
     - push_destination: true
       excludes:
         - ceph
         - prometheus
       set:
         …​

   excludes 参数使用正则表达式来排除包含 ceph 或 prometheus 字符串的任何容器镜像。

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

步骤

1. 以下示例在 nova-compute 镜像上运行自定义 Dockerfile：

   ContainerImagePrepare:
   - push_destination: true
     ...
     includes:
     - nova-compute
     modify_role: tripleo-modify-image
     modify_append_tag: "-hotfix"
     modify_vars:
       tasks_from: modify_image.yml
       modify_dir_path: /home/stack/nova-custom
     ...

2. 以下示例显示了 /home/stack/nova-custom/Dockerfile 文件。运行任何 USER 根指令后，必须切换回原始镜像默认用户：

   FROM registry.redhat.io/rhosp-rhel8/openstack-nova-compute:latest
   
   USER "root"
   
   COPY customize.sh /tmp/
   RUN /tmp/customize.sh
   
   USER "nova"

步骤

1. 创建所有容器镜像的列表：

   $ sudo podman search --limit 1000 "registry.redhat.io/rhosp-rhel8/openstack" --format="{{ .Name }}" | sort > satellite_images
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep rhceph-4-dashboard-rhel8
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep rhceph-4-rhel8
   $ sudo podman search --limit 1000 "registry.redhat.io/openshift" | grep ose-prometheus

   • 如果您计划安装 Ceph 并启用 Ceph 仪表板，则需要以下 ose-prometheus 容器：

     registry.redhat.io/openshift4/ose-prometheus-node-exporter:v4.6
     registry.redhat.io/openshift4/ose-prometheus:v4.6
     registry.redhat.io/openshift4/ose-prometheus-alertmanager:v4.6

2. 将 satellite_images 文件复制到包含 Satellite 6 hammer 工具的系统中。或者，根据 Hammer CLI 指南中的说明将 hammer 工具安装到 undercloud 中。

3. 运行以下 hammer 命令在 Satellite 机构中创建新产品(OSP 容器)：

   $ hammer product create \
     --organization "ACME" \
     --name "OSP Containers"

   该定制产品将会包含您的镜像。

4. 添加 satellite_images 文件中的 overcloud 容器镜像：

   $ while read IMAGE; do \
     IMAGE_NAME=$(echo $IMAGE | cut -d"/" -f3 | sed "s/openstack-//g") ; \
     IMAGE_NOURL=$(echo $IMAGE | sed "s/registry.redhat.io\///g") ; \
     hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name $IMAGE_NOURL \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name $IMAGE_NAME ; done < satellite_images

5. 添加 Ceph Storage 4 容器镜像：

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/rhceph-4-rhel8 \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name rhceph-4-rhel8

   注意

   如果要安装 Ceph 仪表板，请在 hammer repository create 命令中包含 --name rhceph-4-dashboard-rhel8 ：

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/rhceph-4-dashboard-rhel8 \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name rhceph-4-dashboard-rhel8

6. 同步容器镜像：

   $ hammer product synchronize \
     --organization "ACME" \
     --name "OSP Containers"

   等待 Satellite 服务器完成同步。

   注意

   根据具体配置情况，hammer 可能会询问您的 Satellite 服务器用户名和密码。您可以使用配置文件将 hammer 配置为自动登录。有关更多信息，请参阅 Hammer CLI 指南中的身份验证章节。

7. 如果您的 Satellite 6 服务器使用内容视图，请创建一个用于纳入镜像的新内容视图版本，并在应用生命周期的不同环境之间推进这个视图。这在很大程度上取决于您如何构建应用程序的生命周期。例如，如果您的生命周期中有一个称为 production 的环境，并且希望容器镜像在该环境中可用，则创建一个包含容器镜像的内容视图，并将该内容视图推进到 production 环境中。有关更多信息，请参阅管理内容视图。

8. 检查 base 镜像的可用标签：

   $ hammer docker tag list --repository "base" \
     --organization "ACME" \
     --lifecycle-environment "production" \
     --product "OSP Containers"

   此命令显示内容视图中特定环境的 OpenStack Platform 容器镜像的标签。

9. 返回到 undercloud，并生成默认的环境文件，它将您的 Satellite 服务器用作源来准备镜像。运行以下示例命令以生成环境文件：

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

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

10. 编辑 containers-prepare-parameter.yaml 文件并修改以下参数：

    • push_destination - 根据您选择的容器镜像管理策略，将此参数设置为 true 或 false。如果将此参数设置为 false，则 overcloud 节点直接从 Satellite 拉取镜像。如果将此参数设置为 true，则 director 将镜像从 Satellite 拉取到 undercloud registry，overcloud 从 undercloud registry 拉取镜像。
    • namespace - Satellite 服务器上 registry 的 URL 和端口。Red Hat Satellite 上的默认 registry 端口为 443。

    • name_prefix - 该前缀基于 Satellite 6 规范。它的值根据您是否使用了内容视图而不同：

      • 如果您使用了内容视图，则前缀的结构为 [组织]-[环境]-[内容视图]-[产品]-。例如： acme-production-myosp16-osp_containers-。
      • 如果不使用内容视图，则前缀的结构为 [组织]-[产品]-。例如： acme-osp_containers-。
    • ceph_namespace、ceph_image、ceph_tag - 如果使用 Ceph Storage，请额外纳入这些参数以定义 Ceph Storage 容器镜像的位置。请注意，ceph_image 现包含特定于 Satellite 的前缀。这个前缀与 name_prefix 选项的值相同。

步骤

1. 将默认模板复制到 stack 用户的主目录：

   [stack@director ~]$ cp \
     /usr/share/python-tripleoclient/undercloud.conf.sample \
     ~/undercloud.conf

2. 编辑 undercloud.conf 文件。这个文件包含用于配置 undercloud 的设置。如果忽略或注释掉某个参数，undercloud 安装将使用默认值。

步骤

1. 创建名为 /home/stack/templates/custom-undercloud-params.yaml 的环境文件。

2. 编辑此文件并包括您的 heat 参数。例如，要为特定的 OpenStack Platform 服务启用调试功能，请在 custom-undercloud-params.yaml 文件中包括以下代码段：

   parameter_defaults:
     Debug: True

   完成后保存此文件。

3. 编辑 undercloud.conf 文件，找到 custom_env_files 参数。编辑该参数以指向 custom-undercloud-params.yaml 环境文件：

   custom_env_files = /home/stack/templates/custom-undercloud-params.yaml

   注意

   您可以使用逗号分隔列表指定多个环境文件。

步骤

1. 创建一个 hieradata 覆盖文件，例如 /home/stack/hieradata.yaml。

2. 将自定义的 hieradata 添加到该文件。例如，添加以下代码段，将 Compute (nova) 服务参数 force_raw_images 从默认值 True 改为 False：

   nova::compute::force_raw_images: False

   如果没有为您要设置的参数实施 Puppet，则使用以下方法配置该参数：

   nova::config::nova_config:
     DEFAULT/<parameter_name>:
       value: <parameter_value>

   例如：

   nova::config::nova_config:
     DEFAULT/network_allocate_retries:
       value: 20
     ironic/serial_console_state_timeout:
       value: 15

3. 将 undercloud.conf 文件中的 hieradata_override 参数设置为新 /home/stack/hieradata.yaml 文件的路径：

   hieradata_override = /home/stack/hieradata.yaml

流程

1. 打开 undercloud.conf 文件。

2. 将 IPv6 地址模式指定为无状态或有状态：

   [DEFAULT]
   ipv6_address_mode = <address_mode>
   ...

   根据 NIC 支持的模式，将 < address_mode > 替换为 dhcpv6-stateless 或 dhcpv6-stateful。

   注意

   当您使用有状态地址模式时，固件、链加载程序和操作系统可能会使用不同的算法来生成 DHCP 服务器跟踪的 ID。DHCPv6 不会按 MAC 跟踪地址，如果来自请求者的标识符值变化，则不会提供相同的地址，但 MAC 地址保持不变。因此，当使用有状态 DHCPv6 时，还必须完成下一步来配置网络接口。

3. 如果您将 undercloud 配置为使用有状态 DHCPv6，请指定用于裸机节点的网络接口：

   [DEFAULT]
   ipv6_address_mode = dhcpv6-stateful
   ironic_enabled_network_interfaces = neutron,flat
   ...

4. 为裸机节点设置默认网络接口：

   [DEFAULT]
   ...
   ironic_default_network_interface = neutron
   ...

5. 指定 undercloud 是否应该在 provisioning 网络中创建路由器：

   [DEFAULT]
   ...
   enable_routed_networks: <true/false>
   ...

   • 将 <true/false > 替换为 true 以启用路由网络，并防止 undercloud 在 provisioning 网络中创建路由器。为 true 时，数据中心路由器必须提供路由器公告。
   • 将 <true/false> 替换为 false 来禁用路由网络，并在 provisioning 网络中创建一个路由器。

6. 配置本地 IP 地址，以及 director Admin API 和公共 API 端点通过 SSL/TLS 的 IP 地址：

   [DEFAULT]
   ...
   local_ip = <ipv6_address>
   undercloud_admin_host = <ipv6_address>
   undercloud_public_host = <ipv6_address>
   ...

   将 <ipv6_address > 替换为 undercloud 的 IPv6 地址。

7. 可选：配置 director 用来管理实例的 provisioning 网络：

   [ctlplane-subnet]
   cidr = <ipv6_address>/<ipv6_prefix>
   ...

   • 将 <ipv6_address > 替换为不使用默认 provisioning 网络时用于管理实例的网络的 IPv6 地址。
   • 将 < ipv6_prefix > 替换为不使用默认置备网络时用于管理实例的网络的 IP 地址前缀。

8. 为置备节点配置 DHCP 分配范围：

   [ctlplane-subnet]
   cidr = <ipv6_address>/<ipv6_prefix>
   dhcp_start = <ipv6_address_dhcp_start>
   dhcp_end = <ipv6_address_dhcp_end>
   ...

   • 将 <ipv6_address_dhcp_start > 替换为要用于 overcloud 节点的网络范围的 IPv6 地址。
   • 将 <ipv6_address_dhcp_end > 替换为要用于 overcloud 节点的网络范围末尾的 IPv6 地址。

9. 可选：配置将流量转发到外部网络的网关：

   [ctlplane-subnet]
   cidr = <ipv6_address>/<ipv6_prefix>
   dhcp_start = <ipv6_address_dhcp_start>
   dhcp_end = <ipv6_address_dhcp_end>
   gateway = <ipv6_gateway_address>
   ...

   在不使用默认网关时，将 <ipv6_gateway_address> 替换为网关的 IPv6 地址。

10. 配置在检查过程中使用的 DHCP 范围：

    [ctlplane-subnet]
    cidr = <ipv6_address>/<ipv6_prefix>
    dhcp_start = <ipv6_address_dhcp_start>
    dhcp_end = <ipv6_address_dhcp_end>
    gateway = <ipv6_gateway_address>
    inspection_iprange = <ipv6_address_inspection_start>,<ipv6_address_inspection_end>
    ...

    • 将 < ipv6_address_inspection_ start> 替换为检查过程中要使用的网络范围内的 IPv6 地址。
    • 将 <ipv6_address_inspection_end > 替换为检查过程中要使用的网络范围末尾的 IPv6 地址。
    注意

    这个范围不得与 dhcp_start 和 dhcp_end 定义的范围重叠，但必须位于同一 IP 子网中。

11. 为子网配置 IPv6 名称服务器：

    [ctlplane-subnet]
    cidr = <ipv6_address>/<ipv6_prefix>
    dhcp_start = <ipv6_address_dhcp_start>
    dhcp_end = <ipv6_address_dhcp_end>
    gateway = <ipv6_gateway_address>
    inspection_iprange = <ipv6_address_inspection_start>,<ipv6_address_inspection_end>
    dns_nameservers = <ipv6_dns>

    将 <ipv6_dns> 替换为特定于子网的 DNS 名称服务器。

步骤

1. 登录 undercloud 主机。

2. 创建新文件 undercloud-os-net-config.yaml，并包含所需的网络配置。

   有关更多信息，请参阅高级 Overcloud 自定义指南中的网络接口参考。

   下面是一个示例：

   network_config:
   - name: br-ctlplane
     type: ovs_bridge
     use_dhcp: false
     dns_servers:
     - 192.168.122.1
     domain: lab.example.com
     ovs_extra:
     - "br-set-external-id br-ctlplane bridge-id br-ctlplane"
     addresses:
     - ip_netmask: 172.20.0.1/26
     members:
     - type: interface
       name: nic2

   要为特定接口创建网络绑定，请使用以下示例：

   network_config:
   - name: br-ctlplane
     type: ovs_bridge
     use_dhcp: false
     dns_servers:
       - 192.168.122.1
     domain: lab.example.com
     ovs_extra:
     - "br-set-external-id br-ctlplane bridge-id br-ctlplane"
     addresses:
     - ip_netmask: 172.20.0.1/26
     members:
     - name: bond-ctlplane
       type: linux_bond
       use_dhcp: false
       bonding_options: "mode=active-backup"
       mtu: 1500
       members:
       - type: interface
         name: nic2
       - type: interface
         name: nic3

3. 将 undercloud-os-net-config.yaml 文件的路径包含在 undercloud.conf 文件的 net_config_override 参数中：

   [DEFAULT]
   ...
   net_config_override=undercloud-os-net-config.yaml
   ...

   注意

   director 使用您在 net_config_override 参数中包含的文件作为模板来生成 /etc/os-net-config/config.yaml 文件。os-net-config 管理您在模板中定义的接口，因此您必须在此文件中执行所有 undercloud 网络接口自定义。

4. 安装 undercloud。

步骤

1. 运行以下命令，以在 undercloud 上安装 director：

   [stack@director ~]$ openstack undercloud install

   此命令会启动 director 配置脚本。director 安装附加软件包，根据 undercloud.conf 中的配置配置其服务，并启动所有 RHOSP 服务容器。这个脚本会需要一些时间来完成。

   此脚本会生成两个文件：

   • undercloud-passwords.conf - director 服务的所有密码列表。
   • stackrc - 用来访问 director 命令行工具的一组初始变量。

2. 确认 RHOSP 服务容器正在运行：

   [stack@director ~]$ sudo podman ps -a --format "{{.Names}} {{.Status}}"

   以下命令输出显示 RHOSP 服务容器正在运行(Up)：

   memcached Up 3 hours (healthy)
   haproxy Up 3 hours
   rabbitmq Up 3 hours (healthy)
   mysql Up 3 hours (healthy)
   iscsid Up 3 hours (healthy)
   keystone Up 3 hours (healthy)
   keystone_cron Up 3 hours (healthy)
   neutron_api Up 3 hours (healthy)
   logrotate_crond Up 3 hours (healthy)
   neutron_dhcp Up 3 hours (healthy)
   neutron_l3_agent Up 3 hours (healthy)
   neutron_ovs_agent Up 3 hours (healthy)
   ironic_api Up 3 hours (healthy)
   ironic_conductor Up 3 hours (healthy)
   ironic_neutron_agent Up 3 hours (healthy)
   ironic_pxe_tftp Up 3 hours (healthy)
   ironic_pxe_http Up 3 hours (unhealthy)
   ironic_inspector Up 3 hours (healthy)
   ironic_inspector_dnsmasq Up 3 hours (healthy)
   neutron-dnsmasq-qdhcp-30d628e6-45e6-499d-8003-28c0bc066487 Up 3 hours
   ...

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

   [stack@director ~]$ source ~/stackrc

   提示现在指示 OpenStack 命令对 undercloud 进行验证并执行；

   (undercloud) [stack@director ~]$

步骤

1. 查找 stackrc 文件，以启用 director 命令行工具：

   [stack@director ~]$ source ~/stackrc

2. 为 ctlplane-subnet 子网设置名称服务器：

   (undercloud) [stack@director images]$ openstack subnet set --dns-nameserver [nameserver1-ip] --dns-nameserver [nameserver2-ip] ctlplane-subnet

   请为每一个名称服务器使用 --dns-nameserver 选项。

3. 查看子网来验证名称解析服务器：

   (undercloud) [stack@director images]$ openstack subnet show ctlplane-subnet
   +-------------------+-----------------------------------------------+
   | Field             | Value                                         |
   +-------------------+-----------------------------------------------+
   | ...               |                                               |
   | dns_nameservers   | 8.8.8.8                                       |
   | ...               |                                               |
   +-------------------+-----------------------------------------------+

步骤

1. 修改 undercloud 配置文件。例如，编辑 undercloud.conf 文件并将 idrac 硬件类型添加到已启用硬件类型列表中：

   enabled_hardware_types = ipmi,redfish,idrac

2. 运行 openstack undercloud install 命令以使用新更改刷新 undercloud：

   [stack@director ~]$ openstack undercloud install

   等待命令运行完成。

3. 初始化 stack 用户以使用命令行工具：

   [stack@director ~]$ source ~/stackrc

   提示现在指示 OpenStack 命令对 undercloud 进行验证并执行：

   (undercloud) [stack@director ~]$

4. 确认 director 已应用新配置。在此示例中，检查已启用硬件类型列表：

   (undercloud) [stack@director ~]$ openstack baremetal driver list
   +---------------------+----------------------+
   | Supported driver(s) | Active host(s)       |
   +---------------------+----------------------+
   | idrac               | director.example.com |
   | ipmi                | director.example.com |
   | redfish             | director.example.com |
   +---------------------+----------------------+

步骤

1. 以 root 用户身份登录到 minion 主机。

2. 创建 stack 用户：

   [root@minion ~]# useradd stack

3. 为 stack 用户设置密码：

   [root@minion ~]# passwd stack

4. 进行以下操作，以使用户在使用 sudo 时无需输入密码：

   [root@minion ~]# echo "stack ALL=(root) NOPASSWD:ALL" | tee -a /etc/sudoers.d/stack
   [root@minion ~]# chmod 0440 /etc/sudoers.d/stack

5. 切换到新的 stack 用户：

   [root@minion ~]# su - stack
   [stack@minion ~]$

6. 检查 minion 的基础和完整主机名：

   [stack@minion ~]$ hostname
   [stack@minion ~]$ hostname -f

   如果上述命令没有显示正确的完全限定主机名或报告错误，则使用 hostnamectl 设置主机名：

   [stack@minion ~]$ sudo hostnamectl set-hostname minion.example.com
   [stack@minion ~]$ sudo hostnamectl set-hostname --transient minion.example.com

7. 编辑 /etc/hosts 文件并包括系统主机名的条目。例如：如果系统名是 minion.example.com，并使用 IP 地址 10.0.0.1，请在 /etc/hosts 文件中添加以下行：

   10.0.0.1  minion.example.com manager

8. 在红帽 Content Delivery Network 或 Red Hat Satellite 注册您的系统。例如，运行以下命令在 Content Delivery Network 中注册系统。根据提示输入您的客户门户网站用户名和密码：

   [stack@minion ~]$ sudo subscription-manager register

9. 查找 Red Hat OpenStack Platform (RHOSP) director 的权利池 ID：

   [stack@minion ~]$ sudo subscription-manager list --available --all --matches="Red Hat OpenStack"
   Subscription Name:   Name of SKU
   Provides:            Red Hat Single Sign-On
                        Red Hat Enterprise Linux Workstation
                        Red Hat CloudForms
                        Red Hat OpenStack
                        Red Hat Software Collections (for RHEL Workstation)
                        Red Hat Virtualization
   SKU:                 SKU-Number
   Contract:            Contract-Number
   Pool ID:             Valid-Pool-Number-123456
   Provides Management: Yes
   Available:           1
   Suggested:           1
   Service Level:       Support-level
   Service Type:        Service-Type
   Subscription Type:   Sub-type
   Ends:                End-date
   System Type:         Physical

10. 找到 Pool ID 值并附加 Red Hat OpenStack Platform 16.2 权利：

    [stack@minion ~]$ sudo subscription-manager attach --pool=Valid-Pool-Number-123456

11. 禁用所有默认的仓库，然后启用 Red Hat Enterprise Linux 仓库：

    [stack@minion ~]$ sudo subscription-manager repos --disable=*
    [stack@minion ~]$ sudo subscription-manager repos --enable=rhel-8-for-x86_64-baseos-eus-rpms --enable=rhel-8-for-x86_64-appstream-eus-rpms --enable=rhel-8-for-x86_64-highavailability-eus-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

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

12. 在系统上执行更新，确保您有最新的基本系统软件包：

    [stack@minion ~]$ sudo dnf update -y
    [stack@minion ~]$ sudo reboot

13. 安装用于安装和配置 minion 的命令行工具：

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

步骤

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

2. 将 undercloud 中的文件复制到 minion：

   $ scp ~/tripleo-undercloud-outputs.yaml ~/tripleo-undercloud-passwords.yaml stack@<minion-host>:~/.

   • 将 <minion-host> 替换为 minion 的主机名或 IP 地址。

步骤

1. 以 root 用户身份登录到 minion 主机。

2. 将证书颁发机构文件从 undercloud 复制到 minion：

   [root@minion ~]# scp \
       root@<undercloud-host>:/etc/pki/ca-trust/source/anchors/cm-local-ca.pem \
       /etc/pki/ca-trust/source/anchors/undercloud-ca.pem

   • 将 <undercloud-host> 替换为 undercloud 的主机名或 IP 地址。

3. 为 minion 主机更新可信证书颁发机构：

   [root@minion ~]# update-ca-trust enable
   [root@minion ~]# update-ca-trust extract

步骤

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

2. 将默认模板复制到 stack 用户的主目录：

   [stack@minion ~]$ cp \
     /usr/share/python-tripleoclient/minion.conf.sample \
     ~/minion.conf

3. 编辑 minion.conf 文件。这个文件包含用于配置 minion 的设置。如果忽略或注释掉某个参数，minion 安装将使用默认值。查看以下推荐参数：

   • minion_hostname，将其设置为 minion 的主机名。
   • minion_local_interface，将其设置为通过置备网络连接到 undercloud 的接口。
   • minion_local_ip，将其设置为置备网络上的空闲 IP 地址。
   • minion_nameservers，将其设置为 DNS 名称服务器以便 minion 可以解析主机名。
   • enable_ironic_conductor，定义是否启用 ironic-conductor 服务。
   • enable_heat_engine，定义是否启用 heat-engine 服务。

步骤

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

2. 运行以下命令来安装 minion：

   [stack@minion ~]$ openstack undercloud minion install

   该命令启动 minion 的配置脚本，安装附加软件包并根据 minion.conf 文件中的配置来配置 minion 服务。这个脚本会需要一些时间来完成。

步骤

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

2. Source stackrc 文件：

   [stack@director ~]$ source ~/stackrc

3. 如果您在 minion 上启用了 heat engine 服务，请验证 minion 中的 heat-engine 服务会出现在 undercloud 服务列表中：

   [stack@director ~]$ $ openstack orchestration service list

   命令输出显示一个表，其中包含 undercloud 和所有 minion 的 heat-engine worker。

4. 如果您在 minion 上启用了 ironic-conductor 服务，请验证 minion 中的 ironic-conductor 服务出现在 undercloud 服务列表中：

   [stack@director ~]$ $ openstack baremetal conductor list

   命令输出显示一个表，其中包含 undercloud 和所有 minion 的 ironic-conductor 服务。

流程

1. 创建名为 nodes.json 或 nodes.yaml 的模板，它将列出您的节点。使用以下 JSON 和 YAML 模板示例了解如何创建节点定义模板的结构：

   示例 JSON 模板

   {
     "nodes": [{
       "name": "node01",
       "ports": [{
         "address": "aa:aa:aa:aa:aa:aa",
         "physical_network": "ctlplane",
         "local_link_connection": {
           "switch_id": "52:54:00:00:00:00",
           "port_id": "p0"
         }
       }],
       "cpu": "4",
       "memory": "6144",
       "disk": "40",
       "arch": "x86_64",
       "pm_type": "ipmi",
       "pm_user": "admin",
       "pm_password": "p@55w0rd!",
       "pm_addr": "192.168.24.205"
     },
     {
       "name": "node02",
       "ports": [{
         "address": "bb:bb:bb:bb:bb:bb",
         "physical_network": "ctlplane",
         "local_link_connection": {
           "switch_id": "52:54:00:00:00:00",
           "port_id": "p0"
         }
       }],
       "cpu": "4",
       "memory": "6144",
       "disk": "40",
       "arch": "x86_64",
       "pm_type": "ipmi",
       "pm_user": "admin",
       "pm_password": "p@55w0rd!",
       "pm_addr": "192.168.24.206"
     }]
   }

   示例 YAML 模板

   nodes:
     - name: "node01"
       ports:
         - address: "aa:aa:aa:aa:aa:aa"
           physical_network: ctlplane
           local_link_connection:
             switch_id: "52:54:00:00:00:00"
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.205"
     - name: "node02"
       ports:
         - address: "bb:bb:bb:bb:bb:bb"
           physical_network: ctlplane
           local_link_connection:
             switch_id: "52:54:00:00:00:00"
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.206"

   此模板包含以下属性：

   name

   节点的逻辑名称。

   ports

   访问特定 IPMI 设备的端口。您可以定义以下可选端口属性：

   • 地址 ：节点上网络接口的 MAC 地址。对于每个系统的 Provisioning NIC，只使用 MAC 地址。
   • physical_network ：连接到 Provisioning NIC 的物理网络。
   • local_link_connection ：如果您使用 IPv6 置备，且 LLDP 在内省过程中没有正确填充本地链路连接，您必须在 local_link_connection 参数中包含带有 switch_id 和 port_id 字段的虚拟数据。有关如何包含虚拟数据的更多信息，请参阅使用 director 内省来收集裸机节点硬件信息。

   cpu

   节点上的 CPU 数量。（可选）

   memory

   以 MB 为单位的内存大小。（可选）

   disk

   以 GB 为单位的硬盘的大小。（可选）

   arch

   系统架构。 （可选）

   重要

   在构建多架构云时，arch 键是必需的，用于区分使用 x86_64 和 ppc64le 架构的节点。

   pm_type

   要使用的电源管理驱动程序。此示例使用 IPMI 驱动程序 (ipmi)。

   注意

   IPMI 是首选的受支持电源管理驱动程序。有关支持的电源管理类型及其选项的更多信息，请参阅 电源管理驱动程序。如果这些电源管理驱动程序不能正常工作，请将 IPMI 用于电源管理。

   pm_user; pm_password

   IPMI 的用户名和密码。

   pm_addr

   IPMI 设备的 IP 地址。

2. 创建模板后，运行以下命令验证格式和语法：

   $ source ~/stackrc
   (undercloud)$ openstack overcloud node import --validate-only ~/nodes.json

   重要

   您还必须为多架构节点包含 --http-boot /var/lib/ironic/tftpboot/ 选项。

3. 将文件保存到 stack 用户的主目录(/home/stack/nodes.json)。

4. 将模板导入到 director，将每个节点从模板注册到 director：

   (undercloud)$ openstack overcloud node import ~/nodes.json

   注意

   如果使用 UEFI 引导模式，还必须在每个节点上设置引导模式。如果您在不设置 UEFI 引导模式的情况下内省节点，节点以旧模式引导。如需更多信息，请参阅将引导模式设置为 UEFI 引导模式。

5. 等待节点完成注册和配置。完成后，确认 director 已成功注册节点：

   (undercloud)$ openstack baremetal node list

步骤

1. 为了通过添加标签把节点标记为特定的配置集，把 profile 选项添加到每个节点的 properties/capabilities 参数中。例如，要标记特定节点以使用特定配置集，请使用以下命令：

   (undercloud) $ NODE=<NODE NAME OR ID>
   (undercloud) $ PROFILE=<PROFILE NAME>
   (undercloud) $ openstack baremetal node set --property capabilities="profile:$PROFILE,boot_option:local" $NODE

   • 将 $NODE 变量设置为节点的名称或 UUID。
   • 将 $PROFILE 变量设置为特定的配置集，如 control 或 compute。
   • properties/capabilities 中的 profile 选项包含 $PROFILE 变量，用于使用对应的配置集标记节点，如 profile:control 或 profile:compute。
   • 设置 boot_option:local 选项，以定义每个节点的引导方式。

   您还可以使用额外的 openstack baremetal node show 命令和 jq 筛选来保留现有 capabilities 值：

   (undercloud) $ openstack baremetal node set --property capabilities="profile:$PROFILE,boot_option:local,$(openstack baremetal node show $NODE -f json -c properties | jq -r .properties.capabilities | sed "s/boot_mode:[^,]*,//g")" $NODE

2. 在标记完节点后，检查分配的配置集或可能的配置集：

   (undercloud) $ openstack overcloud profiles list

流程

1. 在 undercloud.conf 文件中设置下列参数：

   ipxe_enabled = True

2. 保存 undercloud.conf 文件并运行 undercloud 安装：

   $ openstack undercloud install

   等待安装脚本完成。

3. 检查每个注册的节点的现有功能：

   $ openstack baremetal node show <node> -f json -c properties | jq -r .properties.capabilities

   • 将 <node> 替换为裸机节点的 ID。

4. 通过将 boot_mode:uefi 添加到节点的现有容量中，将每个注册节点的引导模式设置为 uefi：

   $ openstack baremetal node set --property capabilities="boot_mode:uefi,<capability_1>,...,<capability_n>" <node>

   • 将 <node> 替换为裸机节点的 ID。

   • 将 <capability_1& gt; 以及所有功能（直到 <capability_n >）替换为您在第 3 步中获得的每个功能。

     例如，使用以下命令将引导模式设置为带有本地引导的 uefi ：

   $ openstack baremetal node set --property capabilities="boot_mode:uefi,boot_option:local" <node>

5. 将每个裸机类型的引导模式设置为 uefi ：

   $ openstack flavor set --property capabilities:boot_mode='uefi' <flavor>

流程

1. 将 Bare Metal 服务 (ironic) 引导接口设置为 redfish-virtual-media：

   $ openstack baremetal node set --boot-interface redfish-virtual-media $NODE_NAME

   • 将 $NODE_NAME 替换为节点的名称。

2. 对于 UEFI 节点，将引导模式设置为 uefi：

   NODE=<NODE NAME OR ID> ; openstack baremetal node set --property capabilities="boot_mode:uefi,$(openstack baremetal node show $NODE -f json -c properties | jq -r .properties.capabilities | sed "s/boot_mode:[^,]*,//g")" $NODE

   • 将 $NODE 替换为节点的名称。

     注意

     对于 BIOS 节点，请不要完成此步骤。

3. 对于 UEFI 节点，定义 EFI 系统分区 (ESP) 镜像：

   $ openstack baremetal node set --driver-info bootloader=$ESP $NODE_NAME

   • 将 $ESP 替换为 glance 镜像 UUID 或 ESP 镜像的 URL，并将 $NODE_NAME 替换为节点的名称。

     注意

     对于 BIOS 节点，请不要完成此步骤。

4. 在裸机节点上创建一个端口，并将端口与裸机节点上 NIC 的 MAC 地址关联：

   $ openstack baremetal port create --pxe-enabled True --node $UUID $MAC_ADDRESS

   • 将 $UUID 替换为裸机节点的 UUID，并将 $MAC_ADDRESS 替换为裸机节点上 NIC 的 MAC 地址。

流程

1. 验证每个节点的硬件内省的磁盘信息。以下命令显示节点的磁盘信息：

   (undercloud)$ openstack baremetal introspection data save 1a4e30da-b6dc-499d-ba87-0bd8a3819bc0 | jq ".inventory.disks"

   例如，一个节点的数据可能会显示 3 个磁盘：

   [
     {
       "size": 299439751168,
       "rotational": true,
       "vendor": "DELL",
       "name": "/dev/sda",
       "wwn_vendor_extension": "0x1ea4dcc412a9632b",
       "wwn_with_extension": "0x61866da04f3807001ea4dcc412a9632b",
       "model": "PERC H330 Mini",
       "wwn": "0x61866da04f380700",
       "serial": "61866da04f3807001ea4dcc412a9632b"
     }
     {
       "size": 299439751168,
       "rotational": true,
       "vendor": "DELL",
       "name": "/dev/sdb",
       "wwn_vendor_extension": "0x1ea4e13c12e36ad6",
       "wwn_with_extension": "0x61866da04f380d001ea4e13c12e36ad6",
       "model": "PERC H330 Mini",
       "wwn": "0x61866da04f380d00",
       "serial": "61866da04f380d001ea4e13c12e36ad6"
     }
     {
       "size": 299439751168,
       "rotational": true,
       "vendor": "DELL",
       "name": "/dev/sdc",
       "wwn_vendor_extension": "0x1ea4e31e121cfb45",
       "wwn_with_extension": "0x61866da04f37fc001ea4e31e121cfb45",
       "model": "PERC H330 Mini",
       "wwn": "0x61866da04f37fc00",
       "serial": "61866da04f37fc001ea4e31e121cfb45"
     }
   ]

2. 在 undercloud 上，为节点设置根磁盘。包括用于定义根磁盘的最合适的硬件属性值。

   (undercloud)$ openstack baremetal node set --property root_device='{"serial":"<serial_number>"}' <node-uuid>

   例如：要将根设备设定为磁盘 2，其序列号为 61866da04f380d001ea4e13c12e36ad6，输入以下命令：

   (undercloud)$ openstack baremetal node set --property root_device='{"serial": "61866da04f380d001ea4e13c12e36ad6"}' 1a4e30da-b6dc-499d-ba87-0bd8a3819bc0

   注意

   将每个节点的 BIOS 配置为从您选择的根磁盘引导。将引导顺序配置为首先从网络引导，然后从根磁盘引导。

步骤

1. 要配置 director 使用 overcloud-minimal 镜像，创建包含以下镜像定义的环境文件：

   parameter_defaults:
     <roleName>Image: overcloud-minimal

2. 将 <roleName> 替换为角色的名称，并将 Image 加到角色名称的后面。以下示例显示了 Ceph 存储节点的 overcloud-minimal 镜像：

   parameter_defaults:
     CephStorageImage: overcloud-minimal

3. 在 roles_data.yaml 角色定义文件中，将 rhsm_enforce 参数设置为 False。

   rhsm_enforce: False

4. 将环境文件传递给 openstack overcloud deploy 命令。

步骤

1. 在 /home/stack/templates/ 目录中创建 node-info.yaml 文件：

   (undercloud) $ touch /home/stack/templates/node-info.yaml

2. 编辑这个文件，使其包含您需要的节点数目和类型。此示例包含 3 个 Controller 节点和 3 个 Compute 节点：

   parameter_defaults:
     OvercloudControllerFlavor: control
     OvercloudComputeFlavor: compute
     ControllerCount: 3
     ComputeCount: 3

步骤

1. 打开证书文件，仅复制证书部分。不要包括其密钥：

   $ vi /home/stack/ca.crt.pem

   您需要的证书部分与下方简写的示例类似：

   -----BEGIN CERTIFICATE-----
   MIIDlTCCAn2gAwIBAgIJAOnPtx2hHEhrMA0GCSqGSIb3DQEBCwUAMGExCzAJBgNV
   BAYTAlVTMQswCQYDVQQIDAJOQzEQMA4GA1UEBwwHUmFsZWlnaDEQMA4GA1UECgwH
   UmVkIEhhdDELMAkGA1UECwwCUUUxFDASBgNVBAMMCzE5Mi4xNjguMC4yMB4XDTE3
   -----END CERTIFICATE-----

2. 创建一个名为 /home/stack/inject-trust-anchor-hiera.yaml 的 YAML 文件，其包含下列内容以及您从 PEM 文件复制而来的证书：

   parameter_defaults:
     CAMap:
       undercloud-ca:
         content: |
           -----BEGIN CERTIFICATE-----
           MIIDlTCCAn2gAwIBAgIJAOnPtx2hHEhrMA0GCSqGSIb3DQEBCwUAMGExCzAJBgNV
           BAYTAlVTMQswCQYDVQQIDAJOQzEQMA4GA1UEBwwHUmFsZWlnaDEQMA4GA1UECgwH
           UmVkIEhhdDELMAkGA1UECwwCUUUxFDASBgNVBAMMCzE5Mi4xNjguMC4yMB4XDTE3
           -----END CERTIFICATE-----

1. 修改定制环境文件和 heat 模板中的参数。
2. 使用相同的环境文件再次运行 openstack overcloud deploy 命令

步骤

1. source stackrc 文件：

   $ source ~/stackrc

2. 此验证需要 overcloud 计划的副本。使用所有必要的环境文件上传 overcloud 计划。如果仅上传您的计划，请使用 --update-plan-only 选项运行 openstack overcloud deploy 命令：

   $ openstack overcloud deploy --templates \
       -e environment-file1.yaml \
       -e environment-file2.yaml \
       ...
       --update-plan-only

3. 使用 --group pre-deployment 选项 运行 openstack tripleo validator run 命令：

   $ openstack tripleo validator run --group pre-deployment

4. 如果 overcloud 使用与默认 overcloud 名称不同的计划名称，请使用 --plan 选项来设置计划名称：

   $ openstack tripleo validator run --group pre-deployment \
       --plan myovercloud

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

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

步骤

1. source stackrc 文件：

   $ source ~/stackrc

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

   $ openstack tripleo validator run --group post-deployment

3. 如果 overcloud 使用与默认 overcloud 名称不同的计划名称，请使用 --plan 选项来设置计划名称：

   $ openstack tripleo validator run --group post-deployment \
       --plan myovercloud

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

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

流程

1. 创建名为 nodes.json 或 nodes.yaml 的模板，它将列出您的节点。使用以下 JSON 和 YAML 模板示例了解如何创建节点定义模板的结构：

   示例 JSON 模板

   {
     "nodes": [{
       "name": "node01",
       "ports": [{
         "address": "aa:aa:aa:aa:aa:aa",
         "physical_network": "ctlplane",
         "local_link_connection": {
           "switch_id": "52:54:00:00:00:00",
           "port_id": "p0"
         }
       }],
       "cpu": "4",
       "memory": "6144",
       "disk": "40",
       "arch": "x86_64",
       "pm_type": "ipmi",
       "pm_user": "admin",
       "pm_password": "p@55w0rd!",
       "pm_addr": "192.168.24.205"
     },
     {
       "name": "node02",
       "ports": [{
         "address": "bb:bb:bb:bb:bb:bb",
         "physical_network": "ctlplane",
         "local_link_connection": {
           "switch_id": "52:54:00:00:00:00",
           "port_id": "p0"
         }
       }],
       "cpu": "4",
       "memory": "6144",
       "disk": "40",
       "arch": "x86_64",
       "pm_type": "ipmi",
       "pm_user": "admin",
       "pm_password": "p@55w0rd!",
       "pm_addr": "192.168.24.206"
     }]
   }

   示例 YAML 模板

   nodes:
     - name: "node01"
       ports:
         - address: "aa:aa:aa:aa:aa:aa"
           physical_network: ctlplane
           local_link_connection:
             switch_id: "52:54:00:00:00:00"
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.205"
     - name: "node02"
       ports:
         - address: "bb:bb:bb:bb:bb:bb"
           physical_network: ctlplane
           local_link_connection:
             switch_id: "52:54:00:00:00:00"
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.206"

   此模板包含以下属性：

   name

   节点的逻辑名称。

   ports

   访问特定 IPMI 设备的端口。您可以定义以下可选端口属性：

   • 地址 ：节点上网络接口的 MAC 地址。对于每个系统的 Provisioning NIC，只使用 MAC 地址。
   • physical_network ：连接到 Provisioning NIC 的物理网络。
   • local_link_connection ：如果您使用 IPv6 置备，且 LLDP 在内省过程中没有正确填充本地链路连接，您必须在 local_link_connection 参数中包含带有 switch_id 和 port_id 字段的虚拟数据。有关如何包含虚拟数据的更多信息，请参阅使用 director 内省来收集裸机节点硬件信息。

   cpu

   节点上的 CPU 数量。（可选）

   memory

   以 MB 为单位的内存大小。（可选）

   disk

   以 GB 为单位的硬盘的大小。（可选）

   arch

   系统架构。 （可选）

   重要

   在构建多架构云时，arch 键是必需的，用于区分使用 x86_64 和 ppc64le 架构的节点。

   pm_type

   要使用的电源管理驱动程序。此示例使用 IPMI 驱动程序 (ipmi)。

   注意

   IPMI 是首选的受支持电源管理驱动程序。有关支持的电源管理类型及其选项的更多信息，请参阅 电源管理驱动程序。如果这些电源管理驱动程序不能正常工作，请将 IPMI 用于电源管理。

   pm_user; pm_password

   IPMI 的用户名和密码。

   pm_addr

   IPMI 设备的 IP 地址。

2. 创建模板后，运行以下命令验证格式和语法：

   $ source ~/stackrc
   (undercloud)$ openstack overcloud node import --validate-only ~/nodes.json

   重要

   您还必须为多架构节点包含 --http-boot /var/lib/ironic/tftpboot/ 选项。

3. 将文件保存到 stack 用户的主目录(/home/stack/nodes.json)。

4. 将模板导入到 director，将每个节点从模板注册到 director：

   (undercloud)$ openstack overcloud node import ~/nodes.json

   注意

   如果使用 UEFI 引导模式，还必须在每个节点上设置引导模式。如果您在不设置 UEFI 引导模式的情况下内省节点，节点以旧模式引导。如需更多信息，请参阅将引导模式设置为 UEFI 引导模式。

5. 等待节点完成注册和配置。完成后，确认 director 已成功注册节点：

   (undercloud)$ openstack baremetal node list

流程

1. 查找 stackrc undercloud 凭据文件：

   $ source ~/stackrc

2. 创建新的 ~/overcloud-baremetal-deploy.yaml 文件，并为您要置备的每个角色定义节点数。例如，要置备三个 Controller 节点和三个 Compute 节点，请使用以下语法：

   - name: Controller
     count: 3
   - name: Compute
     count: 3

3. 在 ~/overcloud-baremetal-deploy.yaml 文件中，定义您要分配给节点的任何预先节点放置、自定义 NIC 或其他属性。例如，使用以下示例语法在节点 node00、node01 和 node02 上置备三个 Controller 节点，在 node04、node05 和 node06上置备三个 Compute 节点：

   - name: Controller
     count: 3
     instances:
     - hostname: overcloud-controller-0
       name: node00
     - hostname: overcloud-controller-1
       name: node01
     - hostname: overcloud-controller-2
       name: node02
   - name: Compute
     count: 3
     instances:
     - hostname: overcloud-novacompute-0
       name: node04
     - hostname: overcloud-novacompute-1
       name: node05
     - hostname: overcloud-novacompute-2
       name: node06

   您还可以用 defaults 参数覆盖默认参数值，以避免为每个节点条目手动定义节点：

   - name: Controller
     count: 3
     defaults:
       nics:
         network: custom-network
         subnet: custom-subnet
     instances:
     - hostname: overcloud-controller-0
       name: node00
     ...

   有关您可以在节点定义文件中使用的参数、属性和值的更多信息，请参阅 裸机节点置备属性。

4. 可选： 默认情况下，置备过程使用 overcloud-full 镜像。您可以使用 image 属性定义自定义镜像，以用于角色的所有节点，或用于特定的节点实例：

   - name: Controller
     count: 3
     instances:
     - hostname: overcloud-controller-0
       name: node00
       image:
         href: overcloud-custom

   注意

   具有大于 2 TiB 的根(/)分区的裸机节点需要使用整个磁盘镜像。有关完整磁盘镜像的更多信息，请参阅创建整个磁盘镜像。

5. 运行置备命令，指定 ~/overcloud-baremetal-deploy.yaml 文件，并使用 --output 选项定义输出文件：

   (undercloud)$ openstack overcloud node provision \
   --stack stack \
   --output ~/overcloud-baremetal-deployed.yaml \
   ~/overcloud-baremetal-deploy.yaml

   置备过程会生成一个 heat 环境文件，其名称是您在 --output 选项中指定的名称。此文件包含节点定义。当您部署 overcloud 时，请将此文件包括在部署命令中。

6. 在一个单独的终端中对节点进行监控以验证它们是否成功置备。置备过程将节点状态从 available 改为 active：

   (undercloud)$ watch openstack baremetal node list

   使用 metalsmith 工具获取节点的统一视图，包括分配和 neutron 端口：

   (undercloud)$ metalsmith list

   您还可以使用 openstack baremetal allocation 命令来验证节点与主机名的关联：

   (undercloud)$ openstack baremetal allocation list

流程

1. 查找 stackrc undercloud 凭据文件：

   $ source ~/stackrc

2. 编辑用于置备裸机节点的 ~/overcloud-baremetal-deploy.yaml 文件，并为您要扩展的角色增加 count 参数。例如，如果 overcloud 包含三个计算节点，请使用以下内容将 Compute 节点数增加到 10：

   - name: Controller
     count: 3
   - name: Compute
     count: 10

   您还可以在 instances 参数中添加预先节点放置。有关可用参数和属性的更多信息，请参阅裸机节点置备属性。

3. 运行置备命令，指定 ~/overcloud-baremetal-deploy.yaml 文件，并使用 --output 选项定义输出文件：

   (undercloud)$ openstack overcloud node provision \
   --stack stack \
   --output ~/overcloud-baremetal-deployed.yaml \
   ~/overcloud-baremetal-deploy.yaml

4. 使用 openstack baremetal node list 命令监控置备进度。

5. 部署 overcloud，包括置备命令生成的 ~/overcloud-baremetal-deployed.yaml 文件，以及其他与部署相关的环境文件：

   (undercloud)$ openstack overcloud deploy \
     ...
     -e /usr/share/openstack-tripleo-heat-templates/environments/deployed-server-environment.yaml \
     -e ~/overcloud-baremetal-deployed.yaml \
     --deployed-server \
     --disable-validations \
     ...

步骤

1. 查找 stackrc undercloud 凭据文件：

   $ source ~/stackrc

2. 编辑用于置备裸机节点的 ~/overcloud-baremetal-deploy.yaml 文件，并减少您要缩减的角色的 count 参数。还必须为要从堆栈中删除的每个节点定义以下属性：

   • 节点的名称。
   • 与节点关联的主机名。

   • 属性 provisioned: false

     例如，要从堆栈中删除节点 overcloud-controller-1，请在 ~/overcloud-baremetal-deploy.yaml 文件中包括以下内容：

     - name: Controller
       count: 2
       instances:
       - hostname: overcloud-controller-0
         name: node00
       - hostname: overcloud-controller-1
         name: node01
         # Removed from cluster due to disk failure
         provisioned: false
       - hostname: overcloud-controller-2
         name: node02

3. 运行置备命令，指定 ~/overcloud-baremetal-deploy.yaml 文件，并使用 --output 选项定义输出文件：

   (undercloud)$ openstack overcloud node provision \
   --stack stack \
   --output ~/overcloud-baremetal-deployed.yaml \
   ~/overcloud-baremetal-deploy.yaml

4. 重新部署 overcloud，并包含置备命令生成的 ~/overcloud-baremetal-deployed.yaml 文件，以及与部署相关的任何其他环境文件：

   (undercloud)$ openstack overcloud deploy \
     ...
     -e /usr/share/openstack-tripleo-heat-templates/environments/deployed-server-environment.yaml \
     -e ~/overcloud-baremetal-deployed.yaml \
     --deployed-server \
     --disable-validations \
     ...

   重新部署 overcloud 后，堆栈中不再存在使用 provisioned: false 属性定义的节点。但是，这些节点仍然以置备状态运行。

   注意

   如果要临时从堆栈中删除节点，您可以使用 provisioned: false 属性部署 overcloud，然后使用 provisioned: true 属性重新部署 overcloud，以将节点返回到堆栈。

5. 运行 openstack overcloud node delete 命令，包括带有 --baremetal-deployment 选项的 ~/overcloud-baremetal-deploy.yaml 文件。

   (undercloud)$ openstack overcloud node delete \
   --stack stack \
   --baremetal-deployment ~/overcloud-baremetal-deploy.yaml

   注意

   不要将您要从堆栈中删除的节点作为命令参数包括在 openstack overcloud node delete 命令中。

步骤

1. 在每个 overcloud 节点上，创建 stack 用户并设定密码。例如，在 Controller 节点上运行以下命令：

   [root@controller-0 ~]# useradd stack
   [root@controller-0 ~]# passwd stack  # specify a password

2. 进行以下操作以使这个用户使用 sudo 时不需要输入密码：

   [root@controller-0 ~]# echo "stack ALL=(root) NOPASSWD:ALL" | tee -a /etc/sudoers.d/stack
   [root@controller-0 ~]# chmod 0440 /etc/sudoers.d/stack

3. 在所有预置备节点上创建并配置 stack 用户后，将 stack 用户的公共 SSH 密钥从 director 节点复制到每个 overcloud 节点。例如，要将 director 的公共 SSH 密钥复制到 Controller 节点，请运行以下命令：

   [stack@director ~]$ ssh-copy-id stack@192.168.24.2

步骤

1. 运行注册命令，按照提示输入您的客户门户用户名和密码：

   [heat-admin@controller-0 ~]$ sudo subscription-manager register

2. 查找 Red Hat OpenStack Platform 16.2 的权利池：

   [heat-admin@controller-0 ~]$ sudo subscription-manager list --available \
    --all --matches="Red Hat OpenStack"

3. 使用上一步中的池 ID 以附加 Red Hat OpenStack Platform 16 权利：

   [heat-admin@controller-0 ~]$ sudo subscription-manager attach --pool=pool_id

4. 禁用所有默认软件仓库：

   [heat-admin@controller-0 ~]$ sudo subscription-manager repos --disable=*

5. 启用所需的 Red Hat Enterprise Linux 软件仓库。

   • 对于 x86_64 系统：

     [heat-admin@controller-0 ~]$ sudo subscription-manager repos \
      --enable=rhel-8-for-x86_64-baseos-eus-rpms \
      --enable=rhel-8-for-x86_64-appstream-eus-rpms \
      --enable=rhel-8-for-x86_64-highavailability-eus-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

   • 对于 POWER 系统：

     [heat-admin@controller-0 ~]$ sudo subscription-manager repos \
      --enable=rhel-8-for-ppc64le-baseos-rpms \
      --enable=rhel-8-for-ppc64le-appstream-rpms \
      --enable=rhel-8-for-ppc64le-highavailability-rpms \
      --enable=ansible-2.8-for-rhel-8-ppc64le-rpms \
      --enable=openstack-16-for-rhel-8-ppc64le-rpms \
      --enable=fast-datapath-for-rhel-8-ppc64le-rpms

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

   [heat-admin@controller-0 ~]$ sudo dnf module disable -y container-tools:rhel8
   [heat-admin@controller-0 ~]$ sudo dnf module enable -y container-tools:3.0

7. 如果 overcloud 使用 Ceph Storage 节点，请启用相关的 Ceph Storage 软件仓库：

   [heat-admin@cephstorage-0 ~]$ sudo subscription-manager repos \
    --enable=rhel-8-for-x86_64-baseos-rpms \
    --enable=rhel-8-for-x86_64-appstream-rpms \
    --enable=ansible-2.9-for-rhel-8-x86_64-rpms \
    --enable=openstack-16.2-deployment-tools-for-rhel-8-x86_64-rpms

8. 锁定除 Red Hat Ceph Storage 节点外的所有 overcloud 节点上的 RHEL 版本：

   [heat-admin@controller-0 ~]$ sudo subscription-manager release --set=8.4

9. 更新您的系统，确保您具备最新的基础系统软件包：

   [heat-admin@controller-0 ~]$ sudo dnf update -y
   [heat-admin@controller-0 ~]$ sudo reboot

步骤

1. 将证书授权机构文件复制到各预置备节点上的 /etc/pki/ca-trust/source/anchors/ 目录中。

2. 在每个 overcloud 节点上运行以下命令：

   [root@controller-0 ~]#  sudo update-ca-trust extract

1. 分配名称，其格式为 <node_hostname>-<network>，其中 <node_hostname> 值与节点的短主机名匹配，<network> 与网络的小写名称匹配。例如：controller-0-ctlplane 用于 controller-0.example.com，compute-0-ctlplane 用于 compute-0.example.com。

2. IP 分配，它采用以下参数形式：

   • fixed_ips/ip_address - 为 control plane 指定固定的 IP 地址。使用 ip_address 列表中的多个参数来定义多个 IP 地址。
   • subnets/cidr - 定义子网的 CIDR 值。

步骤

1. 创建环境文件，例如 hostname-map.yaml，并包括 HostnameMap 参数和主机名映射。请遵循以下语法：

   parameter_defaults:
     HostnameMap:
       [HEAT HOSTNAME]: [ACTUAL HOSTNAME]
       [HEAT HOSTNAME]: [ACTUAL HOSTNAME]

   [HEAT HOSTNAME] 通常符合以下惯例：[STACK NAME]-[ROLE]-[INDEX]：

   parameter_defaults:
     HostnameMap:
       overcloud-controller-0: controller-00-rack01
       overcloud-controller-1: controller-01-rack02
       overcloud-controller-2: controller-02-rack03
       overcloud-novacompute-0: compute-00-rack01
       overcloud-novacompute-1: compute-01-rack01
       overcloud-novacompute-2: compute-02-rack01

2. 保存 hostname-map.yaml 文件。

1. 在 undercloud 主机上，创建环境变量 OVERCLOUD_HOSTS，并将该变量设置为您要用作 Ceph 客户端的 overcloud 主机的 IP 地址列表（以空格分隔）：

   export OVERCLOUD_HOSTS="192.168.1.8 192.168.1.42"

2. 默认的 overcloud 计划名称是 overcloud。如果使用其他名称，请创建一个环境变量 OVERCLOUD_PLAN 来存储您的自定义名称：

   export OVERCLOUD_PLAN="<custom-stack-name>"

   • 将 <custom-stack-name> 替换为堆栈的名称。

3. 运行 enable-ssh-admin.sh 脚本，以在 Ansible 可用于配置 Ceph 客户端的 overcloud 节点上配置用户：

   bash /usr/share/openstack-tripleo-heat-templates/deployed-server/scripts/enable-ssh-admin.sh

1. 根据 第 9.1 节 “预置备节点要求” 准备新的预置备节点。
2. 扩展节点。更多信息请参阅 第 16 章 扩展 overcloud 节点。
3. 在执行部署命令后，等待 director 创建新的节点资源并启动配置。

1. 找出您要删除的节点的名称。

   $ openstack stack resource list overcloud -n5 --filter type=OS::TripleO::ComputeDeployedServerServer

2. 将 stack_name 列中对应的节点名称传递给 openstack overcloud node delete 命令：

   $ openstack overcloud node delete --stack <overcloud> <stack>

   • 将 <overcloud> 替换为 overcloud 堆栈的名称或 UUID。
   • 将 &lt ;stack_name > 替换为您要删除的节点的名称。您可以在 openstack overcloud node delete 命令中包含多个节点名称。

3. 确保 openstack overcloud node delete 命令已运行完：

   $ openstack stack list

   当删除操作完成后，overcloud 堆栈的状态会显示 UPDATE_COMPLETE。

步骤

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

2. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

3. 为您想部署的额外 overcloud 创建新目录：

   (undercloud)$ mkdir ~/overcloud-two

4. 将 network_data.yaml 文件从现有 overcloud 复制到额外 overcloud 的新目录中：

   (undercloud)$ cp network_data.yaml ~/overcloud-two/network_data.yaml

5. 打开 ~/overcloud-two/network_data.yaml 文件，并将 name_lower 更新至额外 overcloud 网络的唯一名称：

   - name: InternalApi
     name_lower: internal_api_cloud_2
     ...

6. 添加 service_net_map_replace （如果不存在），并将值设为额外 overcloud 网络的默认值：

   - name: InternalApi
     name_lower: internal_api_cloud_2
     service_net_map_replace: internal_api

7. 指定额外 overcloud 上每个子网的 VLAN ID：

   - name: InternalApi
     ...
     vip: true
     vlan: 21
     ip_subnet: '172.21.0.0/24'
     allocation_pools: [{'start': '172.21.0.4', 'end': '172.21.0.250'}]
     ipv6_subnet: 'fd00:fd00:fd00:2001::/64'
     ipv6_allocation_pools: [{'start': 'fd00:fd00:fd00:2001::10', 'end': 'fd00:fd00:fd00:2001:ffff:ffff:ffff:fffe'}]
     mtu: 1500
   - name: Storage
     ...

8. 指定 overcloud-two 外部网络网关的 IP 地址：

   - name: External
     ...
     gateway_ip: <ip_address>
     ...

   • 将 <ip_address > 替换为 overcloud-two 外部网络网关的 IP 地址，例如 10.0.10.1。
9. 为额外 overcloud 创建网络配置文件，该文件会覆盖 /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml 文件中提供的默认隔离网络配置，如 network_overrides.yaml。

10. 打开 ~/overcloud-two/network_overrides.yaml 文件，并添加 overcloud-two DNS 服务器的 IP 地址：

    parameter_defaults:
      ...
      DnsServers:
        - <ip_address>
      ...

    • 将 <ip_address > 替换为 overcloud-two DNS 服务器的 IP 地址，例如 10.0.10.2。

11. 如果您的部署使用可预测的 IP 地址，请在新的网络 IP 地址映射文件 ips-from-pool- overcloud-two.yaml 中为 overcloud-two 节点配置 IP 地址：

    parameter_defaults:
      ControllerIPs:
      ...
        internal_api_cloud_2:
        - 192.168.1.10
        - 192.168.1.11
        - 192.168.1.12
        ...
        external_cloud_2:
        - 10.0.1.41
        ...

12. 使用其他环境文件将 overcloud-two 环境文件添加到堆栈中，并部署额外的 overcloud：

    (undercloud)$ openstack overcloud deploy --templates \
      --stack overcloud-two \
      -n ~/overcloud-two/network_data.yaml \
      -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
      -e /usr/share/openstack-tripleo-heat-templates/environments/network-environment.yaml \
      -e /usr/share/openstack-tripleo-heat-templates/environments/net-single-nic-with-vlans.yaml \
      -e ~/overcloud-two/network_overrides.yaml \
      -e [your environment files] \
      ...

    部署过程创建 overcloud-tworc，用于与 overcloud-two 交互。

13. 要与其他 overcloud 交互，请提供 overcloud 凭证文件：

    $ source overcloud-tworc

步骤

1. Source stackrc 文件：

   $ source ~/stackrc

2. 运行部署状态命令：

   $ openstack overcloud status

   此命令的输出显示 overcloud 的状态：

   +-----------+---------------------+---------------------+-------------------+
   | Plan Name |       Created       |       Updated       | Deployment Status |
   +-----------+---------------------+---------------------+-------------------+
   | overcloud | 2018-05-03 21:24:50 | 2018-05-03 21:27:59 |   DEPLOY_SUCCESS  |
   +-----------+---------------------+---------------------+-------------------+

   如果您的 overcloud 使用其他名称，请使用 --plan 参数来选择具有不同名称的 overcloud：

   $ openstack overcloud status --plan my-deployment

步骤

1. 获取 overcloudrc 文件：

   $ source ~/overcloudrc

2. 运行 openstack flavor create 命令以创建类别。使用以下选项指定每种类别的硬件要求：

   --disk

   为虚拟机卷定义硬盘空间。

   --ram

   定义虚拟机所需的 RAM。

   --vcpus

   定义虚拟机的虚拟 CPU 的数量。

3. 以下示例创建默认 overcloud 类别：

   $ openstack flavor create m1.tiny --ram 512 --disk 0 --vcpus 1
   $ openstack flavor create m1.smaller --ram 1024 --disk 0 --vcpus 1
   $ openstack flavor create m1.small --ram 2048 --disk 10 --vcpus 1
   $ openstack flavor create m1.medium --ram 3072 --disk 10 --vcpus 2
   $ openstack flavor create m1.large --ram 8192 --disk 10 --vcpus 4
   $ openstack flavor create m1.xlarge --ram 8192 --disk 10 --vcpus 8

步骤

1. 获取 overcloudrc 文件：

   $ source ~/overcloudrc

2. 创建默认租户网络：

   (overcloud) $ openstack network create default

3. 在网络中创建一个子网：

   (overcloud) $ openstack subnet create default --network default --gateway 172.20.1.1 --subnet-range 172.20.0.0/16

4. 确认所创建的网络：

   (overcloud) $ openstack network list
   +-----------------------+-------------+--------------------------------------+
   | id                    | name        | subnets                              |
   +-----------------------+-------------+--------------------------------------+
   | 95fadaa1-5dda-4777... | default     | 7e060813-35c5-462c-a56a-1c6f8f4f332f |
   +-----------------------+-------------+--------------------------------------+

步骤

1. 获取 overcloudrc 文件：

   $ source ~/overcloudrc

2. 创建公共网络：

   • 创建扁平网络获取原生 VLAN 连接：

     (overcloud) $ openstack network create public --external --provider-network-type flat --provider-physical-network datacentre

   • 创建 vlan 网络获取非原生 VLAN 连接：

     (overcloud) $ openstack network create public --external --provider-network-type vlan --provider-physical-network datacentre --provider-segment 201

     使用 --provider-segment 选项定义您要使用的 VLAN。在本例中，VLAN 是 201。

3. 使用浮动 IP 地址分配池创建子网。在本示例中，IP 范围为 10.1.1.51 到 10.1.1.250：

   (overcloud) $ openstack subnet create public --network public --dhcp --allocation-pool start=10.1.1.51,end=10.1.1.250 --gateway 10.1.1.1 --subnet-range 10.1.1.0/24

   确保此范围与外部网络中的其他 IP 地址不冲突。

步骤

1. 获取 overcloudrc 文件：

   $ source ~/overcloudrc

2. 创建提供商网络。

   • 创建扁平网络获取原生 VLAN 连接：

     (overcloud) $ openstack network create provider --external --provider-network-type flat --provider-physical-network datacentre --share

   • 创建 vlan 网络获取非原生 VLAN 连接：

     (overcloud) $ openstack network create provider --external --provider-network-type vlan --provider-physical-network datacentre --provider-segment 201 --share

     使用 --provider-segment 选项定义您要使用的 VLAN。在本例中，VLAN 是 201。

   这些示例命令创建共享网络。也可以指定租户而不是指定 --share，这样只有租户才能访问新网络。

   + 如果将提供商网络标记为外部网络，则只有运营商可在该网络上创建端口。

3. 向提供商网络添加一个子网以提供 DHCP 服务：

   (overcloud) $ openstack subnet create provider-subnet --network  provider --dhcp --allocation-pool start=10.9.101.50,end=10.9.101.100 --gateway 10.9.101.254 --subnet-range 10.9.101.0/24

4. 创建一个路由器，使其他网络能够通过提供商网络路由流量：

   (overcloud) $ openstack router create external

5. 将路由器的外部网关设置为提供商网络：

   (overcloud) $ openstack router set --external-gateway provider external

6. 将其他网络添加到该路由器。例如，运行以下命令以将子网 subnet1 附加到路由器上：

   (overcloud) $ openstack router add subnet external subnet1

   此命令将 subnet1 添加到路由表中，并允许使用 subnet1 的虚拟机中的流量路由到提供商网络。

步骤

1. 如果在 undercloud 上运行这个测试，请确保 undercloud 主机能够访问 overcloud 的内部 API 网络。例如，在 undercloud 主机上添加一个临时的 VLAN，用于使用 172.16.0.201/24 地址访问内部 API 网络 (ID: 201)：

   $ source ~/stackrc
   (undercloud) $ sudo ovs-vsctl add-port br-ctlplane vlan201 tag=201 -- set interface vlan201 type=internal
   (undercloud) $ sudo ip l set dev vlan201 up; sudo ip addr add 172.16.0.201/24 dev vlan201

2. 运行集成测试，如 OpenStack Integration Test Suite 指南中所述。

3. 在验证完成后，删除所有到 overcloud 的内部 API 的临时连接。在这个示例中，使用以下命令删除以前在 undercloud 中创建的 VLAN：

   $ source ~/stackrc
   (undercloud) $ sudo ovs-vsctl del-port vlan201

步骤

1. 创建名为 prevent-stack-delete.yaml 的环境文件。

2. 设置 HeatApiPolicies 参数：

   parameter_defaults:
     HeatApiPolicies:
       heat-deny-action:
         key: 'actions:action'
         value: 'rule:deny_everybody'
       heat-protect-overcloud:
         key: 'stacks:delete'
         value: 'rule:deny_everybody'

   重要

   heat-deny-action 是您必须在 undercloud 安装中包含的默认策略。

3. 将 prevent-stack-delete.yaml 环境文件添加到 undercloud.conf 文件中的 custom_env_files 参数：

   custom_env_files = prevent-stack-delete.yaml

4. 运行 undercloud 安装命令以刷新配置：

   $ openstack undercloud install

步骤

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

2. 获取 overcloudrc 文件：

   $ source ~/stackrc

3. 查找要访问的节点的名称：

   (undercloud) $ openstack server list

4. 以 heat-admin 用户身份连接到节点，并使用节点的短主机名：

   (undercloud) $ ssh heat-admin@overcloud-controller-0.ctlplane

步骤

1. 在现有 OpenStack 环境中，通过对一个运行的服务器进行快照并下载镜像来创建一个新镜像：

   $ openstack server image create instance_name --name image_name
   $ openstack image save image_name --file exported_vm.qcow2

2. 将导出的镜像复制到 undercloud 节点：

   $ scp exported_vm.qcow2 stack@192.168.0.2:~/.

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

4. 获取 overcloudrc 文件：

   $ source ~/overcloudrc

5. 将导出的镜像上传到 overcloud 中：

   (overcloud) $ openstack image create imported_image --file exported_vm.qcow2 --disk-format qcow2 --container-format bare

6. 启动新实例：

   (overcloud) $ openstack server create  imported_instance --key-name default --flavor m1.demo --image imported_image --nic net-id=net_id

步骤

1. 要查看动态的节点清单，请在 source stackrc 之后运行 tripleo-ansible-inventory 命令：

   $ source ~/stackrc
   (undercloud) $ tripleo-ansible-inventory --list

   使用 --list 选项返回有关所有主机的详细信息。此命令以 JSON 格式输出动态清单：

   {"overcloud": {"children": ["controller", "compute"], "vars": {"ansible_ssh_user": "heat-admin"}}, "controller": ["192.168.24.2"], "undercloud": {"hosts": ["localhost"], "vars": {"overcloud_horizon_url": "http://192.168.24.4:80/dashboard", "overcloud_admin_password": "abcdefghijklm12345678", "ansible_connection": "local"}}, "compute": ["192.168.24.3"]}

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

   (undercloud) $ ansible [HOSTS] -i /bin/tripleo-ansible-inventory [OTHER OPTIONS]

   • 用您要使用的主机类型替换 [HOSTS]：

     • controller，适用于所有 Controller 节点
     • compute，适用于所有 Compute 节点
     • overcloud，适用于所有 overcloud 子节点。例如， controller 和 compute 节点
     • undercloud，适用于 undercloud
     • "*"，适用于所有节点

   • 用其他 Ansible 选项替换 [OTHER OPTIONS]。

     • 使用 --ssh-extra-args='-o StrictHostKeyChecking=no' 选项跳过主机密钥检查确认操作。
     • 使用 -u [USER] 选项更改执行 Ansible 自动化的 SSH 用户。默认的 overcloud SSH 用户由动态清单中的 ansible_ssh_user 参数自动定义。-u 选项会覆盖此参数。
     • 使用 -m [MODULE] 选项使用特定的 Ansible 模块。默认为 command，用于执行 Linux 命令。
     • 使用 -a [MODULE_ARGS] 选项为选定的模块定义参数。

流程

1. 删除现有的 overcloud：

   $ source ~/stackrc
   (undercloud) $ openstack overcloud delete overcloud

2. 确认 openstack stack list 命令的输出中不再存在 overcloud:

   (undercloud) $ openstack stack list

   删除操作会需要几分钟完成。

3. 在删除操作完成后，请按照部署情景中的标准步骤来重新创建 overcloud。

步骤

1. 使用 setfacl 命令授予 undercloud 上的 stack 用户访问 /var/lib/mistral 目录中文件的权限：

   $ sudo setfacl -R -m u:stack:rwx /var/lib/mistral
   $ sudo chmod -R og-rwx /var/lib/mistral/.ssh

   此命令保留 mistral 用户对该目录的访问权限。

步骤

1. 通过在 config-download 工作目录中执行 less 命令来查看日志。下例使用了 overcloud 工作目录：

   $ less /var/lib/mistral/overcloud/ansible.log

步骤

1. 更改为您的 overcloud 的 config-download 工作目录。在本例中，overcloud 的工作目录的名称是 overcloud：

   $ cd /var/lib/mistral/overcloud

2. 运行 git log 命令，以列出工作目录中的提交。您也可以通过格式化日志输出来显示日期：

   $ git log --format=format:"%h%x09%cd%x09"
   a7e9063 Mon Oct 8 21:17:52 2018 +1000
   dfb9d12 Fri Oct 5 20:23:44 2018 +1000
   d0a910b Wed Oct 3 19:30:16 2018 +1000
   ...

   默认情况下，最近的提交显示在前面。

3. 针对两个提交哈希运行 git diff，以查看部署之间的所有变化：

   $ git diff a7e9063 dfb9d12

步骤

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 运行部署命令。包括 overcloud 所需的任何环境文件：

   $ openstack overcloud deploy \
     --templates \
     -e environment-file1.yaml \
     -e environment-file2.yaml \
     ...

4. 等待部署过程完成。

步骤

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 使用 --stack-only 选项运行部署命令。包括 overcloud 所需的任何环境文件：

   $ openstack overcloud deploy \
     --templates \
     -e environment-file1.yaml \
     -e environment-file2.yaml \
     ...
     --stack-only

4. 等待置备过程完成。

5. 为 tripleo-admin 用户启用从 undercloud 到 overcloud 的 SSH 访问。config-download 进程使用 tripleo-admin 用户来执行基于 Ansible 的配置：

   $ openstack overcloud admin authorize

6. 在节点上执行任何手动预配置任务。如果使用 Ansible 进行配置，请使用 tripleo-admin 用户来访问节点。

7. 使用 --config-download-only 选项运行部署命令。包括 overcloud 所需的环境文件：

   $ openstack overcloud deploy \
     --templates \
     -e environment-file1.yaml \
     -e environment-file2.yaml \
     ...
     --config-download-only

8. 等待配置过程完成。

步骤

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

2. 更改为 Ansible playbook 的目录：

   $ cd /var/lib/mistral/overcloud/

3. 将 /var/lib/mistral/.ssh 目录的所有者更改为 stack 用户。

   $ sudo chown stack. -R /var/lib/mistral/.ssh/

4. 运行 ansible-playbook-command.sh 命令以运行 overcloud 配置：

   $ sudo ./ansible-playbook-command.sh

5. 将 /var/lib/mistral/.ssh 目录的所有者更改为 mistral 用户。这需要确保 mistral_executor 容器中运行的 ansible-playbook 命令成功。

   $ sudo chown 42430:42430 -R /var/lib/mistral/.ssh/

6. 以 mistral 用户身份再次运行该脚本。

   可以将额外的 Ansible 参数传递给该脚本，再将其原封不动地传递给 ansible-playbook 命令。这意味着您可以使用其他 Ansible 功能，如检查模式 (--check)、限制主机 (--limit) 或覆盖变量 (-e)。例如：

   $ ./ansible-playbook-command.sh --limit Controller

   警告

   当 --limit 用于大规模部署时，只有执行中包含的主机才会添加到跨节点的 SSH known_hosts 文件中。因此，一些操作（如实时迁移）可能无法在没有在 known_hosts 文件中的节点间工作。

   注意

   要确保 /etc/hosts 文件在所有节点上都为最新版本，请以 root 用户身份运行以下命令：

   (undercloud)$ sudo -i
   (undercloud)$ cd /var/lib/mistral/overcloud
   (undercloud)$ ANSIBLE_REMOTE_USER="tripleo-admin" ansible allovercloud \
     -i tripleo-ansible-inventory.yaml \
     -m include_role \
     -a name=tripleo-hosts-entries \
     -e @global_vars.yaml

7. 等待配置过程完成。

步骤

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

2. Source stackrc 文件：

   $ source ~/stackrc

3. 使用 --stack-only 选项运行部署命令。包括 overcloud 所需的环境文件：

   $ openstack overcloud deploy \
     --templates \
     -e environment-file1.yaml \
     -e environment-file2.yaml \
     ...
     --stack-only

4. 等待置备过程完成。

5. 为 tripleo-admin 用户启用从 undercloud 到 overcloud 的 SSH 访问。config-download 进程使用 tripleo-admin 用户来执行基于 Ansible 的配置：

   $ openstack overcloud admin authorize

6. 生成 config-download 文件：

   $ openstack overcloud config download \
     --name overcloud \
     --config-dir ~/config-download

   • --name 是要用于 Ansible 文件导出的 overcloud 名称。
   • --config-dir 是要保存 config-download 文件的位置。

7. 切换到包含 config-download 文件的目录：

   $ cd ~/config-download

8. 生成静态清单文件：

   $ tripleo-ansible-inventory \
     --stack <overcloud> \
     --ansible_ssh_user heat-admin \
     --static-yaml-inventory inventory.yaml

   • 用您的 overcloud 的名称替换 <overcloud>。

9. 使用 config-download 文件和静态清单文件执行配置。要执行部署 playbook，请运行 ansible-playbook 命令：

   $ ansible-playbook \
     -i inventory.yaml \
     -e gather_facts=true \
     -e @global_vars.yaml \
     --private-key ~/.ssh/id_rsa \
     --become \
     ~/config-download/deploy_steps_playbook.yaml

10. 等待配置过程完成。

11. 要从该配置手动生成 overcloudrc 文件，请运行以下命令：

    $ openstack action execution run \
      --save-result \
      --run-sync \
      tripleo.deployment.overcloudrc \
      '{"container":"overcloud"}' \
      | jq -r '.["result"]["overcloudrc.v3"]' > overcloudrc.v3

12. 手动将部署状态设置为成功：

    $ openstack workflow execution create tripleo.deployment.v1.set_deployment_status_success '{"plan": "<OVERCLOUD>"}'

    • 用您的 overcloud 的名称替换 <OVERCLOUD>。