第 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 为单位的虚拟机内存大小。 | 整数 |