18.8. 在您自己的 SR-IOV 基础架构的 OpenStack 上安装集群
在 OpenShift Container Platform 4.10 中,您可以在运行于用户置备的基础架构上的 Red Hat OpenStack Platform(RHOSP)上安装集群,并使用 single-root 输入/输出虚拟化(SR-IOV)网络来运行计算机器。
通过利用您自己的基础架构,您可以将集群与现有的基础架构集成。与安装程序置备的安装相比,这个过程需要进行更多的操作,因为您必须创建所有 RHOSP 资源,如 Nova 服务器、Neutron 端口和安全组。但是,红帽提供了 Ansible playbook 来帮助您完成部署过程。
18.8.1. 先决条件
- 您可以参阅有关 OpenShift Container Platform 安装和更新 流程的详细信息。
- 您可以阅读有关 选择集群安装方法的文档,并为用户准备它。
- 使用OpenShift 集群支持的平台部分验证 OpenShift Container Platform 4.10 是否与您的 RHOSP 版本兼容。您还可以通过查看 RHOSP 上的 OpenShift Container Platform 支持来比较不同版本的平台支持。
- 您的网络配置不依赖于供应商网络。不支持提供商网络。
- 您有一个 RHOSP 帐户,您要安装 OpenShift Container Platform。
- 您可以了解集群扩展、control plane 大小和 etcd 的性能和可扩展性实践。如需更多信息,请参阅推荐的主机实践。
在运行安装程序的机器中,您有:
- 用来保存在安装过程中创建的文件的一个单一目录
- Python 3
18.8.2. OpenShift Container Platform 互联网访问
在 OpenShift Container Platform 4.10 中,您需要访问互联网来安装集群。
您必须具有以下互联网访问权限:
- 访问 OpenShift Cluster Manager 以下载安装程序并执行订阅管理。如果集群可以访问互联网,并且没有禁用 Telemetry,该服务会自动授权您的集群。
- 访问 Quay.io,以获取安装集群所需的软件包。
- 获取执行集群更新所需的软件包。
如果您的集群无法直接访问互联网,则可以在置备的某些类型的基础架构上执行受限网络安装。在此过程中,您可以下载所需的内容,并使用它为镜像 registry 填充安装软件包。对于某些安装类型,集群要安装到的环境不需要访问互联网。在更新集群前,您要更新镜像 registry 的内容。
18.8.3. 在 RHOSP 上安装 OpenShift Container Platform 的资源指南
为支持 OpenShift Container Platform 安装,您的 Red Hat OpenStack Platform(RHOSP)配额必须满足以下要求:
resource | value |
---|---|
浮动 IP 地址 | 3 |
端口 | 15 |
路由器 | 1 |
子网 | 1 |
RAM | 88 GB |
VCPU | 22 |
卷存储 | 275 GB |
实例 | 7 |
安全组 | 3 |
安全组规则 | 60 |
服务器组 | 2 - 每个机器池中每个额外可用区加 1 |
集群或许能以少于推荐资源运行,但其性能无法保证。
如果 RHOSP 对象存储(Swift)可用,并由具有 swiftoperator
角色的用户帐户执行,它将用作 OpenShift Container Platform 镜像 registry 的默认后端。在这种情况下,卷存储需要 175 GB。根据镜像 registry 的大小,Swift 空间要求会有所不同。
默认情况下,您的安全组和安全组规则配额可能较低。如果遇到问题,请以管理员 身份运行 openstack quota set --secgroups 3 --secgroup-rules 60 <project>
来提高配额。
OpenShift Container Platform 部署包含 control plane 机器、计算机器和 bootstrap 机器。
18.8.3.1. control plane 机器
默认情况下,OpenShift Container Platform 安装过程会创建三台 control plane 机器。
每台机器都需要:
- 来自 RHOSP 配额的实例
- 来自 RHOSP 配额的端口
- 至少有 16 GB 内存和 4 个 vCPU 的类别
- RHOSP 配额中至少有 100 GB 存储空间
18.8.3.2. 计算机器
默认情况下,OpenShift Container Platform 安装过程会创建三台计算机器。
每台机器都需要:
- 来自 RHOSP 配额的实例
- 来自 RHOSP 配额的端口
- 至少有 8 GB 内存和 2 个 vCPU 的类别
- RHOSP 配额中至少有 100 GB 存储空间
计算机器托管您在 OpenShift Container Platform 上运行的应用程序;运行数量应尽可能多。
另外,对于使用单根输入/输出虚拟化(SR-IOV)的集群,RHOSP 计算节点需要一个支持 巨页 的类别。
SR-IOV 部署通常采用性能优化,如专用或隔离的 CPU。为获得最佳性能,请将您的底层 RHOSP 部署配置为使用这些优化,然后在优化的基础架构上运行 OpenShift Container Platform 计算机器。
其他资源
- 有关配置高性能 RHOSP 计算节点的更多信息,请参阅 为性能配置计算节点。
18.8.3.3. bootstrap 机器
在安装过程中,会临时置备 bootstrap 机器来支持 control plane。生产 control plane 就绪后,bootstrap 机器会被取消置备。
bootstrap 机器需要:
- 来自 RHOSP 配额的实例
- 来自 RHOSP 配额的端口
- 至少有 16 GB 内存和 4 个 vCPU 的类别
- RHOSP 配额中至少有 100 GB 存储空间
18.8.4. 下载 playbook 依赖项
用于简化用户置备的基础架构安装过程的 Ansible playbook 需要几个 Python 模块。在您要运行安装程序的机器上,添加模块的存储库,然后下载它们。
这些说明假设您使用 Red Hat Enterprise Linux(RHEL)8。
先决条件
- Python 3 已安装在您的机器上。
流程
在命令行中添加软件仓库:
使用 Red Hat Subscription Manager 注册:
$ sudo subscription-manager register # If not done already
获取最新的订阅数据:
$ sudo subscription-manager attach --pool=$YOUR_POOLID # If not done already
禁用当前的软件仓库:
$ sudo subscription-manager repos --disable=* # If not done already
添加所需的软件仓库:
$ sudo subscription-manager repos \ --enable=rhel-8-for-x86_64-baseos-rpms \ --enable=openstack-16-tools-for-rhel-8-x86_64-rpms \ --enable=ansible-2.9-for-rhel-8-x86_64-rpms \ --enable=rhel-8-for-x86_64-appstream-rpms
安装模块:
$ sudo yum install python3-openstackclient ansible python3-openstacksdk python3-netaddr
确保
python
命令指向python
3:$ sudo alternatives --set python /usr/bin/python3
18.8.5. 下载安装 playbook
下载 Ansible playbook,可用于在您自己的 Red Hat OpenStack Platform(RHOSP)基础架构上安装 OpenShift Container Platform。
先决条件
- curl 命令行工具可在您的 计算机上使用。
流程
要将 playbook 下载到您的工作目录中,请从命令行运行以下脚本:
$ xargs -n 1 curl -O <<< ' https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/bootstrap.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/common.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/compute-nodes.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/control-plane.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/inventory.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/network.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/security-groups.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-bootstrap.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-compute-nodes.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-control-plane.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-load-balancers.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-network.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-security-groups.yaml https://raw.githubusercontent.com/openshift/installer/release-4.10/upi/openstack/down-containers.yaml'
Playbook 下载到您的计算机。
在安装过程中,您可以修改 playbook 来配置部署。
在集群生命周期中保留所有 playbook。您必须具有 playbook,才能从 RHOSP 中删除 OpenShift Container Platform 集群。
您必须将对 bootstrap.yaml
, compute-nodes.yaml
, control-plane.yaml
, network.yaml
, 和 security-groups.yaml
文件的编辑与相应的前缀为 down-
的 playbook 匹配。例如,对 bootstrap.yaml
文件的编辑也必须反映在 down-bootstrap.yaml
文件中。如果没有编辑这两个文件,则支持的删除集群过程将失败。
18.8.6. 获取安装程序
在安装 OpenShift Container Platform 之前,将安装文件下载到本地计算机上。
先决条件
- 您有一台运行 Linux 或 macOS 的计算机,本地磁盘空间为 500 MB
流程
- 访问 OpenShift Cluster Manager 站点的 Infrastructure Provider 页面。如果您有红帽帐户,请使用您的凭证登录。如果没有,请创建一个帐户。
- 选择您的基础架构供应商。
进入到安装类型的页面,下载与您的主机操作系统和架构对应的安装程序,并将该文件放在您要存储安装配置文件的目录中。
重要安装程序会在用来安装集群的计算机上创建几个文件。在完成集群安装后,您必须保留安装程序和安装程序所创建的文件。这两个文件都需要删除集群。
重要删除安装程序创建的文件不会删除您的集群,即使集群在安装过程中失败也是如此。要删除集群,请为特定云供应商完成 OpenShift Container Platform 卸载流程。
提取安装程序。例如,在使用 Linux 操作系统的计算机上运行以下命令:
$ tar -xvf openshift-install-linux.tar.gz
- 从 Red Hat OpenShift Cluster Manager 下载安装 pull secret。此 pull secret 允许您与所含授权机构提供的服务进行身份验证,这些服务包括为 OpenShift Container Platform 组件提供容器镜像的 Quay.io。
18.8.7. 为集群节点 SSH 访问生成密钥对
在 OpenShift Container Platform 安装过程中,您可以为安装程序提供 SSH 公钥。密钥通过它们的 Ignition 配置文件传递给 Red Hat Enterprise Linux CoreOS(RHCOS)节点,用于验证对节点的 SSH 访问。密钥添加到每个节点上 core
用户的 ~/.ssh/authorized_keys
列表中,这将启用免密码身份验证。
将密钥传递给节点后,您可以使用密钥对作为用户 核心
通过 SSH 连接到 RHCOS 节点。若要通过 SSH 访问节点,必须由 SSH 为您的本地用户管理私钥身份。
如果要通过 SSH 连接到集群节点来执行安装调试或灾难恢复,则必须在安装过程中提供 SSH 公钥。./openshift-install gather
命令还需要在集群节点上设置 SSH 公钥。
不要在生产环境中跳过这个过程,在生产环境中需要灾难恢复和调试。
您必须使用本地密钥,而不是使用特定平台方法配置 的密钥,如 AWS 密钥对。
流程
如果您在本地计算机上没有可用于在集群节点上进行身份验证的现有 SSH 密钥对,请创建一个。例如,在使用 Linux 操作系统的计算机上运行以下命令:
$ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> 1
- 1
- 指定新 SSH 密钥的路径和文件名,如
~/.ssh/id_ed25519
。如果您已有密钥对,请确保您的公钥位于~/.ssh
目录中。
注意如果您计划在
x86_64
架构上安装使用 FIPS 验证的/Modules in Process 加密库的 OpenShift Container Platform 集群,请不要创建使用ed25519
算法的密钥。相反,创建一个使用rsa
或ecdsa
算法的密钥。查看公共 SSH 密钥:
$ cat <path>/<file_name>.pub
例如,运行以下命令来查看
~/.ssh/id_ed25519.pub
公钥:$ cat ~/.ssh/id_ed25519.pub
将 SSH 私钥身份添加到本地用户的 SSH 代理(如果尚未添加)。在集群节点上,或者要使用
./openshift-install gather
命令,需要对该密钥进行 SSH 代理管理,才能在集群节点上进行免密码 SSH 身份验证。注意在某些发行版中,自动管理默认 SSH 私钥身份,如
~/.ssh/id_rsa
和~/.ssh/id_dsa
。如果
ssh-agent
进程尚未为您的本地用户运行,请将其作为后台任务启动:$ eval "$(ssh-agent -s)"
输出示例
Agent pid 31874
注意如果集群处于 FIPS 模式,则只使用 FIPS 兼容算法来生成 SSH 密钥。密钥必须是 RSA 或 ECDSA。
将 SSH 私钥添加到
ssh-agent
:$ ssh-add <path>/<file_name> 1
- 1
- 指定 SSH 私钥的路径和文件名,如
~/.ssh/id_ed25519.pub
输出示例
Identity added: /home/<you>/<path>/<file_name> (<computer_name>)
后续步骤
- 安装 OpenShift Container Platform 时,为安装程序提供 SSH 公钥。
18.8.8. 创建 Red Hat Enterprise Linux CoreOS(RHCOS)镜像
OpenShift Container Platform 安装程序要求 Red Hat OpenStack Platform(RHOSP)集群中存在 Red Hat Enterprise Linux CoreOS(RHCOS)镜像。检索最新的 RHCOS 镜像,然后使用 RHOSP CLI 上传该镜像。
先决条件
- 已安装 RHOSP CLI。
流程
- 登录到红帽客户门户网站的产品 下载页面。
在 Version 下,为 Red Hat Enterprise Linux(RHEL)8 选择 OpenShift Container Platform 4.10 的最新发行版本。
重要RHCOS 镜像可能不会随着 OpenShift Container Platform 的每个发行版本而改变。您必须下载最高版本的镜像,其版本号应小于或等于您安装的 OpenShift Container Platform 版本。如果可用,请使用与 OpenShift Container Platform 版本匹配的镜像版本。
- 下载 Red Hat Enterprise Linux CoreOS(RHCOS)- OpenStack Image(QCOW)。
解压缩镜像。
注意您必须解压 RHOSP 镜像,然后集群才能使用它。下载的文件的名称可能不包含压缩扩展名,如
.gz 或.
tgz
。要查找是否或者如何压缩文件,请在命令行中输入:$ file <name_of_downloaded_file>
从您下载的镜像,使用 RHOSP CLI 在集群中创建名为
rhcos
的镜像:$ openstack image create --container-format=bare --disk-format=qcow2 --file rhcos-${RHCOS_VERSION}-openstack.qcow2 rhcos
重要根据您的 RHOSP 环境,您可能能够以.
raw
或.qcow2 格式
上传镜像。如果使用 Ceph,则必须使用.raw
格式。警告如果安装程序发现多个同名的镜像,它会随机选择其中之一。为避免这种行为,请在 RHOSP 中为资源创建唯一名称。
将镜像上传到 RHOSP 后,就可以在安装过程中使用它。
18.8.9. 验证外部网络访问
OpenShift Container Platform 安装过程需要外部网络访问权限。您必须为其提供外部网络值,否则部署会失败。在开始这个过程前,请验证 Red Hat OpenStack Platform(RHOSP)中是否存在具有外部路由器类型的网络。
流程
使用 RHOSP CLI 验证"外部"网络的名称和 ID:
$ openstack network list --long -c ID -c Name -c "Router Type"
输出示例
+--------------------------------------+----------------+-------------+ | ID | Name | Router Type | +--------------------------------------+----------------+-------------+ | 148a8023-62a7-4672-b018-003462f8d7dc | public_network | External | +--------------------------------------+----------------+-------------+
网络列表中会显示具有外部路由器类型的网络。如果至少有一个没有,请参阅创建默认浮动 IP 网络和创建默认供应商网络。
如果启用了 Neutron 中继服务插件,则默认创建一个中继端口。如需更多信息,请参阅 Neutron 中继端口。
18.8.10. 启用对环境的访问
在部署时,所有 OpenShift Container Platform 机器都是在 Red Hat OpenStack Platform(RHOSP)租户网络中创建的。因此,大多数 RHOSP 部署中都无法直接访问它们。
您可以在安装过程中使用浮动 IP 地址(FIP)来配置 OpenShift Container Platform API 和应用程序访问。您还可以在没有配置 FIP 的情况下完成安装,但安装程序不会配置一种从外部访问 API 或应用程序的方法。
18.8.10.1. 启用通过浮动 IP 地址进行访问
创建浮动 IP(FIP)地址,以便外部访问 OpenShift Container Platform API、集群应用程序和 bootstrap 过程。
流程
使用 Red Hat OpenStack Platform(RHOSP)CLI 创建 API FIP:
$ openstack floating ip create --description "API <cluster_name>.<base_domain>" <external_network>
使用 Red Hat OpenStack Platform(RHOSP)CLI,创建应用程序或 Ingress,FIP:
$ openstack floating ip create --description "Ingress <cluster_name>.<base_domain>" <external_network>
使用 Red Hat OpenStack Platform(RHOSP)CLI 创建 bootstrap FIP:
$ openstack floating ip create --description "bootstrap machine" <external_network>
在 API 和 Ingress FIP 的 DNS 服务器中添加符合这些模式的记录:
api.<cluster_name>.<base_domain>. IN A <API_FIP> *.apps.<cluster_name>.<base_domain>. IN A <apps_FIP>
注意如果您不控制 DNS 服务器,可以通过将集群域名(如以下内容)添加到
/etc/hosts
文件中来访问集群:-
<api_floating_ip> api.<cluster_name>.<base_domain>
-
<application_floating_ip> grafana-openshift-monitoring.apps.<cluster_name>.<base_domain>
-
<application_floating_ip> prometheus-k8s-openshift-monitoring.apps.<cluster_name>.<base_domain>
-
<application_floating_ip> oauth-openshift.apps.<cluster_name>.<base_domain>
-
<application_floating_ip> console-openshift-console.apps.<cluster_name>.<base_domain>
-
application_floating_ip integrated-oauth-server-openshift-authentication.apps.<cluster_name>.<base_domain>
/etc/hosts
文件中的集群域名授予对本地集群的 Web 控制台和监控界面的访问权限。您还可以使用kubectl
或oc
。您可以使用指向 <application_floating_ip> 的额外条目来访问用户应用程序。此操作使 API 和应用程序可供您访问,不适合于生产部署,但允许对开发和测试进行安装。-
将 FIP 添加到
inventory.yaml
文件中,作为以下变量的值:-
os_api_fip
-
os_bootstrap_fip
-
os_ingress_fip
-
如果使用这些值,还必须在 inventory.yaml
文件中输入外部网络作为 os_external_network
变量的值。
您可以通过分配浮动 IP 地址并更新防火墙配置,使 OpenShift Container Platform 资源在集群外可用。
18.8.10.2. 完成没有浮动 IP 地址的安装
您可以在 Red Hat OpenStack Platform(RHOSP)上安装 OpenShift Container Platform,而无需提供浮动 IP 地址。
在 inventory.yaml
文件中,不要定义以下变量:
-
os_api_fip
-
os_bootstrap_fip
-
os_ingress_fip
如果无法提供外部网络,也可以将 os_external_network 留
空。如果没有提供 for os_external_network
值,则不会为您创建路由器,如果没有额外的操作,安装程序将无法从 Glance 检索镜像。之后在安装过程中,当您创建网络资源时,您必须自行配置外部连接。
如果您使用 wait-for
命令从因为缺少浮动 IP 地址或名称解析而无法访问集群 API 的系统中运行安装程序,安装会失败。在这些情况下,您可以使用代理网络或者从与机器位于相同网络的系统中运行安装程序。
您可以通过为 API 和 Ingress 端口创建 DNS 记录来启用名称解析。例如:
api.<cluster_name>.<base_domain>. IN A <api_port_IP> *.apps.<cluster_name>.<base_domain>. IN A <ingress_port_IP>
如果您不控制 DNS 服务器,您可以将记录添加到 /etc/hosts
文件中。此操作使 API 可供您自己访问,不适合于生产部署,而是允许安装以进行开发和测试。
18.8.11. 为安装程序定义参数
OpenShift Container Platform 安装程序依赖于一个名为 clouds.yaml
的文件。该文件描述了 Red Hat OpenStack Platform(RHOSP)配置参数,包括项目名称、登录信息和授权服务 URL。
流程
创建
clouds.yaml
文件:如果您的 RHOSP 发行版包含 Horizon Web UI,请在该 UI 中生成
clouds.yaml
文件。重要记得在
auth
字段中添加密码。您还可以将 secret 保存在clouds.yaml
以外的 一个独立的文件中。如果您的 RHOSP 发行版不包含 Horizon Web UI,或者您不想使用 Horizon,请自行创建该文件。如需有关
clouds.yaml
的详细信息,请参阅 RHOSP 文档中的 配置文件。clouds: shiftstack: auth: auth_url: http://10.10.14.42:5000/v3 project_name: shiftstack username: <username> password: <password> user_domain_name: Default project_domain_name: Default dev-env: region_name: RegionOne auth: username: <username> password: <password> project_name: 'devonly' auth_url: 'https://10.10.14.22:5001/v2.0'
如果您的 RHOSP 安装使用自签名证书颁发机构(CA)证书进行端点身份验证:
- 将证书颁发机构文件复制到您的机器中。
将
cacerts
键添加到clouds.yaml
文件。该值必须是到 CA 证书的绝对、不可 root 访问的路径:clouds: shiftstack: ... cacert: "/etc/pki/ca-trust/source/anchors/ca.crt.pem"
提示使用自定义 CA 证书运行安装程序后,您可以通过编辑
cloud-provider-config
keymap中的 ca-cert.pem
键的值来更新证书。在命令行中运行:$ oc edit configmap -n openshift-config cloud-provider-config
将
clouds.yaml
文件放在以下位置之一:-
OS_CLIENT_CONFIG_FILE
环境变量的值 - 当前目录
-
特定于 Unix 的用户配置目录,如
~/.config/openstack/clouds.yaml
特定于 Unix 的站点配置目录,如
/etc/openstack/clouds.yaml
安装程序会按顺序搜索
clouds.yaml
。
-
18.8.12. 创建安装配置文件
您可以自定义在 Red Hat OpenStack Platform(RHOSP)上安装的 OpenShift Container Platform 集群。
先决条件
- 获取 OpenShift Container Platform 安装程序和集群的 pull secret。
- 在订阅级别获取服务主体权限。
流程
创建
install-config.yaml
文件。进入包含安装程序的目录并运行以下命令:
$ ./openshift-install create install-config --dir <installation_directory> 1
- 1
- 对于
<installation_directory>
,请指定要存储安装程序创建的文件的目录名称。
重要指定一个空目录。有些安装资产,如 bootstrap X.509 证书的过期间隔较短,因此不得重复使用安装目录。如果要重复使用另一个集群安装中的单个文件,您可以将它们复制到您的目录中。但是,安装资产的文件名可能会在发行版本间有所变化。从以前的 OpenShift Container Platform 版本中复制安装文件时请小心。
在提示符处,提供云的配置详情:
可选: 选择用于访问集群机器的 SSH 密钥。
注意对于您要在其上执行安装调试或灾难恢复的生产环境 OpenShift Container Platform 集群,请指定
ssh-agent
进程使用的 SSH 密钥。- 选择 openstack 作为目标平台。
- 指定用于安装集群的 Red Hat OpenStack Platform(RHOSP)外部网络名称。
- 指定用于从外部访问 OpenShift API 的浮动 IP 地址。
- 指定至少有 16 GB RAM 用于 control plane 节点,以及计算节点的 8 GB RAM。
- 选择集群要部署到的基域。所有 DNS 记录都将是这个基域的子域,并且还包括集群名称。
- 为集群输入一个名称。名称长度必须为 14 个或更少字符。
- 粘贴 Red Hat OpenShift Cluster Manager 中的 pull secret。
-
修改
install-config.yaml
文件。您可以在"安装配置参数"部分找到有关可用参数的更多信息。 备份
install-config.yaml
文件,以便您可以使用它安装多个集群。重要install-config.yaml
文件会在安装过程中消耗掉。如果要重复使用该文件,您必须立即备份该文件。
现在,文件 install-config.yaml
位于您指定的目录中。
18.8.13. 安装配置参数
在部署 OpenShift Container Platform 集群前,您可以提供参数值来描述托管集群的云平台中的帐户,并选择性地自定义集群平台。在创建 install-config.yaml
安装配置文件时,您可以通过命令行为所需参数提供值。如果自定义集群,您可以修改 install-config.yaml
文件以提供有关平台的更多详情。
安装后,您无法在 install-config.yaml
文件中修改这些参数。
18.8.13.1. 所需的配置参数
下表描述了所需的安装配置参数:
参数 | 描述 | 值 |
---|---|---|
|
| 字符串 |
|
云供应商的基域。基域用于创建到 OpenShift Container Platform 集群组件的路由。集群的完整 DNS 名称是 |
完全限定域名或子域名,如 |
|
Kubernetes 资源 | 对象 |
|
集群的名称。集群的 DNS 记录是 |
小写字母、连字符( |
|
要执行安装的具体平台配置: | 对象 |
| 从 Red Hat OpenShift Cluster Manager 获取 pull secret,验证从 Quay.io 等服务中下载 OpenShift Container Platform 组件的容器镜像。 |
{ "auths":{ "cloud.openshift.com":{ "auth":"b3Blb=", "email":"you@example.com" }, "quay.io":{ "auth":"b3Blb=", "email":"you@example.com" } } } |
18.8.13.2. 网络配置参数
您可以根据现有网络基础架构的要求自定义安装配置。例如,您可以扩展集群网络的 IP 地址块,或者提供不同于默认值的不同 IP 地址块。
仅支持 IPv4 地址。
参数 | 描述 | 值 |
---|---|---|
| 集群网络的配置。 | 对象 注意
您无法在安装后修改 |
| 要安装的集群网络供应商 Container Network Interface (CNI) 插件。 |
|
| pod 的 IP 地址块。
默认值为 如果您指定了多个 IP 地址块,块不得重叠。 | 对象数组。例如: networking: clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23 |
|
使用 IPv4 网络。 |
无类别域间路由(CIDR)表示法中的 IP 地址块。IPv4 块的前缀长度介于 |
|
分配给每个节点的子网前缀长度。例如,如果 | 子网前缀。
默认值为 |
|
服务的 IP 地址块。默认值为 OpenShift SDN 和 OVN-Kubernetes 网络供应商只支持服务网络的一个 IP 地址块。 | 具有 CIDR 格式的 IP 地址块的数组。例如: networking: serviceNetwork: - 172.30.0.0/16 |
| 机器的 IP 地址块。 如果您指定了多个 IP 地址块,块不得重叠。 | 对象数组。例如: networking: machineNetwork: - cidr: 10.0.0.0/16 |
|
使用 | CIDR 表示法中的 IP 网络块。
例如: 注意
将 |
18.8.13.3. 可选的配置参数
下表描述了可选的安装配置参数:
参数 | 描述 | 值 |
---|---|---|
| 添加到节点可信证书存储中的 PEM 编码 X.509 证书捆绑包。配置了代理时,也可以使用此信任捆绑包。 | 字符串 |
| 在集群中的特定节点上启用 Linux 控制组群版本 2 (cgroups v2)。启用 cgroup v2 的 OpenShift Container Platform 进程会禁用所有 cgroup 版本 1 控制器和层次结构。OpenShift Container Platform cgroup 版本 2 功能是一个开发者预览(Developer Preview)功能,目前还不被红帽支持。 |
|
| 组成计算节点的机器的配置。 |
|
|
决定池中机器的指令集合架构。目前,不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 | 字符串 |
|
是否在计算机器上启用或禁用并发多 重要 如果您禁用并发多线程,请确保您的容量规划考虑机器性能显著降低的情况。 |
|
|
使用 |
|
|
使用 |
|
| 要置备的计算机器数量,也称为 worker 机器。 |
大于或等于 |
| 组成 control plane 的机器的配置。 |
|
|
决定池中机器的指令集合架构。目前,不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 | 字符串 |
|
是否在 control plane 机器上启用或禁用并发多 重要 如果您禁用并发多线程,请确保您的容量规划考虑机器性能显著降低的情况。 |
|
|
使用 |
|
|
使用 |
|
| 要置备的 control plane 机器数量。 |
唯一支持的值是 |
| Cloud Credential Operator(CCO)模式。如果没有指定模式,CCO 会动态尝试决定提供的凭证的功能,在支持多个模式的平台上首选 mint 模式。 注意 不是所有 CCO 模式都支持所有云供应商。如需有关 CCO 模式的更多信息,请参阅集群 Operator 参考内容中的 Cloud Credential Operator 条目。 注意
如果您的 AWS 帐户启用了服务控制策略 (SCP),您必须将 |
|
|
启用或禁用 FIPS 模式。默认值为 重要
要为集群启用 FIPS 模式,您必须从配置为以 FIPS 模式操作的 Red Hat Enterprise Linux (RHEL) 计算机运行安装程序。有关在 RHEL 中配置 FIPS 模式的更多信息,请参阅在 FIPS 模式中安装该系统。只有在 注意 如果使用 Azure File 存储,则无法启用 FIPS 模式。 |
|
| release-image 内容的源和存储库。 |
对象数组。包括一个 |
|
使用 | 字符串 |
| 指定可能还包含同一镜像的一个或多个仓库。 | 字符串数组 |
| 如何发布或公开集群的面向用户的端点,如 Kubernetes API、OpenShift 路由。 |
在非云平台和 IBM Cloud VPC 中不支持将此字段设置为 重要
如果将字段的值设为 |
| 用于验证集群机器访问的 SSH 密钥或密钥。 注意
对于您要在其上执行安装调试或灾难恢复的生产环境 OpenShift Container Platform 集群,请指定 | 一个或多个密钥。例如: sshKey: <key1> <key2> <key3> |
18.8.13.4. 其他 Red Hat OpenStack Platform(RHOSP)配置参数
下表中描述了其他 RHOSP 配置参数:
参数 | 描述 | 值 |
---|---|---|
| 对于计算机器,以 GB 为单位的根卷大小。如果没有设置这个值,机器将使用临时存储。 |
整数,如 |
| 对于计算机器,根卷的类型。 |
字符串,如 |
| 对于 control plane 机器,以 GB 为单位表示的根卷大小。如果没有设置这个值,机器将使用临时存储。 |
整数,如 |
| 对于 control plane 机器,根卷的类型。 |
字符串,如 |
|
要使用的 RHOSP 云名称,来自于 |
字符串,如 |
| 用于安装的 RHOSP 外部网络名称。 |
字符串,如 |
| 用于 control plane 和计算机器的 RHOSP 类别。
此属性已弃用。要将 flavor 用作所有机器池的默认值,请将其添加为 |
字符串,如 |
18.8.13.5. 可选的 RHOSP 配置参数
下表描述了可选的 RHOSP 配置参数:
参数 | 描述 | 值 |
---|---|---|
| 与计算机器关联的其他网络。不为额外网络创建允许的地址对。 |
一个或多个 UUID 的列表作为字符串。例如: |
| 与计算机器关联的其他安全组。 |
一个或多个 UUID 的列表作为字符串。例如, |
| RHOSP Compute(Nova)可用区(AZ)在其中安装机器。如果没有设置此参数,安装程序会依赖于配置了 RHOSP 管理员的 Nova 的默认设置。 在使用 Kuryr 的集群上,RHOSP Octavia 不支持可用区。负载均衡器,如果您使用 Amphora 供应商驱动程序,则依赖 Amphora 虚拟机的 OpenShift Container Platform 服务不会根据此属性的值创建。 |
字符串列表。例如: |
| 对于计算机器,可在其上安装根卷的可用性区域。如果没有为此参数设置值,安装程序会选择默认的可用性区域。 |
字符串列表,如 |
|
要应用到包含池中的计算机器的组策略。您不能在创建后更改服务器组策略或关系。支持的选项包括
如果使用严格的 |
应用到机器池的服务器组策略。例如, |
| 与 control plane 机器关联的额外网络。不为额外网络创建允许的地址对。 |
一个或多个 UUID 的列表作为字符串。例如: |
| 与 control plane 机器关联的其他安全组。 |
一个或多个 UUID 的列表作为字符串。例如, |
| RHOSP Compute(Nova)可用区(AZ)在其中安装机器。如果没有设置此参数,安装程序会依赖于配置了 RHOSP 管理员的 Nova 的默认设置。 在使用 Kuryr 的集群上,RHOSP Octavia 不支持可用区。负载均衡器,如果您使用 Amphora 供应商驱动程序,则依赖 Amphora 虚拟机的 OpenShift Container Platform 服务不会根据此属性的值创建。 |
字符串列表。例如: |
| 对于 control plane 机器,安装根卷的可用区。如果没有设置这个值,安装程序会选择默认的可用区。 |
字符串列表,如 |
|
要应用到池中包含 control plane 机器的组的服务器组策略。您不能在创建后更改服务器组策略或关系。支持的选项包括
如果使用严格的 |
应用到机器池的服务器组策略。例如, |
| 安装程序从中下载 RHCOS 镜像的位置。 您必须设置此参数才能在受限网络中执行安装。 | HTTP 或 HTTPS URL,可选使用 SHA-256 校验和。
例如: |
|
在 Glance 中添加至安装程序上传的 ClusterOSImage 的属性。如果将
您可以使用此属性超过每个节点 26 个 PV 的 RHOSP 的默认持久性卷(PV)限值。要超过这个限制,请将 virtio-
您还可以使用此属性通过包含值为 |
键值字符串对列表。例如 |
| 默认机器池平台配置。 |
{ "type": "ml.large", "rootVolume": { "size": 30, "type": "performance" } } |
|
与 Ingress 端口关联的现有浮动 IP 地址。要使用此属性,还必须定义 |
IP 地址,如 |
|
与 API 负载均衡器关联的现有浮动 IP 地址。要使用此属性,还必须定义 |
IP 地址,如 |
| 集群实例用于 DNS 解析的外部 DNS 服务器的 IP 地址。 |
IP 地址列表作为字符串。例如 |
| 集群节点使用的 RHOSP 子网的 UUID。在这个子网上创建节点和虚拟 IP(VIP)端口。
如果部署到自定义子网中,则无法将外部 DNS 服务器指定到 OpenShift Container Platform 安装程序。相反,将 DNS 添加到 RHOSP 中的子网中。 |
作为字符串的 UUID。例如: |
18.8.13.6. RHOSP 的自定义 install-config.yaml
文件示例
这个示例 install-config.yaml
演示了所有可能的 Red Hat OpenStack Platform(RHOSP)自定义选项。
此示例文件仅供参考。您必须使用安装程序来获取 install-config.yaml
文件。
apiVersion: v1 baseDomain: example.com controlPlane: name: master platform: {} replicas: 3 compute: - name: worker platform: openstack: type: ml.large replicas: 3 metadata: name: example networking: clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23 machineNetwork: - cidr: 10.0.0.0/16 serviceNetwork: - 172.30.0.0/16 networkType: OpenShiftSDN platform: openstack: cloud: mycloud externalNetwork: external computeFlavor: m1.xlarge apiFloatingIP: 128.0.0.1 fips: false pullSecret: '{"auths": ...}' sshKey: ssh-ed25519 AAAA...
18.8.13.7. RHOSP 部署中的自定义子网
另外,您还可以在您选择的 Red Hat OpenStack Platform(RHOSP)子网中部署集群。子网的 GUID 作为 install-config.yaml
文件中的 platform.openstack.machinesSubnet
的值传递。
此子网被用作集群的主子网。默认情况下,其上会创建节点和端口。您可以通过将 platform.openstack.machinesSubnet
属性的值设置为子网的 UUID,在不同的 RHOSP 子网中创建节点和端口。
在使用自定义子网运行 OpenShift Container Platform 安装程序前,请验证您的配置是否满足以下要求:
-
platform.openstack.machinesSubnet
使用的子网启用了 DHCP。 -
platform.openstack.machinesSubnet 的
CIDR 与networking.machineNetwork
的 CIDR 匹配。 - 安装程序用户有在此网络上创建端口的权限,包括带有固定 IP 地址的端口。
使用自定义子网的集群有以下限制:
-
如果您计划安装使用浮动 IP 地址的集群,则必须将
platform.openstack.machinesSubnet
子网附加到连接到externalNetwork
网络的路由器。 -
如果在
install-config.yaml
文件中设置了platform.openstack.machinesSubnet
值,安装程序不会为您的 RHOSP 机器创建专用网络或子网。 -
您不能与自定义子网同时使用
platform.openstack.externalDNS
属性。要将 DNS 添加到使用自定义子网的集群,请在 RHOSP 网络上配置 DNS。
默认情况下,API VIP 使用 x.x.x.5,Ingress VIP 从网络 CIDR 块获取 x.x.x.7。要覆盖这些默认值,请为 DHCP 分配池之外的 platform.openstack.apiVIP
和 platform.openstack.ingressVIP
设置值。
18.8.13.8. 为机器设置自定义子网
安装程序默认使用的 IP 范围可能与您在安装 OpenShift Container Platform 时创建的 Neutron 子网不匹配。如有必要,通过编辑安装配置文件来更新新机器的 CIDR 值。
先决条件
-
有 OpenShift Container Platform 安装程序生成的
install-config.yaml
文件。
流程
-
在命令行中,浏览包含
install-config.yaml
的目录。 在该目录中,运行脚本来编辑
install-config.yaml
文件或手动更新该文件:要使用脚本设置值,请运行:
$ python -c ' import yaml; path = "install-config.yaml"; data = yaml.safe_load(open(path)); data["networking"]["machineNetwork"] = [{"cidr": "192.168.0.0/18"}]; 1 open(path, "w").write(yaml.dump(data, default_flow_style=False))'
- 1
- 插入与您预期的 Neutron 子网相匹配的值,如
192.0.2.0/24
。
-
要手动设置值,请打开 文件,并将
networking.machineCIDR
的值设置为与您预期的 Neutron 子网匹配的内容。
18.8.13.9. 清空计算机器池
要继续使用您自己的基础架构的安装,请将安装配置文件中的计算机器数量设置为零。之后,您可以手动创建这些机器。
先决条件
-
有 OpenShift Container Platform 安装程序生成的
install-config.yaml
文件。
流程
-
在命令行中,浏览包含
install-config.yaml
的目录。 在该目录中,运行脚本来编辑
install-config.yaml
文件或手动更新该文件:要使用脚本设置值,请运行:
$ python -c ' import yaml; path = "install-config.yaml"; data = yaml.safe_load(open(path)); data["compute"][0]["replicas"] = 0; open(path, "w").write(yaml.dump(data, default_flow_style=False))'
-
要手动设置值,打开该文件并将
compute.<first entry>.replicas 的
值设置为0
。
18.8.14. 创建 Kubernetes 清单和 Ignition 配置文件
由于您必须修改一些集群定义文件并手动启动集群机器,因此您必须生成 Kubernetes 清单和 Ignition 配置文件来配置机器。
安装配置文件转换为 Kubernetes 清单。清单嵌套到 Ignition 配置文件中,稍后用于配置集群机器。
-
OpenShift Container Platform 安装程序生成的 Ignition 配置文件包含 24 小时后过期的证书,然后在该时进行续订。如果在更新证书前关闭集群,且集群在 24 小时后重启,集群会自动恢复过期的证书。一个例外是,您必须手动批准待处理的
node-bootstrapper
证书签名请求(CSR)来恢复 kubelet 证书。如需更多信息,请参阅从过期的 control plane 证书 中恢复的文档。 - 建议您在 Ignition 配置文件生成后的 12 小时内使用它们,因为 24 小时的证书会在集群安装后的 16 小时到 22 小时间进行轮转。通过在 12 小时内使用 Ignition 配置文件,您可以避免在安装过程中因为执行了证书更新而导致安装失败的问题。
先决条件
- 已获得 OpenShift Container Platform 安装程序。
-
已创建
install-config.yaml
安装配置文件。
流程
进入包含 OpenShift Container Platform 安装程序的目录,并为集群生成 Kubernetes 清单:
$ ./openshift-install create manifests --dir <installation_directory> 1
- 1
- 对于
<installation_directory>
,请指定包含您创建的install-config.yaml
文件的安装目录。
删除定义 control plane 机器的 Kubernetes 清单文件以及计算机器集:
$ rm -f openshift/99_openshift-cluster-api_master-machines-*.yaml openshift/99_openshift-cluster-api_worker-machineset-*.yaml
由于您要自行创建和管理这些资源,因此不必初始化这些资源。
- 您可以使用机器 API 来保留机器集文件来创建计算机器,但您必须更新对它们的引用以匹配您的环境。
检查
<installation_directory>/manifests/cluster-scheduler-02-config.yml Kubernetes 清单文件中的
mastersSchedulable
参数是否已设置为false
。此设置可防止在 control plane 机器上调度 pod:-
打开
<installation_directory>/manifests/cluster-scheduler-02-config.yml
文件。 -
找到
mastersSchedulable
参数,并确保它被设置为false
。 - 保存并退出 文件。
-
打开
要创建 Ignition 配置文件,请从包含安装程序的目录运行以下命令:
$ ./openshift-install create ignition-configs --dir <installation_directory> 1
- 1
- 对于
<installation_directory>
,请指定相同的安装目录。
为安装目录中的 bootstrap、control plane 和计算节点创建 Ignition 配置文件。
kubeadmin-password
和kubeconfig
文件在./<installation_directory>/auth
目录中创建:. ├── auth │ ├── kubeadmin-password │ └── kubeconfig ├── bootstrap.ign ├── master.ign ├── metadata.json └── worker.ign
将元数据文件的
infraID
密钥导出为环境变量:$ export INFRA_ID=$(jq -r .infraID metadata.json)
从 metadata.json
中提取 infraID
密钥,并将它用作您创建的所有 RHOSP 资源的前缀。通过这样做,您可以避免在同一项目中进行多个部署时的名称冲突。
18.8.15. 准备 bootstrap Ignition 文件
OpenShift Container Platform 安装过程依赖于从 bootstrap Ignition 配置文件创建的 bootstrap 机器。
编辑 文件并上传该文件。然后,创建一个 Red Hat OpenStack Platform(RHOSP)用来下载主文件的辅助 bootstrap Ignition 配置文件。
先决条件
-
您有安装程序生成的 bootstrap Ignition 文件,即
bootstrap.ign
。 安装程序元数据文件中的基础架构 ID 被设置为环境变量(
$INFRA_ID
)。- 如果没有设置变量,请参阅 创建 Kubernetes 清单和 Ignition 配置文件。
您可以使用 HTTP(S)来存储 bootstrap Ignition 文件。
- 所记录的步骤使用 RHOSP 镜像服务(Glance),但也可以使用 RHOSP 存储服务(Swift)、Amazon S3、内部 HTTP 服务器或临时 Nova 服务器。
流程
运行以下 Python 脚本:该脚本修改 bootstrap Ignition 文件,以设置主机名,并在运行时设置 CA 证书文件:
import base64 import json import os with open('bootstrap.ign', 'r') as f: ignition = json.load(f) files = ignition['storage'].get('files', []) infra_id = os.environ.get('INFRA_ID', 'openshift').encode() hostname_b64 = base64.standard_b64encode(infra_id + b'-bootstrap\n').decode().strip() files.append( { 'path': '/etc/hostname', 'mode': 420, 'contents': { 'source': 'data:text/plain;charset=utf-8;base64,' + hostname_b64 } }) ca_cert_path = os.environ.get('OS_CACERT', '') if ca_cert_path: with open(ca_cert_path, 'r') as f: ca_cert = f.read().encode() ca_cert_b64 = base64.standard_b64encode(ca_cert).decode().strip() files.append( { 'path': '/opt/openshift/tls/cloud-ca-cert.pem', 'mode': 420, 'contents': { 'source': 'data:text/plain;charset=utf-8;base64,' + ca_cert_b64 } }) ignition['storage']['files'] = files; with open('bootstrap.ign', 'w') as f: json.dump(ignition, f)
使用 RHOSP CLI,创建使用 bootstrap Ignition 文件的镜像:
$ openstack image create --disk-format=raw --container-format=bare --file bootstrap.ign <image_name>
获取镜像的详情:
$ openstack image show <image_name>
记录
file
值;它遵循v2/images/<image_ID>/file
模式。注意验证您创建的镜像是否活跃。
检索镜像服务的公共地址:
$ openstack catalog show image
-
将公共地址与
镜像文件
值组合,并在存储位置保存结果。位置遵循<image_service_public_URL>/v2/images/<image_ID>/file
模式。 生成身份验证令牌并保存令牌 ID:
$ openstack token issue -c id -f value
将以下内容插入到名为
$INFRA_ID-bootstrap-ignition.json
的文件中,并编辑占位符以匹配您自己的值:{ "ignition": { "config": { "merge": [{ "source": "<storage_url>", 1 "httpHeaders": [{ "name": "X-Auth-Token", 2 "value": "<token_ID>" 3 }] }] }, "security": { "tls": { "certificateAuthorities": [{ "source": "data:text/plain;charset=utf-8;base64,<base64_encoded_certificate>" 4 }] } }, "version": "3.2.0" } }
- 保存辅助 Ignition 配置文件。
bootstrap Ignition 数据将在安装过程中传递给 RHOSP。
bootstrap Ignition 文件包含敏感信息,如 clouds.yaml
凭证。确保将其保存在安全的地方,并在完成安装后将其删除。
18.8.16. 在 RHOSP 上创建 control plane Ignition 配置文件
在您自己的基础架构的 Red Hat OpenStack Platform(RHOSP)上安装 OpenShift Container Platform 需要 control plane Ignition 配置文件。您必须创建多个配置文件。
与 bootstrap Ignition 配置一样,您必须明确为每个 control plane 机器定义主机名。
先决条件
来自安装程序元数据文件中的基础架构 ID 被设置为环境变量(
$INFRA_ID
)。- 如果没有设置变量,请参阅"创建 Kubernetes 清单和 Ignition 配置文件"。
流程
在命令行中运行以下 Python 脚本:
$ for index in $(seq 0 2); do MASTER_HOSTNAME="$INFRA_ID-master-$index\n" python -c "import base64, json, sys; ignition = json.load(sys.stdin); storage = ignition.get('storage', {}); files = storage.get('files', []); files.append({'path': '/etc/hostname', 'mode': 420, 'contents': {'source': 'data:text/plain;charset=utf-8;base64,' + base64.standard_b64encode(b'$MASTER_HOSTNAME').decode().strip(), 'verification': {}}, 'filesystem': 'root'}); storage['files'] = files; ignition['storage'] = storage json.dump(ignition, sys.stdout)" <master.ign >"$INFRA_ID-master-$index-ignition.json" done
您现在有三个 control plane Ignition 文件:&
lt;INFRA_ID>-master-0-ignition.json
、<INFRA_ID>-master-1-ignition.json
和<INFRA_ID>-master-2-ignition.json
。
18.8.17. 在 RHOSP 上创建网络资源
在您自己的基础架构的 Red Hat OpenStack Platform(RHOSP)安装上创建 OpenShift Container Platform 所需的网络资源。为节省时间,请运行提供的 Ansible playbook,以生成安全组、网络、子网、路由器和端口。
先决条件
- Python 3 已安装在您的机器上。
- 下载了"下载 playbook 依赖项"中的模块。
- 下载了"下载安装 playbook"中的 playbook。
流程
可选:在
inventory.yaml
playbook 中添加外部网络值:inventory.yaml
Ansible playbook 中的外部网络值示例... # The public network providing connectivity to the cluster. If not # provided, the cluster external connectivity must be provided in another # way. # Required for os_api_fip, os_ingress_fip, os_bootstrap_fip. os_external_network: 'external' ...
重要如果您没有在
inventory.yaml
文件中提供 foros_external_network
值,您必须确保虚拟机可以自行访问 Glance 和外部连接。可选:将外部网络和浮动 IP(FIP)地址值添加到
inventory.yaml
playbook 中:inventory.yaml
Ansible playbook 中的 FIP 值示例... # OpenShift API floating IP address. If this value is non-empty, the # corresponding floating IP will be attached to the Control Plane to # serve the OpenShift API. os_api_fip: '203.0.113.23' # OpenShift Ingress floating IP address. If this value is non-empty, the # corresponding floating IP will be attached to the worker nodes to serve # the applications. os_ingress_fip: '203.0.113.19' # If this value is non-empty, the corresponding floating IP will be # attached to the bootstrap machine. This is needed for collecting logs # in case of install failure. os_bootstrap_fip: '203.0.113.20'
重要如果没有定义 for
os_api_fip
和os_ingress_fip
的值,则必须执行安装后网络配置。如果您没有定义 for
os_bootstrap_fip
值,安装程序将无法从失败的安装中下载调试信息。如需更多信息,请参阅"启用对环境的访问"。
在命令行中,通过运行
security-groups.yaml
playbook 来创建安全组:$ ansible-playbook -i inventory.yaml security-groups.yaml
在命令行中,通过运行
network.yaml
playbook 来创建一个网络、子网和路由器:$ ansible-playbook -i inventory.yaml network.yaml
可选:如果要控制 Nova 服务器使用的默认解析程序,请运行 RHOSP CLI 命令:
$ openstack subnet set --dns-nameserver <server_1> --dns-nameserver <server_2> "$INFRA_ID-nodes"
另外,您可以使用您创建的 inventory.yaml
文件来自定义安装。例如,您可以部署使用裸机的集群。
18.8.17.1. 使用裸机部署集群
如果您希望集群使用裸机,请修改 inventory.yaml
文件。集群可以同时在裸机上运行 control plane 和计算机器,或者只在计算机器上运行。
使用 Kuryr 的集群中不支持裸机计算机器。
确保 install-config.yaml
文件反映了您用于裸机 worker 的 RHOSP 网络是否支持浮动 IP 地址。
先决条件
- RHOSP Bare Metal 服务(Ironic) 通过 RHOSP Compute API 启用并访问。
- 裸机 可作为 RHOSP 类别 提供。
- RHOSP 网络支持 VM 和裸机服务器附加。
- 您的网络配置不依赖于供应商网络。不支持提供商网络。
- 如果要将机器部署到预先存在的网络中,则会置备 RHOSP 子网。
- 如果要在安装程序置备的网络中部署机器,RHOSP Bare Metal 服务(Ironic)可以侦听在租户网络上运行的 Preboot eXecution Environment(PXE)引导机器并与之交互。
-
作为 OpenShift Container Platform 安装过程的一部分,创建了
inventory.yaml
文件。
流程
在
inventory.yaml
文件中,编辑机器的类别:-
如果要使用裸机 control plane 机器,请将
os_flavor_master
的值改为裸机类型。 将值 of
os_flavor_worker
更改为裸机类型。裸机
inventory.yaml
文件示例all: hosts: localhost: ansible_connection: local ansible_python_interpreter: "{{ansible_playbook_python}}" # User-provided values os_subnet_range: '10.0.0.0/16' os_flavor_master: 'my-bare-metal-flavor' 1 os_flavor_worker: 'my-bare-metal-flavor' 2 os_image_rhcos: 'rhcos' os_external_network: 'external' ...
-
如果要使用裸机 control plane 机器,请将
使用更新的 inventory.yaml
文件完成安装过程。部署期间创建的机器使用添加到该文件中的类别。
在等待裸机引导时,安装程序可能会超时。
如果安装程序超时,重启并使用安装程序的 wait-for
命令完成部署。例如:
$ ./openshift-install wait-for install-complete --log-level debug
18.8.18. 在 RHOSP 上创建 bootstrap 机器
创建 bootstrap 机器,为其提供在 Red Hat OpenStack Platform(RHOSP)上运行所需的网络访问权限。红帽提供了一个 Ansible playbook,您可以运行它来简化此过程。
先决条件
- 下载了"下载 playbook 依赖项"中的模块。
- 下载了"下载安装 playbook"中的 playbook。
-
inventory.yaml
、common.yaml
和bootstrap.yaml
Ansible playbook 位于一个通用目录中。 -
安装程序创建的
metadata.json
文件与 Ansible playbook 位于同一个目录中。
流程
- 在命令行中,将工作目录更改为 playbook 的位置。
在命令行中运行
bootstrap.yaml
playbook:$ ansible-playbook -i inventory.yaml bootstrap.yaml
bootstrap 服务器活跃后,查看日志以验证是否收到 Ignition 文件:
$ openstack console log show "$INFRA_ID-bootstrap"
18.8.19. 在 RHOSP 上创建 control plane 机器
使用您生成的 Ignition 配置文件创建三台 control plane 机器。红帽提供了一个 Ansible playbook,您可以运行它来简化此过程。
先决条件
- 下载了"下载 playbook 依赖项"中的模块。
- 下载了"下载安装 playbook"中的 playbook。
-
来自安装程序元数据文件中的基础架构 ID 被设置为环境变量(
$INFRA_ID
)。 -
inventory.yaml
、common.yaml
和control-plane.yaml
Ansible playbook 位于一个通用目录中。 - 您有三个在"Creating control plane Ignition 配置文件"中创建的 Ignition 文件。
流程
- 在命令行中,将工作目录更改为 playbook 的位置。
- 如果 control plane Ignition 配置文件尚未位于工作目录中,请将它们复制到其中。
在命令行中运行
control-plane.yaml
playbook:$ ansible-playbook -i inventory.yaml control-plane.yaml
运行以下命令来监控 bootstrap 过程:
$ openshift-install wait-for bootstrap-complete
您将看到确认 control plane 机器正在运行并加入集群的信息:
INFO API v1.23.0 up INFO Waiting up to 30m0s for bootstrapping to complete... ... INFO It is now safe to remove the bootstrap resources
18.8.20. 使用 CLI 登录集群
您可以通过导出集群 kubeconfig
文件,以默认系统用户身份登录集群。kubeconfig
文件包含有关集群的信息,供 CLI 用于将客户端连接到正确的集群和 API 服务器。该文件特定于集群,在 OpenShift Container Platform 安装过程中创建。
先决条件
- 已部署 OpenShift Container Platform 集群。
-
已安装
oc
CLI。
流程
导出
kubeadmin
凭证:$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
- 1
- 对于
<installation_directory>
,请指定安装文件保存到的目录的路径。
验证您可以使用导出的配置成功运行
oc
命令:$ oc whoami
输出示例
system:admin
18.8.21. 从 RHOSP 删除 bootstrap 资源
删除您不再需要的 bootstrap 资源。
先决条件
- 下载了"下载 playbook 依赖项"中的模块。
- 下载了"下载安装 playbook"中的 playbook。
-
inventory.yaml
、common.yaml
和down-bootstrap.yaml
Ansible playbook 位于一个通用目录中。 control plane 机器正在运行。
- 如果您不知道机器的状态,请参阅"验证集群状态"。
流程
- 在命令行中,将工作目录更改为 playbook 的位置。
在命令行中运行
down-bootstrap.yaml
playbook:$ ansible-playbook -i inventory.yaml down-bootstrap.yaml
bootstrap 端口、服务器和浮动 IP 地址会被删除。
如果您之前没有禁用 bootstrap Ignition 文件 URL,现在需要禁用。
18.8.22. 为计算机器创建 SR-IOV 网络
如果您的 Red Hat OpenStack Platform(RHOSP)部署支持 单根 I/O 虚拟化(SR-IOV),您可以置备计算机器在其上运行的 SR-IOV 网络。
以下说明将创建外部扁平网络和一个可附加到计算机器的外部基于 VLAN 的网络。根据您的 RHOSP 部署,可能需要其他网络类型。
先决条件
集群支持 SR-IOV。
注意如果您不确定集群支持什么,请参阅 OpenShift Container Platform SR-IOV 硬件网络文档。
-
作为 RHOSP 部署的一部分,您创建了 Radio 和 uplink 提供商网络。所有示例命令都使用名称
Radio
和uplink 来
代表这些网络。
流程
在命令行中创建一个单体 RHOSP 网络:
$ openstack network create radio --provider-physical-network radio --provider-network-type flat --external
创建 uplink RHOSP 网络:
$ openstack network create uplink --provider-physical-network uplink --provider-network-type vlan --external
为无线网络创建子网:
$ openstack subnet create --network radio --subnet-range <radio_network_subnet_range> radio
为 uplink 网络创建一个子网:
$ openstack subnet create --network uplink --subnet-range <uplink_network_subnet_range> uplink
18.8.23. 创建在 SR-IOV 网络中运行的计算机器
启动 control plane 后,创建在"为计算机器创建 SR-IOV 网络"中创建的 SR-IOV 网络上运行的计算机器。
先决条件
- 下载了"下载 playbook 依赖项"中的模块。
- 下载了"下载安装 playbook"中的 playbook。
-
安装程序创建的
metadata.yaml
文件与 Ansible playbook 位于同一个目录中。 - control plane 处于活跃状态。
-
如"为计算机器创建 SR-IOV 网络"中所述,创建了
radio
和uplink
SR-IOV 网络。
流程
-
在命令行中,将工作目录改为
inventory.yaml
和common.yaml
文件的位置。 使用
additionalNetworks
参数将无线
和uplink
网络添加到inventory.yaml
文件的末尾:.... # If this value is non-empty, the corresponding floating IP will be # attached to the bootstrap machine. This is needed for collecting logs # in case of install failure. os_bootstrap_fip: '203.0.113.20' additionalNetworks: - id: radio count: 4 1 type: direct port_security_enabled: no - id: uplink count: 4 2 type: direct port_security_enabled: no
将
compute-nodes.yaml
文件的内容替换为以下文本:例 18.1.
compute-nodes.yaml
- import_playbook: common.yaml - hosts: all gather_facts: no vars: worker_list: [] port_name_list: [] nic_list: [] tasks: # Create the SDN/primary port for each worker node - name: 'Create the Compute ports' os_port: name: "{{ item.1 }}-{{ item.0 }}" network: "{{ os_network }}" security_groups: - "{{ os_sg_worker }}" allowed_address_pairs: - ip_address: "{{ os_ingressVIP }}" with_indexed_items: "{{ [os_port_worker] * os_compute_nodes_number }}" register: ports # Tag each SDN/primary port with cluster name - name: 'Set Compute ports tag' command: cmd: "openstack port set --tag {{ cluster_id_tag }} {{ item.1 }}-{{ item.0 }}" with_indexed_items: "{{ [os_port_worker] * os_compute_nodes_number }}" - name: 'List the Compute Trunks' command: cmd: "openstack network trunk list" when: os_networking_type == "Kuryr" register: compute_trunks - name: 'Create the Compute trunks' command: cmd: "openstack network trunk create --parent-port {{ item.1.id }} {{ os_compute_trunk_name }}-{{ item.0 }}" with_indexed_items: "{{ ports.results }}" when: - os_networking_type == "Kuryr" - "os_compute_trunk_name|string not in compute_trunks.stdout" - name: ‘Call additional-port processing’ include_tasks: additional-ports.yaml # Create additional ports in OpenStack - name: ‘Create additionalNetworks ports’ os_port: name: "{{ item.0 }}-{{ item.1.name }}" vnic_type: "{{ item.1.type }}" network: "{{ item.1.uuid }}" port_security_enabled: "{{ item.1.port_security_enabled|default(omit) }}" no_security_groups: "{{ 'true' if item.1.security_groups is not defined else omit }}" security_groups: "{{ item.1.security_groups | default(omit) }}" with_nested: - "{{ worker_list }}" - "{{ port_name_list }}" # Tag the ports with the cluster info - name: 'Set additionalNetworks ports tag' command: cmd: "openstack port set --tag {{ cluster_id_tag }} {{ item.0 }}-{{ item.1.name }}" with_nested: - "{{ worker_list }}" - "{{ port_name_list }}" # Build the nic list to use for server create - name: Build nic list set_fact: nic_list: "{{ nic_list | default([]) + [ item.name ] }}" with_items: "{{ port_name_list }}" # Create the servers - name: 'Create the Compute servers' vars: worker_nics: "{{ [ item.1 ] | product(nic_list) | map('join','-') | map('regex_replace', '(.*)', 'port-name=\\1') | list }}" os_server: name: "{{ item.1 }}" image: "{{ os_image_rhcos }}" flavor: "{{ os_flavor_worker }}" auto_ip: no userdata: "{{ lookup('file', 'worker.ign') | string }}" security_groups: [] nics: "{{ [ 'port-name=' + os_port_worker + '-' + item.0|string ] + worker_nics }}" config_drive: yes with_indexed_items: "{{ worker_list }}"
将以下内容插入到名为
additional-ports.yaml
的本地文件中:例 18.2.
additional-ports.yaml
# Build a list of worker nodes with indexes - name: ‘Build worker list’ set_fact: worker_list: "{{ worker_list | default([]) + [ item.1 + '-' + item.0 | string ] }}" with_indexed_items: "{{ [ os_compute_server_name ] * os_compute_nodes_number }}" # Ensure that each network specified in additionalNetworks exists - name: ‘Verify additionalNetworks’ os_networks_info: name: "{{ item.id }}" with_items: "{{ additionalNetworks }}" register: network_info # Expand additionalNetworks by the count parameter in each network definition - name: ‘Build port and port index list for additionalNetworks’ set_fact: port_list: "{{ port_list | default([]) + [ { 'net_name' : item.1.id, 'uuid' : network_info.results[item.0].openstack_networks[0].id, 'type' : item.1.type|default('normal'), 'security_groups' : item.1.security_groups|default(omit), 'port_security_enabled' : item.1.port_security_enabled|default(omit) } ] * item.1.count|default(1) }}" index_list: "{{ index_list | default([]) + range(item.1.count|default(1)) | list }}" with_indexed_items: "{{ additionalNetworks }}" # Calculate and save the name of the port # The format of the name is cluster_name-worker-workerID-networkUUID(partial)-count # i.e. fdp-nz995-worker-1-99bcd111-1 - name: ‘Calculate port name’ set_fact: port_name_list: "{{ port_name_list | default([]) + [ item.1 | combine( {'name' : item.1.uuid | regex_search('([^-]+)') + '-' + index_list[item.0]|string } ) ] }}" with_indexed_items: "{{ port_list }}" when: port_list is defined
在命令行中运行
compute-nodes.yaml
playbook:$ ansible-playbook -i inventory.yaml compute-nodes.yaml
18.8.24. 批准机器的证书签名请求
当您将机器添加到集群时,会为您添加的每台机器生成两个待处理证书签名请求(CSR)。您必须确认这些 CSR 已获得批准,或根据需要自行批准。必须首先批准客户端请求,然后批准服务器请求。
先决条件
- 您已将机器添加到集群中。
流程
确认集群可以识别这些机器:
$ oc get nodes
输出示例
NAME STATUS ROLES AGE VERSION master-0 Ready master 63m v1.23.0 master-1 Ready master 63m v1.23.0 master-2 Ready master 64m v1.23.0
输出中列出了您创建的所有机器。
注意在有些 CSR 被批准前,前面的输出可能不包括计算节点(也称为 worker 节点)。
检查待处理的 CSR,并确保添加到集群中的每台机器都有
Pending
或Approved
状态的客户端请求:$ oc get csr
输出示例
NAME AGE REQUESTOR CONDITION csr-8b2br 15m system:serviceaccount:openshift-machine-config-operator:node-bootstrapper Pending csr-8vnps 15m system:serviceaccount:openshift-machine-config-operator:node-bootstrapper Pending ...
在本例中,两台机器加入集群。您可能会在列表中看到更多已批准的 CSR。
如果 CSR 没有获得批准,在您添加的机器的所有待处理 CSR 都处于
Pending 状态
后,请批准集群机器的 CSR:注意由于 CSR 会自动轮转,因此请在将机器添加到集群后一小时内批准您的 CSR。如果没有在一小时内批准它们,证书将会轮转,每个节点会存在多个证书。您必须批准所有这些证书。批准客户端 CSR 后,Kubelet 为服务证书创建一个二级 CSR,这需要手动批准。然后,如果 Kubelet 请求具有相同参数的新证书,则后续提供证书续订请求由
machine-approver
自动批准。注意对于在未启用机器 API 的平台上运行的集群,如裸机和其他用户置备的基础架构,您必须实施一种方法来自动批准 kubelet 提供证书请求(CSR)。如果没有批准请求,则
oc exec
、ocrsh
和oc logs
命令将无法成功,因为 API 服务器连接到 kubelet 时需要服务证书。与 Kubelet 端点联系的任何操作都需要此证书批准。该方法必须监视新的 CSR,确认 CSR 由 system:node
或system:admin
组中的node-bootstrapper
服务帐户提交,并确认节点的身份。要单独批准,请对每个有效的 CSR 运行以下命令:
$ oc adm certificate approve <csr_name> 1
- 1
<csr_name>
是当前 CSR 列表中 CSR 的名称。
要批准所有待处理的 CSR,请运行以下命令:
$ oc get csr -o go-template='{{range .items}}{{if not .status}}{{.metadata.name}}{{"\n"}}{{end}}{{end}}' | xargs --no-run-if-empty oc adm certificate approve
注意在有些 CSR 被批准前,一些 Operator 可能无法使用。
现在,您的客户端请求已被批准,您必须查看添加到集群中的每台机器的服务器请求:
$ oc get csr
输出示例
NAME AGE REQUESTOR CONDITION csr-bfd72 5m26s system:node:ip-10-0-50-126.us-east-2.compute.internal Pending csr-c57lv 5m26s system:node:ip-10-0-95-157.us-east-2.compute.internal Pending ...
如果剩余的 CSR 没有被批准,且处于
Pending
状态,请批准集群机器的 CSR:要单独批准,请对每个有效的 CSR 运行以下命令:
$ oc adm certificate approve <csr_name> 1
- 1
<csr_name>
是当前 CSR 列表中 CSR 的名称。
要批准所有待处理的 CSR,请运行以下命令:
$ oc get csr -o go-template='{{range .items}}{{if not .status}}{{.metadata.name}}{{"\n"}}{{end}}{{end}}' | xargs oc adm certificate approve
批准所有客户端和服务器 CSR 后,机器将
处于 Ready 状态
。运行以下命令验证:$ oc get nodes
输出示例
NAME STATUS ROLES AGE VERSION master-0 Ready master 73m v1.23.0 master-1 Ready master 73m v1.23.0 master-2 Ready master 74m v1.23.0 worker-0 Ready worker 11m v1.23.0 worker-1 Ready worker 11m v1.23.0
注意批准服务器 CSR 后可能需要几分钟时间让机器过渡到
Ready 状态
。
其他信息
- 如需有关 CSR 的更多信息,请参阅 证书签名请求。
18.8.25. 验证安装是否成功
验证 OpenShift Container Platform 安装已经完成。
先决条件
-
有安装程序(openshift
-install
)
流程
在命令行中输入:
$ openshift-install --log-level debug wait-for install-complete
程序输出控制台 URL,以及管理员的登录信息。
群集运行正常。但是,在为 SR-IOV 网络配置它之前,您必须执行额外的任务。
18.8.26. 为 SR-IOV 准备在 RHOSP 上运行的集群
在 Red Hat OpenStack Platform (RHOSP)上运行的集群上使用单个根 I/O 虚拟化(SR-IOV )前,请将 RHOSP 元数据服务作为驱动器进行挂载,并为虚拟功能 I/O(VFIO)驱动程序启用 No-IOMMU Operator。
18.8.26.1. 将 RHOSP 元数据服务启用为可挂载驱动器
您可以将机器配置应用到机器池,以便 Red Hat OpenStack Platform(RHOSP)元数据服务作为可挂载的驱动器提供。
以下机器配置启用 SR-IOV Network Operator 中的 RHOSP 网络 UUID。此配置简化了 SR-IOV 资源与集群 SR-IOV 资源的关联。
流程
从以下模板创建机器配置文件:
可挂载的元数据服务机器配置文件
kind: MachineConfig apiVersion: machineconfiguration.openshift.io/v1 metadata: name: 20-mount-config 1 labels: machineconfiguration.openshift.io/role: worker spec: config: ignition: version: 3.2.0 systemd: units: - name: create-mountpoint-var-config.service enabled: true contents: | [Unit] Description=Create mountpoint /var/config Before=kubelet.service [Service] ExecStart=/bin/mkdir -p /var/config [Install] WantedBy=var-config.mount - name: var-config.mount enabled: true contents: | [Unit] Before=local-fs.target [Mount] Where=/var/config What=/dev/disk/by-label/config-2 [Install] WantedBy=local-fs.target
- 1
- 您可以替换您选择的名称。
在命令行中应用机器配置:
$ oc apply -f <machine_config_file_name>.yaml
18.8.26.2. 为 RHOSP VFIO 驱动程序启用 No-IOMMU 功能
您可以将机器配置应用到机器池,为 Red Hat OpenStack Platform(RHOSP)虚拟功能 I/O(VFIO)驱动程序启用 No-IOMMU 功能。RHOSP vfio-pci 驱动程序需要此功能。
流程
从以下模板创建机器配置文件:
No-IOMMU VFIO 机器配置文件
kind: MachineConfig apiVersion: machineconfiguration.openshift.io/v1 metadata: name: 99-vfio-noiommu 1 labels: machineconfiguration.openshift.io/role: worker spec: config: ignition: version: 3.2.0 storage: files: - path: /etc/modprobe.d/vfio-noiommu.conf mode: 0644 contents: source: data:;base64,b3B0aW9ucyB2ZmlvIGVuYWJsZV91bnNhZmVfbm9pb21tdV9tb2RlPTEK
- 1
- 您可以替换您选择的名称。
在命令行中应用机器配置:
$ oc apply -f <machine_config_file_name>.yaml
将机器配置应用到机器池后,您可以 监控机器配置池状态 以查看机器是否可用。
安装集群并为 SR-IOV 配置做好准备。现在,您必须在"下一步"中执行 SR-IOV 配置任务。
18.8.27. OpenShift Container Platform 的 Telemetry 访问
在 OpenShift Container Platform 4.10 中,默认运行的 Telemetry 服务提供有关集群健康状况和成功更新的指标,需要访问互联网。如果您的集群连接到互联网,Telemetry 会自动运行,而且集群会注册到 OpenShift Cluster Manager。
确认 OpenShift Cluster Manager 清单正确后,可以由 Telemetry 自动维护,也可以使用 OpenShift Cluster Manager 手动维护,使用订阅监控来跟踪帐户或多集群级别的 OpenShift Container Platform 订阅。
其他资源
- 有关 Telemetry 服务的更多信息,请参阅关于 远程健康监控
18.8.28. 其他资源
18.8.29. 后续步骤
为集群完成 SR-IOV 配置:
- 自定义集群。
- 如果需要,您可以选择 不使用远程健康报告。
- 如果您需要启用对节点端口的外部访问,请使用节点端口配置集群流量。
- 如果您没有将 RHOSP 配置为接受通过浮动 IP 地址的应用程序流量,请使用 浮动 IP 地址配置 RHOSP 访问。