第 4 章 安装 undercloud

director 的安装过程需要一个非 root 的用户来执行命令。使用以下命令创建一个名为 stack 的用户并设置密码：

[root@director ~]# useradd stack
[root@director ~]# passwd stack  # specify a password

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

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

切换到新的 stack 用户：

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

使用 stack 用户继续安装的过程。

director 使用系统镜像和 Heat 模板来创建 overcloud 环境。为保持文件的有序性，我们推荐创建以下目录来组织镜像和模板文件：

$ mkdir ~/images
$ mkdir ~/templates

本指南中的其它部分会使用这两个目录来保存特定的文件。

director 的安装和配置过程需要一个完全限定域名（FQDN），这意味着您需要为 director 的主机设置主机名（hostname）。使用以下命令检查主机的主机名：

$ hostname    # Checks the base hostname
$ hostname -f # Checks the long hostname (FQDN)

如果需要，使用 hostnamectl 设置主机名：

$ sudo hostnamectl set-hostname manager.example.com
$ sudo hostnamectl set-hostname --transient manager.example.com

另外，director 还需要在/etc/hosts 文件中包括一个带有系统主机名的项。例如，系统名是 manager.example.com，/etc/hosts 则需要包括一个和以下类似的项：

127.0.0.1   manager.example.com manager localhost localhost.localdomain localhost4 localhost4.localdomain4

若要安装 Red Hat OpenStack Platform director，首先需要使用 Red Hat Subscription Manager 注册主机系统，并且订阅所需的频道。

在 Content Delivery Network 中注册您的系统，在出现提示时输入您的用户门户网站的用户名和密码：

$ sudo subscription-manager register

找到 Red Hat OpenStack Platform director 所在的权利池。

$ sudo subscription-manager list --available --all

使用上一步中获得的池 ID 添加 Red Hat OpenStack Platform 11 权力：

$ sudo subscription-manager attach --pool=pool_id

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

$ sudo subscription-manager repos --disable=*
$ sudo subscription-manager repos --enable=rhel-7-server-rpms --enable=rhel-7-server-extras-rpms --enable=rhel-7-server-rh-common-rpms --enable=rhel-ha-for-rhel-7-server-rpms --enable=rhel-7-server-openstack-11-rpms

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

对系统上的软件进行一个更新来确保使用了最新的基本系统软件包：

$ sudo yum update -y
$ sudo reboot

现在，这个系统已经准备好可以进行 director 安装了。

使用以下命令安装 director 所需的命令行工具：

$ sudo yum install -y python-tripleoclient

这个命令会安装 director 所需的所有软件包。

director 的安装过程需要特定的设置来决定您的网络配置。这些设置保存在 stack 用户的家目录中的一个模板中（undercloud.conf）。

红帽会提供一个基本的模板来帮助您设置安装所需的配置。把这个模板复制到 stack 用户的家目录中：

$ cp /usr/share/instack-undercloud/undercloud.conf.sample ~/undercloud.conf

模板包含两个部分： [DEFAULT] 和 [auth]。

[DEFAULT] 部分包含下列参数：

[auth] 部分包含以下参数：

根据网络的具体情况修改这些参数的值。完成后，保存这个文件并运行以下命令：

$ openstack undercloud install

这会启动 director 的配置脚本。director 会安装额外的软件包，并把它的服务配置为和 undercloud.conf 中的设置相符合的情况。这个脚本会需要一些时间来完成。

完成后，配置脚本会产生两个文件：

此配置也会自动启用所有 OpenStack Platform 服务。使用以下命令检查已启用的服务：

$ sudo systemctl list-units openstack-*

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

$ source ~/stackrc

您现在可以使用 director 的命令行工具了。

director 需要以下几个磁盘镜像来部署 overcloud 节点：

从 rhosp-director-images 和 rhosp-director-images-ipa 软件包中获得这些镜像：

$ sudo yum install rhosp-director-images rhosp-director-images-ipa

把压缩文件展开到 stack 用户的家目录下的 images 目录中（/home/stack/images）：

$ cd ~/images
$ for i in /usr/share/rhosp-director-images/overcloud-full-latest-11.0.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-11.0.tar; do tar -xvf $i; done

把这些镜像导入到 director：

$ openstack overcloud image upload --image-path /home/stack/images/

这会把 bm-deploy-kernel、bm-deploy-ramdisk、overcloud-full、overcloud-full-initrd 和 overcloud-full-vmlinuz 镜像上传到 director。部署操作和 overcloud 需要这些镜像。另外，此脚本还会在 director 的 PXE 服务器上安装内省镜像。

在 CLI 中查看镜像列表：

$ openstack image list
+--------------------------------------+------------------------+
| ID                                   | Name                   |
+--------------------------------------+------------------------+
| 765a46af-4417-4592-91e5-a300ead3faf6 | bm-deploy-ramdisk      |
| 09b40e3d-0382-4925-a356-3a4b4f36b514 | bm-deploy-kernel       |
| ef793cd0-e65c-456a-a675-63cd57610bd5 | overcloud-full         |
| 9a51a6cb-4670-40de-b64b-b70f4dd44152 | overcloud-full-initrd  |
| 4f7e33f4-d617-47c1-b36f-cbe90f132e5d | overcloud-full-vmlinuz |
+--------------------------------------+------------------------+

这个列表没有显示内省 PXE 镜像。director 会把这些文件复制到 /httpboot。

[stack@host1 ~]$ ls -l /httpboot
total 341460
-rwxr-xr-x. 1 root root   5153184 Mar 31 06:58 agent.kernel
-rw-r--r--. 1 root root 344491465 Mar 31 06:59 agent.ramdisk
-rw-r--r--. 1 root root       337 Mar 31 06:23 inspector.ipxe

overcloud 节点需要名称服务器来提供 DNS 主机名解析。对于没有网络隔离的标准 overcloud，此名称服务器在 undercloud 的 neutron 子网中定义。使用以下命令定义环境的名称服务器：

$ openstack subnet list
$ openstack subnet set --dns-nameserver [nameserver1-ip] --dns-nameserver [nameserver2-ip] [subnet-uuid]

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

$ openstack subnet show [subnet-uuid]
+-------------------+-----------------------------------------------+
| Field             | Value                                         |
+-------------------+-----------------------------------------------+
| ...               |                                               |
| dns_nameservers   | 8.8.8.8                                       |
| ...               |                                               |
+-------------------+-----------------------------------------------+

红帽提供了一个对 undercloud 主机的重要数据以及 Red Hat OpenStack Platform director 进行备份的方法。如需了解更多与 undercloud 备份相关的信息，请参阅“备份和恢复 Director undercloud” 指南。

undercloud 的配置到此结束。下一章将介绍基本的 overcloud 配置，包括注册节点和检查节点，并把它们标记为不同的节点角色。