第 6 章 使用 CLI 工具配置基本的 overcloud

步骤

1. 创建一个模板来列出您的节点。例如，采用 JSON 格式的模板可能如下方所示：

   {
       "nodes":[
           {
               "mac":[
                   "bb:bb:bb:bb:bb:bb"
               ],
               "name":"node01",
               "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"
           },
           {
               "mac":[
                   "cc:cc:cc:cc:cc:cc"
               ],
               "name":"node02",
               "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"
           }
       ]
   }

   Copy to Clipboard Toggle word wrap

   或者，YAML 格式的类似节点模板可能如下方所示：

   nodes:
     - mac:
         - "bb:bb:bb:bb:bb:bb"
       name: "node01"
       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"
     - mac:
         - cc:cc:cc:cc:cc:cc
       name: "node02"
       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"

   Copy to Clipboard Toggle word wrap

   这个模板使用以下属性：

   name

   节点的逻辑名称。

   pm_type

   要使用的电源管理驱动程序。本例中使用 IPMI 驱动程序 (ipmi)，这是首选的电源管理驱动程序。

   注意

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

   pm_user; pm_password

   IPMI 的用户名和密码。

   pm_addr

   IPMI 设备的 IP 地址。

   mac

   （可选）节点上网络接口的 MAC 地址列表。对于每个系统的 Provisioning NIC，只使用 MAC 地址。

   cpu

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

   memory

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

   disk

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

   arch

   系统架构。（可选）

   重要

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

2. 创建完模板后，将这个文件保存到 stack 用户的主目录 (/home/stack/nodes.json)，然后使用以下命令将其导入到 director：

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

   Copy to Clipboard Toggle word wrap

   这会导入模板，并把模板中的每个节点注册到 director。

3. 完成节点注册和配置之后，在 CLI 中查看这些节点的列表：

   (undercloud) $ openstack baremetal node list

   Copy to Clipboard Toggle word wrap

步骤

1. 运行以下命令检查每个节点的属性：

   (undercloud) $ openstack overcloud node introspect --all-manageable --provide

   Copy to Clipboard Toggle word wrap
   • --all-manageable 选项仅内省处于受管理状态的节点。本例中为所有节点。
   • --provide 选项会在内省后将所有节点重置为 available 状态。

2. 在一个单独的终端窗口中运行以下命令来监测内省的进程：

   (undercloud) $ sudo journalctl -l -u openstack-ironic-inspector -u openstack-ironic-inspector-dnsmasq -u openstack-ironic-conductor -f

   Copy to Clipboard Toggle word wrap
   重要

   确保这个过程成功完成。它可能需要 15 分钟来检查这些裸机节点。

3. 内省完成后，所有节点都会变为 available 状态。

步骤

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

   (undercloud) $ openstack baremetal node set --property capabilities='profile:compute,boot_option:local' 58c3d07e-24f2-48a7-bbb6-6843f0e8ee13
   (undercloud) $ openstack baremetal node set --property capabilities='profile:control,boot_option:local' 1a4e30da-b6dc-499d-ba87-0bd8a3819bc0

   Copy to Clipboard Toggle word wrap

   其中的 profile:compute 和 profile:control 选项会把节点标记为相关的配置集。

   这些命令还设置 boot_option:local 参数，该参数用于定义每个节点的引导方式。

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

   (undercloud) $ openstack overcloud profiles list

   Copy to Clipboard Toggle word wrap

步骤

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

   ipxe_enabled = True
   inspection_enable_uefi = True

   Copy to Clipboard Toggle word wrap

2. 保存此文件并执行 undercloud 安装：

   $ openstack undercloud install

   Copy to Clipboard Toggle word wrap

   等待安装脚本完成。

3. 将每个注册节点的引导模式设置为 uefi。例如，要在 capabilities 属性中添加或替换现有的 boot_mode 参数，可运行以下命令：

   $ 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

   Copy to Clipboard Toggle word wrap
   注意

   检查是否保留了 profile 和 boot_option 功能。

   +

   $ openstack baremetal node show r530-12 -f json -c properties | jq -r .properties.capabilities

   Copy to Clipboard Toggle word wrap

4. 将各个类型的引导模式设为 uefi：

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

   Copy to Clipboard Toggle word wrap

步骤

1. 通过对每个节点的硬盘执行内省，检查磁盘信息。以下命令显示了一个节点的磁盘信息：

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

   Copy to Clipboard Toggle word wrap

   例如，一个节点的数据可能会显示 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"
     }
   ]

   Copy to Clipboard Toggle word wrap

2. 本例演示了如何将根设备设置为磁盘 2，该磁盘的序列号为 61866da04f380d001ea4e13c12e36ad6。这需要更改节点定义的 root_device 参数：

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

   Copy to Clipboard Toggle word wrap
   注意

   把每个节点的 BIOS 配置为包括从所选 root 磁盘引导。推荐的引导顺序是：网络引导，然后是 root 磁盘引导。

步骤

1. 创建一个 node-info.yaml 文件，保存在 /home/stack/templates/ 目录下：

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

   Copy to Clipboard Toggle word wrap

2. 编辑这个文件，使其包含您需要的节点数目和类型。本例部署 3 个 Controller 节点、3 个 Compute 节点和 3 个Ceph Storage 节点。

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
   注意

   证书字符串必须采用 PEM 格式。

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

步骤

1. overcloud 的 Heat 核心模板采用 Jinja2 格式。要验证您的模板，请使用以下命令呈现未采用 Jinja2 格式的版本：

   $ cd /usr/share/openstack-tripleo-heat-templates
   $ ./tools/process-templates.py -o ~/overcloud-validation

   Copy to Clipboard Toggle word wrap

2. 使用下列命令来验证模板语法：

   (undercloud) $ openstack orchestration template validate --show-nested \
     --template ~/overcloud-validation/overcloud.yaml
     -e ~/overcloud-validation/overcloud-resource-registry-puppet.yaml \
     -e [ENVIRONMENT FILE] \
     -e [ENVIRONMENT FILE]

   Copy to Clipboard Toggle word wrap

   验证过程需要 overcloud-resource-registry-puppet.yaml 环境文件包括针对于 overcloud 的资源。使用 -e 选项为这个命令添加其他额外的环境文件。此外，还需包含 --show-nested 选项，以解析来自嵌套模板的参数。

3. 此命令可以识别模板中的任何语法错误。如果模板语法验证成功，输出会显示生成的 overcloud 模板的预览。