红帽全球峰会第 9 章 vSphere 的安装配置参数
在 vSphere 上部署 OpenShift Container Platform 集群前，您可以配置参数来自定义集群和托管它的平台。安装程序使用 install-config.yaml 文件中的信息来置备所需的基础架构并部署集群组件。在创建 install-config.yaml 文件时，您可以通过命令行配置所需参数的值。编辑 install-config.yaml 文件，以便在安装开始前进一步自定义集群。
9.1. vSphere 可用的安装配置参数
下表指定可设置为安装过程的一部分所需的、可选和特定于 vSphere 的安装配置参数。
安装后，您无法更改 install-config.yaml 文件中的这些参数。
9.1.1. 所需的配置参数
下表描述了所需的安装配置参数：
| 参数 | 描述 | 值 |
|---|---|---|
apiVersion: |
| 字符串 |
baseDomain: |
云供应商的基域。基域用于创建到 OpenShift Container Platform 集群组件的路由。集群的完整 DNS 名称是 |
完全限定域名或子域名，如 |
metadata: |
Kubernetes 资源 | 对象 |
metadata: name: |
集群的名称。集群的 DNS 记录是 |
小写字母和连字符 ( |
platform: |
要执行安装的具体平台配置： | 对象 |
pullSecret: | 从 Red Hat OpenShift Cluster Manager 获取 pull secret，验证从 Quay.io 等服务中下载 OpenShift Container Platform 组件的容器镜像。 |
|
9.1.2. 网络配置参数
您可以根据现有网络基础架构的要求自定义安装配置。例如，您可以扩展集群网络的 IP 地址块，或者配置与默认值不同的 IP 地址块。
- 如果使用 Red Hat OpenShift Networking OVN-Kubernetes 网络插件，则支持 IPv4 和 IPv6 地址系列。
- 如果您使用 Red Hat OpenShift Networking OpenShift SDN 网络插件，则只支持 IPv4 地址系列。
在 VMware vSphere 上，双栈网络可以指定 IPv4 或 IPv6 作为主要地址系列。
如果将集群配置为使用两个 IP 地址系列，请查看以下要求：
- 两个 IP 系列都必须将相同的网络接口用于默认网关。
- 两个 IP 系列都必须具有默认网关。
您必须为所有网络配置参数指定 IPv4 和 IPv6 地址。例如，以下配置 IPv4 地址列在 IPv6 地址的前面。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Red Hat OpenShift Data Foundation 灾难恢复解决方案不支持 Globalnet。对于区域灾难恢复场景，请确保为每个集群中的集群和服务网络使用非重叠的专用 IP 地址。
| 参数 | 描述 | 值 |
|---|---|---|
networking: | 集群网络的配置。 | 对象 注意
您不能在安装后更改 |
networking: networkType: | 要安装的 Red Hat OpenShift Networking 网络插件。 |
|
networking: clusterNetwork: | pod 的 IP 地址块。
默认值为 如果您指定了多个 IP 地址块，块不得重叠。 | 对象数组。例如： networking:
clusterNetwork:
- cidr: 10.128.0.0/14
hostPrefix: 23
|
networking:
clusterNetwork:
cidr:
|
使用 IPv4 网络。 |
无类别域间路由(CIDR)表示法中的 IP 地址块。IPv4 块的前缀长度介于 |
networking:
clusterNetwork:
hostPrefix:
|
分配给每个节点的子网前缀长度。例如，如果 | 子网前缀。
默认值为 |
networking: serviceNetwork: |
服务的 IP 地址块。默认值为 OpenShift SDN 和 OVN-Kubernetes 网络插件只支持服务网络的一个 IP 地址块。 | CIDR 格式具有 IP 地址块的数组。例如： networking: serviceNetwork: - 172.30.0.0/16 |
networking: machineNetwork: | 机器的 IP 地址块。 如果您指定了多个 IP 地址块，块不得重叠。 | 对象数组。例如： networking: machineNetwork: - cidr: 10.0.0.0/16 |
networking:
machineNetwork:
cidr:
|
使用 | CIDR 表示法中的 IP 网络块。
例如： 注意
将 |
9.1.3. 可选的配置参数
下表描述了可选的安装配置参数：
| 参数 | 描述 | 值 |
|---|---|---|
additionalTrustBundle: | 添加到节点可信证书存储中的 PEM 编码 X.509 证书捆绑包。配置代理时，也可以使用此信任捆绑包。 | 字符串 |
capabilities: | 控制可选核心组件的安装。您可以通过禁用可选组件来减少 OpenShift Container Platform 集群的空间。如需更多信息，请参阅安装中的"集群功能"页面。 | 字符串数组 |
capabilities: baselineCapabilitySet: |
选择要启用的一组初始可选功能。有效值为 | 字符串 |
capabilities: additionalEnabledCapabilities: |
将可选功能集合扩展到您在 | 字符串数组 |
cpuPartitioningMode: | 启用工作负载分区，它会隔离 OpenShift Container Platform 服务、集群管理工作负载和基础架构 pod，以便在保留的一组 CPU 上运行。您只能在安装过程中启用工作负载分区。您不能在安装后禁用它。虽然此字段启用工作负载分区，但它不会将工作负载配置为使用特定的 CPU。如需更多信息，请参阅 Scalability and Performance 部分中的 Workload partitioning 页面。 |
|
compute: | 组成计算节点的机器的配置。 |
|
compute: architecture: |
决定池中机器的指令集合架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 | 字符串 |
compute: name: |
使用 |
|
compute: platform: |
使用 |
|
compute: replicas: | 要置备的计算机器数量，也称为 worker 机器。 |
大于或等于 |
featureSet: | 为功能集启用集群。功能集是 OpenShift Container Platform 功能的集合，默认情况下不启用。有关在安装过程中启用功能集的更多信息，请参阅"使用功能门启用功能"。 |
字符串.要启用的功能集的名称，如 |
controlPlane: | 组成 control plane 的机器的配置。 |
|
controlPlane: architecture: |
决定池中机器的指令集合架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 | 字符串 |
controlPlane: name: |
使用 |
|
controlPlane: platform: |
使用 |
|
controlPlane: replicas: | 要置备的 control plane 机器数量。 |
部署单节点 OpenShift 时支持的值为 |
credentialsMode: | Cloud Credential Operator(CCO)模式。如果没有指定模式，CCO 会动态尝试决定提供的凭证的功能，在支持多个模式的平台上首选 mint 模式。 |
|
fips: |
启用或禁用 FIPS 模式。默认值为 重要 要为集群启用 FIPS 模式，您必须从配置为以 FIPS 模式操作的 Red Hat Enterprise Linux (RHEL) 计算机运行安装程序。有关在 RHEL 中配置 FIPS 模式的更多信息，请参阅 将 RHEL 切换到 FIPS 模式。 当以 FIPS 模式运行 Red Hat Enterprise Linux (RHEL) 或 Red Hat Enterprise Linux CoreOS (RHCOS)时，OpenShift Container Platform 核心组件使用 RHEL 加密库，在 x86_64、ppc64le 和 s390x 架构上提交到 NIST FIPS 140-2/140-3 Validation。 如果使用 Azure File 存储，则无法启用 FIPS 模式。 |
|
imageContentSources: | release-image 内容的源和存储库。 |
对象数组。包括一个 |
imageContentSources: source: |
使用 | 字符串 |
imageContentSources: mirrors: | 指定可能还包含同一镜像的一个或多个存储库。 | 字符串数组 |
publish: | 如何发布或公开集群的面向用户的端点，如 Kubernetes API、OpenShift 路由。 |
在非云平台上不支持将此字段设置为 重要
如果字段的值设为 |
sshKey: | 用于验证对集群机器的访问的 SSH 密钥。 注意
对于您要在其上执行安装调试或灾难恢复的生产环境 OpenShift Container Platform 集群，请指定 |
例如， |
- 不是所有 CCO 模式都支持所有云供应商。有关 CCO 模式的更多信息，请参阅身份验证和授权内容中的"管理云供应商凭证"条目。
9.1.4. 其他 VMware vSphere 配置参数
下表描述了其他 VMware vSphere 配置参数：
| 参数 | 描述 | 值 |
|---|---|---|
platform: vsphere: | 描述托管集群的云平台中的帐户。您可以使用参数来自定义平台。如果您为机器池中的 compute 和 control plane 机器提供额外的配置设置，则不需要该参数。您只能为 OpenShift Container Platform 集群指定一个 vCenter 服务器。 | vSphere 配置对象的字典 |
platform:
vsphere:
apiVIPs:
| 为 control plane API 访问配置的虚拟 IP (VIP) 地址。 注意 这个参数只适用于安装程序置备的基础架构，而无需配置外部负载均衡器。您不能在用户置备的基础架构中指定此参数。 | 多个 IP 地址 |
platform:
vsphere:
diskType:
| 可选：磁盘置备方法。如果没有设置，则默认值为 vSphere 默认存储策略。 |
有效值为 |
platform:
vsphere:
failureDomains:
|
建立地区和区域之间的关系。您可以使用 vCenter 对象（如 | 故障域配置对象的数组。 |
platform:
vsphere:
failureDomains:
name:
| 故障域的名称。 | 字符串 |
platform:
vsphere:
failureDomains:
region:
|
如果为集群定义多个故障域，则必须将标签附加到每个 vCenter 数据中心。要定义区域，请使用 | 字符串 |
platform:
vsphere:
failureDomains:
server:
|
指定 VMware vCenter 服务器的完全限定主机名或 IP 地址，以便客户端可以访问故障域资源。您必须将 | 字符串 |
platform:
vsphere:
failureDomains:
zone:
|
如果为集群定义多个故障域，则必须为每个 vCenter 集群附加标签。要定义一个区，请使用 | 字符串 |
platform:
vsphere:
failureDomains:
topology:
computeCluster:
| vSphere 计算集群的路径。 | 字符串 |
platform:
vsphere:
failureDomains:
topology:
datacenter:
|
列出并定义 OpenShift Container Platform 虚拟机 (VM) 操作的数据中心。数据中心列表必须与 | 字符串 |
platform:
vsphere:
failureDomains:
topology:
datastore:
|
指定为故障域存储虚拟机文件的 vSphere 数据存储的路径。您必须将 | 字符串 |
platform:
vsphere:
failureDomains:
topology:
folder:
|
可选：用户创建虚拟机的现有文件夹的绝对路径，例如 | 字符串 |
platform:
vsphere:
failureDomains:
topology:
networks:
| 列出 vCenter 实例中包含您配置的虚拟 IP 地址和 DNS 记录的任何网络。 | 字符串 |
platform:
vsphere:
failureDomains:
topology:
resourcePool:
|
可选：安装程序创建虚拟机的现有资源池的绝对路径，例如 | 字符串 |
platform:
vsphere:
failureDomains:
topology
template:
| 指定预先存在的 Red Hat Enterprise Linux CoreOS (RHCOS) 镜像模板或虚拟机的绝对路径。安装程序可以使用镜像模板或虚拟机在 vSphere 主机上快速安装 RHCOS。考虑使用此参数作为在 vSphere 主机上上传 RHCOS 镜像的替代选择。此参数仅适用于安装程序置备的基础架构。 | 字符串 |
platform:
vsphere:
ingressVIPs:
| 为集群 Ingress 配置的虚拟 IP (VIP) 地址。 注意 这个参数只适用于安装程序置备的基础架构，而无需配置外部负载均衡器。您不能在用户置备的基础架构中指定此参数。 | 多个 IP 地址 |
platform:
vsphere:
vcenters:
| 配置连接详情，以便服务可以与 vCenter 服务器通信。目前，只支持单个 vCenter 服务器。 | vCenter 配置对象的数组。 |
platform:
vsphere:
vcenters:
datacenters:
|
列出并定义 OpenShift Container Platform 虚拟机 (VM) 操作的数据中心。数据中心列表必须与 | 字符串 |
platform:
vsphere:
vcenters:
password:
| 与 vSphere 用户关联的密码。 | 字符串 |
platform:
vsphere:
vcenters:
port:
| 用于与 vCenter 服务器通信的端口号。 | 整数 |
platform:
vsphere:
vcenters:
server:
| vCenter 服务器的完全限定主机名(FQHN)或 IP 地址。 | 字符串 |
platform:
vsphere:
vcenters:
user:
| 与 vSphere 用户关联的用户名。 | 字符串 |
9.1.5. 弃用的 VMware vSphere 配置参数
在 OpenShift Container Platform 4.13 中，以下 vSphere 配置参数已弃用。您可以继续使用这些参数，但安装程序不会在 install-config.yaml 文件中自动指定这些参数。
下表列出了每个已弃用的 vSphere 配置参数：
| 参数 | 描述 | 值 |
|---|---|---|
platform:
vsphere:
apiVIP:
| 为 control plane API 访问配置的虚拟 IP(VIP)地址。 注意
在 OpenShift Container Platform 4.12 及更新的版本中， |
IP 地址，如 |
platform:
vsphere:
cluster:
| 安装 OpenShift Container Platform 集群的 vCenter 集群。 | 字符串 |
platform:
vsphere:
datacenter:
| 定义 OpenShift Container Platform 虚拟机 (VM) 操作的数据中心。 | 字符串 |
platform:
vsphere:
defaultDatastore:
| 用于调配卷的默认数据存储名称。 | 字符串 |
platform:
vsphere:
folder:
| 可选：安装程序创建虚拟机的现有文件夹的绝对路径。如果没有提供这个值，安装程序会创建一个文件夹，它的名称为 datacenter 虚拟机文件夹中的基础架构 ID。 |
字符串，如 |
platform:
vsphere:
ingressVIP:
| 为集群 Ingress 配置的虚拟 IP (VIP) 地址。 注意
在 OpenShift Container Platform 4.12 及更新的版本中， |
IP 地址，如 |
platform:
vsphere:
network:
| 包含您配置的虚拟 IP 地址和 DNS 记录的 vCenter 实例中的网络。 | 字符串 |
platform:
vsphere:
password:
| vCenter 用户名的密码。 | 字符串 |
platform:
vsphere:
resourcePool:
|
可选：安装程序创建虚拟机的现有资源池的绝对路径。如果没有指定值，安装程序会在 |
字符串，例如 |
platform:
vsphere:
username:
| 用于连接 vCenter 实例的用户名。此用户必须至少具有 vSphere 中 静态或动态持久性卷置备 所需的角色和权限。 | 字符串 |
platform:
vsphere:
vCenter:
| vCenter 服务器的完全限定主机名或 IP 地址。 | 字符串 |
9.1.6. 可选的 VMware vSphere 机器池配置参数
下表描述了可选的 VMware vSphere 机器池配置参数：
| 参数 | 描述 | 值 |
|---|---|---|
platform:
vsphere:
clusterOSImage:
| 安装程序从中下载 Red Hat Enterprise Linux CoreOS (RHCOS) 镜像的位置。在为此参数设置路径值前，请确保 OpenShift Container Platform 发行版本中的默认 RHCOS 引导镜像与 RHCOS 镜像模板或虚拟机版本匹配；否则，集群安装可能会失败。 |
HTTP 或 HTTPS URL，可选使用 SHA-256 校验和。例如： |
platform:
vsphere:
osDisk:
diskSizeGB:
| 以 GB 为单位的磁盘大小。 | 整数 |
platform:
vsphere:
cpus:
|
用于分配虚拟机的虚拟处理器内核总数。 | 整数 |
platform:
vsphere:
coresPerSocket:
|
虚拟机中的每个插槽的内核数，其中 | 整数 |
platform:
vsphere:
memoryMB:
| 以 MB 为单位的虚拟机内存大小。 | 整数 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}