4.6. 创建安装配置文件

apiVersion

install-config.yaml 内容的 API 版本。当前版本为 v1。安装程序可能还支持旧的 API 版本。

字符串

baseDomain

云供应商的基域。基域用于创建到 OpenShift Container Platform 集群组件的路由。集群的完整 DNS 名称是 baseDomain 和 metadata.name 参数值的组合，其格式为 <metadata.name>.<baseDomain>。

完全限定域名或子域名，如 example.com。

metadata

Kubernetes 资源 ObjectMeta，其中只消耗 name 参数。

对象

metadata.name

集群的名称。集群的 DNS 记录是 {{.metadata.name}}.{{.baseDomain}} 的子域。

小写字母、连字符(-)和句点(.)字符串，如 dev。

platform

要执行安装的具体平台配置： alibabacloud、aws、baremetal、azure、gcp、ibmcloud、nutanix、openstack、ovirt、powervs、vsphere 或 {}。有关 platform.<platform> 参数的更多信息，请参考下表中您的特定平台。

对象

pullSecret

从 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"
      }
   }
}

platform.powervs.userID

UserID 是用户的 IBM Cloud 帐户的登录。

字符串.例如，existing_user_id。

platform.powervs.powervsResourceGroup

PowerVSResourceGroup 是创建 IBM Power Virtual Server 资源的资源组。如果使用现有的 VPC，现有的 VPC 和子网应位于此资源组中。

字符串.例如： existing_resource_group。

platform.powervs.region

指定创建集群的 IBM Cloud colo 区域。

字符串.例如，existing_region。

platform.powervs.zone

指定创建集群的 IBM Cloud colo 区域。

字符串.例如： existing_zone。

platform.powervs.serviceInstanceID

ServiceInstanceID 是从 IBM Cloud Catalog 创建的 Power IAAS 实例的 ID。

字符串.例如，existing_service_instance_ID。

networking

集群网络的配置。

对象

networking.networkType

要安装的 Red Hat OpenShift Networking 网络插件。

默认值为 OVNKubernetes。

networking.clusterNetwork

pod 的 IP 地址块。

默认值为 10.128.0.0/14，主机前缀为 /23。

如果您指定了多个 IP 地址块，块不得重叠。

对象数组。例如：

networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23

networking.clusterNetwork.cidr

使用 networking.clusterNetwork 时需要此项。IP 地址块。

IPv4 网络。

无类别域间路由(CIDR)表示法中的 IP 地址块。IPv4 块的前缀长度介于 0 到 32 之间 。

networking.clusterNetwork.hostPrefix

分配给每个节点的子网前缀长度。例如，如果 hostPrefix 设为 23，则每个节点从 given cidr 中分配 a /23 子网。hostPrefix 值 23 提供 510（2^(32 - 23)- 2）pod IP 地址。

子网前缀。

默认值为 23。

networking.serviceNetwork

服务的 IP 地址块。默认值为 172.30.0.0/16。

OpenShift SDN 和 OVN-Kubernetes 网络插件只支持服务网络的一个 IP 地址块。

CIDR 格式具有 IP 地址块的数组。例如：

networking:
  serviceNetwork:
   - 172.30.0.0/16

networking.machineNetwork

机器的 IP 地址块。

对象数组。例如：

networking:
  machineNetwork:
  - cidr: 10.0.0.0/16

networking.machineNetwork.cidr

使用 networking.machineNetwork 时需要此项。IP 地址块。libvirt 和 IBM Power Virtual Server 以外的所有平台的默认值为 10.0.0.0/16。对于 libvirt，默认值 为 192.168.126.0/24。对于 IBM Power Virtual Server，默认值为 192.168.0.0/24。

CIDR 表示法中的 IP 网络块。

例如，192.168.0.0/24。

additionalTrustBundle

添加到节点可信证书存储中的 PEM 编码 X.509 证书捆绑包。配置了代理时，也可以使用此信任捆绑包。

字符串

功能

控制可选核心组件的安装。您可以通过禁用可选组件来减少 OpenShift Container Platform 集群的空间。如需更多信息，请参阅安装中的"集群功能"页面。

字符串数组

capabilities.baselineCapabilitySet

选择要启用的一组初始可选功能。有效值为 None、v4.11、v4.12 和 vCurrent。默认值为 vCurrent。

字符串

capabilities.additionalEnabledCapabilities

将可选功能集合扩展到您在 baselineCapabilitySet 中指定的范围。您可以在此参数中指定多个功能。

字符串数组

cpuPartitioningMode

启用工作负载分区，它会隔离 OpenShift Container Platform 服务、集群管理工作负载和基础架构 pod，以便在保留的一组 CPU 上运行。工作负载分区只能在安装过程中启用，且在安装后无法禁用。虽然此字段启用工作负载分区，但它不会将工作负载配置为使用特定的 CPU。如需更多信息，请参阅 Scalability and Performance 部分中的 Workload partitioning 页面。

