第 5 章 使用 CLI 工具配置基本的 overcloud 要求

director 需要一个节点定义模板。这个文件（instackenv.json）是一个 JSON 格式的文件，它包括了环境中的节点的硬件信息和电源管理信息。例如，注册两个节点的模板会和以下类似：

{
    "nodes":[
        {
            "mac":[
                "bb:bb:bb:bb:bb:bb"
            ],
            "cpu":"4",
            "memory":"6144",
            "disk":"40",
            "arch":"x86_64",
            "pm_type":"pxe_ipmitool",
            "pm_user":"admin",
            "pm_password":"p@55w0rd!",
            "pm_addr":"192.0.2.205"
        },
        {
            "mac":[
                "cc:cc:cc:cc:cc:cc"
            ],
            "cpu":"4",
            "memory":"6144",
            "disk":"40",
            "arch":"x86_64",
            "pm_type":"pxe_ipmitool",
            "pm_user":"admin",
            "pm_password":"p@55w0rd!",
            "pm_addr":"192.0.2.206"
        }
    ]
}

这个模板使用以下属性：

在创建完模板后，把这个文件保存到 stack 用户的家目录（/home/stack/instackenv.json），然后把它导入到 director。使用以下命令：

$ openstack baremetal import --json ~/instackenv.json

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

为所有节点分配内核和 ramdisk 镜像：

$ openstack baremetal configure boot

现在，节点已在 director 中注册并被配置。使用以下命令可以在 CLI 中查看这些节点的列表：

$ openstack baremetal node list

director 可以在每个节点上运行内省进程。这个进程会使每个节点通过 PXE 引导一个内省代理。这个代理从节点上收集硬件数据，并把信息发送回 director，director 把这些信息保存在运行于 director 上的 OpenStack Object Storage (swift) 服务中。director 使用硬件信息用于不同目的，如进行 profile tagging、benchmarking、手工引导磁盘分配等。

将所有节点设置为受管理状态：

$ for node in $(openstack baremetal node list --fields uuid -f value) ; do openstack baremetal node manage $node ; done

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

$ openstack overcloud node introspect --all-manageable --provide

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

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

或者，在每个节点上独立进行一个内省操作。把节点设置为管理模式，执行内省操作，然后把节点移出维护模式：

$ openstack baremetal node manage [NODE UUID]
$ openstack overcloud node introspect [NODE UUID] --provide

在注册并检查完每个节点的硬件后，需要为它们添加标签，加入特定的配置文件。这些配置文件标签会把节点和类型 (flavor) 相匹配，从而使类型分配到部署角色。在 undercloud 的安装过程中，会创建默认的配置文件类型：compute、control、swift-storage、ceph-storage 和 block-storage；多数环境中可不经修改直接使用。

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

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

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

这些命令同时也设置了 boot_option:local 参数，它定义了每个节点的引导模式。

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

$ openstack overcloud profiles list

一些节点可能会使用多个磁盘。这意味着，director 需要可以区分在 provisioning 时作为 root 磁盘使用的磁盘。以下的几个属性可以被用来帮助 director 区分 root 磁盘：

在本例中，使用磁盘的序列号指定根设备来部署 overcloud 镜像。

首先，收集 director 通过内省获得的每个节点的硬件信息。这些信息保存在 the OpenStack Object Storage 服务器（swift）中。把这些信息下载到一个新目录中：

$ mkdir swift-data
$ cd swift-data
$ export SWIFT_PASSWORD=`sudo crudini --get /etc/ironic-inspector/inspector.conf swift password`
$ for node in $(ironic node-list | grep -v UUID| awk '{print $2}'); do swift -U service:ironic -K $SWIFT_PASSWORD download ironic-inspector inspector_data-$node; done

这会从内省中下载每个 inspector_data 项中的信息。所有项都会使用节点的 UUID 作为项的名称的一部分：

$ ls -1
inspector_data-58c3d07e-24f2-48a7-bbb6-6843f0e8ee13
inspector_data-1a4e30da-b6dc-499d-ba87-0bd8a3819bc0

检查每个节点的磁盘信息。以下信息显示了每个节点的 ID 和磁盘信息：

$ for node in $(ironic node-list | awk '!/UUID/ {print $2}'); do echo "NODE: $node" ; cat inspector_data-$node | jq '.inventory.disks' ; echo "-----" ; done

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

