第 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.168.24.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.168.24.206"
        }
    ]
}

这个模板使用以下属性：

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

$ openstack overcloud node import ~/instackenv.json

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

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

$ openstack baremetal node list

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

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

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

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

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

内省完成后，所有节点变更为 active 状态。

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

内省完成后，节点变更为 active 状态。

$ 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

内省完成后，所有节点变更为 active 状态。

在注册并检查完每个节点的硬件后，需要为它们添加标签，加入特定的配置文件。这些配置文件标签会把节点和类型（flavor）相匹配，从而使类型分配到部署角色。下方的示例显示了 Controller 节点的角色、类型、配置文件和节点之间的关系：

默认的配置文件类型 compute、control、swift-storage、ceph-storage 和 block-storage 会在 undercloud 的安装过程中创建，多数环境中可不经修改直接使用。

为了通过添加标签把节点标记为特定的配置集，把 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

$ openstack flavor create --id auto --ram 4096 --disk 40 --vcpus 1 networker
$ openstack flavor set --property "cpu_arch"="x86_64" --property "capabilities:boot_option"="local" --property "capabilities:profile"="networker" networker

分配采用这种新配置集的节点：

$ openstack baremetal node set --property capabilities='profile:networker,boot_option:local' dad05b82-0c74-40bf-9d12-193184bfc72d

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

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

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

$ 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（序列号为 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。如需更多信息，请参阅???。

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

某些命令行参数被弃用，以支持使用环境文件的 parameter_defaults 部分中包含的 Heat 模板参数。下表将被弃用的参数映射到 Heat 模板的等同参数。

这些参数预定会从未来的 Red Hat OpenStack Platform 版本中移除。

$ openstack help overcloud deploy

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

使用 -e 选项添加的所有环境文件都会成为 overcloud 栈定义的一部分。下例中的命令演示如何启动包含有自定义环境文件的 overcloud 创建过程：

$ openstack overcloud deploy --templates \
  -e ~/templates/node-info.yaml\
  -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
  -e ~/templates/network-environment.yaml \
  -e ~/templates/storage-environment.yaml \
  --ntp-server pool.ntp.org \

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

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

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

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

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

运行以下部署命令，以包含目录：

$ openstack overcloud deploy --templates --environment-directory ~/templates

例如，应答文件可能包含以下内容：

templates: /usr/share/openstack-tripleo-heat-templates/
environments:
  - ~/templates/00-node-info.yaml
  - ~/templates/10-network-isolation.yaml
  - ~/templates/20-network-environment.yaml
  - ~/templates/30-storage-environment.yaml
  - ~/templates/40-rhel-registration.yaml

运行下列部署命令，以包含应答文件：

$ openstack overcloud deploy --answers-file ~/answers.yaml

作为 openstack overcloud deploy 命令的一种替代，director 也可以管理导入的计划。

如要创建新计划，请以 stack 用户的身份运行以下命令：

$ openstack overcloud plan create --templates /usr/share/openstack-tripleo-heat-templates my-overcloud

这会从 /usr/share/openstack-tripleo-heat-templates 的 Heat 核心模板集创建一个计划。director 根据您的输入为计划命名。在本例中，名称即是 my-overcloud。director 将这个名称用作对象存储容器、工作流环境以及 overcloud 堆栈名称的标签。

使用以下命令，从环境文件添加参数：

$ openstack overcloud parameters set my-overcloud ~/templates/my-environment.yaml

使用以下命令，部署您的计划：

$ openstack overcloud plan deploy my-overcloud

使用以下命令，删除现有的计划：

$ openstack overcloud plan delete my-overcloud

创建 overcloud 或更新堆栈之前，先验证您的 Heat 模板和环境文件，确认是否存在任何错误。

$ openstack overcloud plan create --templates /usr/share/openstack-tripleo-heat-templates overcloud-validation
$ mkdir ~/overcloud-validation
$ cd ~/overcloud-validation
$ swift download overcloud-validation

使用 ~/overcloud-validation 中的呈现模板执行后续的验证测试。

$ 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]

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

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.168.24.23

使用命令行工具创建 overcloud 的步骤到此结束。有关创建后的功能，请参阅???。