None 或 AllNodes.None 是默认值。

Compute

组成计算节点的机器的配置。

MachinePool 对象的数组。

compute.architecture

决定池中机器的指令集合架构。目前不支持异构集群，因此所有池都必须指定相同的架构。有效值为 ppc64le （默认值）。

字符串

compute: 超线程：

是否在计算机器上启用或禁用并发多 线程或超线程。默认情况下，启用并发多线程以提高机器内核的性能。

enabled 或 Disabled

compute.name

使用 compute 时需要此项。机器池的名称。

worker

compute.platform

使用 compute 时需要此项。使用此参数指定托管 worker 机器的云供应商。此参数值必须与 controlPlane.platform 参数值匹配。示例用法，compute.platform.powervs.sysType.

alibabacloud,aws,azure,gcp,ibmcloud,nutanix,openstack,ovirt,powervs,vsphere, 或 {}

compute.replicas

要置备的计算机器数量，也称为 worker 机器。

大于或等于 2 的正整数。默认值为 3。

featureSet

为功能集启用集群。功能集是 OpenShift Container Platform 功能的集合，默认情况下不启用。有关在安装过程中启用功能集的更多信息，请参阅"使用功能门启用功能"。

字符串.要启用的功能集的名称，如 TechPreviewNoUpgrade。

controlPlane

组成 control plane 的机器的配置。

MachinePool 对象的数组。

controlPlane.architecture

决定池中机器的指令集合架构。目前不支持异构集群，因此所有池都必须指定相同的架构。有效值为 ppc64le （默认值）。

字符串

controlPlane: 超线程：

是否在 control plane 机器上启用或禁用并发多 线程或超线程。默认情况下，启用并发多线程以提高机器内核的性能。

enabled 或 Disabled

controlPlane.name

使用 controlPlane 时需要此项。机器池的名称。

master

controlPlane.platform

使用 controlPlane 时需要此项。使用此参数指定托管 control plane 机器的云供应商。此参数值必须与 compute.platform 参数值匹配。示例用法，controlPlane.platform.powervs.processors.

alibabacloud,aws,azure,gcp,ibmcloud,nutanix,openstack,ovirt,powervs,vsphere, 或 {}

controlPlane.replicas

要置备的 control plane 机器数量。

唯一支持的值是 3，这是默认值。

credentialsMode

Cloud Credential Operator(CCO)模式。如果没有指定模式，CCO 会动态尝试决定提供的凭证的功能，在支持多个模式的平台上首选 mint 模式。

Mint、Passthrough、Manual 或空字符串("")。

imageContentSources

release-image 内容的源和存储库。

对象数组。包括一个 source 以及可选的 mirrors，如本表的以下行所述。

imageContentSources.source

使用 imageContentSources 时需要此项。指定用户在镜像拉取规格中引用的存储库。

字符串

imageContentSources.mirrors

指定可能还包含同一镜像的一个或多个仓库。

字符串数组

publish

如何发布或公开集群的面向用户的端点，如 Kubernetes API、OpenShift 路由。

内部或外部 .默认值为 External。

非云平台不支持将此字段设置为 Internal。

sshKey

用于验证对集群机器的访问的 SSH 密钥。

例如，sshKey: ssh-ed25519 AAAA..。

platform.powervs.vpcRegion

指定在其中创建 VPC 资源的 IBM Cloud 区域。

字符串.例如： existing_vpc_region。

platform.powervs.vpcSubnets

指定创建集群资源的现有子网（按名称）。

字符串.例如，powervs_region_example_subnet。

platform.powervs.vpcName

指定 IBM Cloud VPC 名称。

字符串.例如： existing_vpcName。

platform.powervs.cloudConnectionName

CloudConnectionName 是现有 PowerVS 云连接的名称。

字符串.例如： existing_cloudConnectionName。

platform.powervs.clusterOSImage

ClusterOSImage 是一个预先创建的 IBM Power Virtual Server 引导镜像，用于覆盖集群节点的默认镜像。

字符串.例如： existing_cluster_os_image。

platform.powervs.defaultMachinePlatform

DefaultMachinePlatform 是在 IBM Power Virtual Server 上安装用于没有定义自身平台配置的机器池时使用的默认配置。

字符串.例如，existing_machine_platform。

platform.powervs.memoryGiB

虚拟机内存大小（以 GB 为单位）。

有效的整数必须是整数，长度至少为 2，没有超过 64 的整数，具体取决于机器类型。

platform.powervs.procType

ProcType 定义实例的处理器共享模型。

有效值为 Capped、Dedicated 和 Shared。

platform.powervs.processors

Processors 定义实例的处理单元。

处理器数量必须从 .5 到 32 个内核。处理器必须递增 .25。

platform.powervs.sysType

SysType 为实例定义系统类型。

系统类型必须是 e980 或 s922。