NODE: 1a4e30da-b6dc-499d-ba87-0bd8a3819bc0
[
  {
    "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（序列号为 61866da04f380d001ea4e13c12e36ad6）。这需要在节点定义中修改 root_device 参数：

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

这将帮助 director 识别特定的磁盘来用作根设备。当开始创建 overcloud 时，director 会部署这一节点，把 overcloud 镜像写入到这个磁盘。

undercloud 包含一组 Heat 模板，可充当 overcloud 的创建计划。您可以参照 Overcloud 高级自定义指南，自定义 overcloud 的高级功能。

或者，您可以继续操作并部署基本的 overcloud。如需更多信息，请参阅第 5.6 节 “使用 CLI 工具创建 Overcloud”。

创建 OpenStack 环境的最后一个环节是运行 openstack overcloud deploy 命令进行创建。在运行此命令前，您应当已经熟悉关键的选项，以及如何加入自定义环境文件。以下小节探讨 openstack overcloud deploy 命令以及与它相关的选项。

下表列出了 openstack overcloud deploy 命令的额外参数。

$ openstack help overcloud deploy

使用 -e 来包含用于自定义 overcloud 的环境文件。您可以根据需要包含多个环境文件。但是，环境文件的顺序非常重要，后续环境文件中定义的参数和资源会覆盖前面环境文件中定义的相同参数和资源。下表是环境文件顺序的一个示例：

使用 -e 选项添加的所有环境文件都会成为 overcloud 栈定义的一部分。

同样，使用 --environment-directory 选项添加的目录中包括的环境文件也会成为 Overcloud 的栈定义的一部分。部署命令按照数字的顺序而不是字母顺序处理这个目录中的环境文件。因此，在使用这个方法时，推荐在文件名中包括一个数字前缀。例如：

$ ls -1 ~/templates
10-network-isolation.yaml
20-network-environment.yaml
30-storage-environment.yaml
40-rhel-registration.yaml

director 需要这些环境文件来进行重新部署并使用部署后的功能（请参阅 第 7 章 创建 Overcloud 后执行的任务）。没有正确包含这些文件可能会破坏您的 overcloud。

如果计划在以后修改 overcloud 配置，您应该：

不要直接编辑 overcloud 的配置，因为在使用 director 对 overcloud 栈进行更新时，这种手动配置会被 director 的配置覆盖。

#!/bin/bash
openstack overcloud deploy --templates \
  -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
  -e ~/templates/network-environment.yaml \
  -e ~/templates/storage-environment.yaml \
  -t 150 \
  --control-scale 3 \
  --compute-scale 3 \
  --ceph-storage-scale 3 \
  --swift-storage-scale 0 \
  --block-storage-scale 0 \
  --compute-flavor compute \
  --control-flavor control \
  --ceph-storage-flavor ceph-storage \
  --swift-storage-flavor swift-storage \
  --block-storage-flavor block-storage \
  --ntp-server pool.ntp.org \
  --neutron-network-type vxlan \
  --neutron-tunnel-types vxlan \
  --libvirt-type qemu

下例中的命令演示如何启动包含有自定义环境文件的 overcloud 创建过程：

$ openstack overcloud deploy --templates \
  -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
  -e ~/templates/network-environment.yaml \
  -e ~/templates/storage-environment.yaml \
  --control-scale 3 \
  --compute-scale 3 \
  --ceph-storage-scale 3 \
  --control-flavor control \
  --compute-flavor compute \
  --ceph-storage-flavor ceph-storage \
  --ntp-server pool.ntp.org \
  --neutron-network-type vxlan \
  --neutron-tunnel-types vxlan

这个命令包括以下的额外选项：

overcloud 创建过程开始，director 部署您的节点。此过程需要一些时间完成。要查看 overcloud 创建的状态，请在另外一个终端中以 stack 用户身份运行：

$ source ~/stackrc                # Initializes the stack user to use the CLI commands
$ heat stack-list --show-nested

heat stack-list --show-nested 命令会显示 overcloud 创建过程的当前状态。

director 会生成脚本来配置和帮助认证 director 主机与 overcloud 的交互。director 将此文件保存为 stack 用户主目录的 overcloudrc 文件。运行以下命令来使用此文件：

$ source ~/overcloudrc

这会加载从 director 主机的 CLI 访问 overcloud 所需的环境变量。若要返回到与 director 主机交互，请运行以下命令：

$ source ~/stackrc

overcloud 中的每个节点还会包括一个名为 heat-admin 的用户。stack 用户有到每个节点上的此用户的 SSH 访问权限。要通过 SSH 访问某一节点，可查找相关节点的 IP 地址：

$ nova list

使用 heat-admin 用户和节点的 IP 地址连接到节点：

$ ssh heat-admin@192.0.2.23

使用命令行工具创建 overcloud 的步骤到此结束。有关创建后的功能，请参阅第 7 章 创建 Overcloud 后执行的任务。