OpenShift 文档正在迁移，很快将仅在 docs.redhat.com（所有 Red Hat 产品文档的中心）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

IBM Power 虚拟服务器的安装配置参数

在 IBM Power® 虚拟服务器上部署 OpenShift Container Platform 之前，您需要提供参数来自定义集群及其所在的平台。创建 `install-config.yaml` 文件时，您可以通过命令行提供必需参数的值。然后，您可以修改 `install-config.yaml` 文件以进一步自定义集群。

IBM Power 虚拟服务器可用的安装配置参数

下表指定了作为安装过程的一部分可以设置的必需、可选和 IBM Power 虚拟服务器特定的安装配置参数。

安装后，您不能修改 `install-config.yaml` 文件中的这些参数。

必需的配置参数

下表描述了必需的安装配置参数

表 1. 必需参数
参数 描述 值 
apiVersion:

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

字符串

 
baseDomain:

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

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

 
metadata:

Kubernetes 资源 `ObjectMeta`，其中只使用 `name` 参数。

对象

 
metadata:
  name:

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

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

 
platform:

执行安装的特定平台的配置：aws、baremetal、azure、gcp、ibmcloud、nutanix、openstack、powervs、vsphere 或 {}。有关 platform.<platform> 参数的更多信息，请参阅以下特定平台的表格。

对象

 
pullSecret:

获取一个来自 Red Hat OpenShift 集群管理器的拉取密钥，以验证从 Quay.io 等服务下载 OpenShift Container Platform 组件的容器镜像。

 
{
   "auths":{
      "cloud.openshift.com":{
         "auth":"b3Blb=",
         "email":"[email protected]"
      },
      "quay.io":{
         "auth":"b3Blb=",
         "email":"[email protected]"
      }
   }
}
 
platform:
  powervs:
    userID:

用户 ID 是用户的 IBM Cloud® 帐户的登录名。

字符串。例如，existing_user_id。

 
platform:
  powervs:
    powervsResourceGroup:

PowerVSResourceGroup 是创建 IBM Power® 虚拟服务器资源的资源组。如果使用现有 VPC，则现有 VPC 和子网应位于此资源组中。

字符串。例如，existing_resource_group。

 
platform:
  powervs:
    region:

指定将在其中创建集群的 IBM Cloud® 机房区域。

字符串。例如，existing_region。

 
platform:
  powervs:
    zone:

指定将在其中创建集群的 IBM Cloud® 机房区域。

字符串。例如，existing_zone。

网络配置参数

您可以根据现有网络基础设施的要求自定义安装配置。例如，您可以扩展集群网络的 IP 地址块，或提供与默认值不同的 IP 地址块。

仅支持 IPv4 地址。

表 2. 网络参数
参数 描述 值 
networking:

集群网络的配置。

对象

安装后，您无法修改 networking 对象指定的参数。

 
networking:
  networkType:

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

默认值为 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，则每个节点都将从给定的 cidr 分配一个 /23 子网。hostPrefix 值为 23 提供 510 (2^(32 - 23) - 2) 个 Pod IP 地址。

子网前缀。

默认值为 23。

 
networking:
  serviceNetwork:

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

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® 虚拟服务器以外的所有平台，默认值为 10.0.0.0/16。对于 libvirt，默认值为 192.168.126.0/24。对于 IBM Power® 虚拟服务器，默认值为 192.168.0.0/24。

CIDR 表示法中的 IP 网络块。

例如，192.168.0.0/24。

将 networking.machineNetwork 设置为与首选 NIC 所在的 CIDR 匹配。

可选配置参数

下表描述了可选安装配置参数

表 3. 可选参数
参数 描述 值 
additionalTrustBundle:

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

字符串

 
capabilities:

控制可选核心集群组件的安装。您可以通过禁用可选组件来减小 OpenShift Container Platform 集群的占用空间。有关更多信息，请参阅《安装》中的“集群功能”页面。

字符串数组

 
capabilities:
  baselineCapabilitySet:

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

字符串

 
capabilities:
  additionalEnabledCapabilities:

扩展超出您在 baselineCapabilitySet 中指定的可选功能集。您可以在此参数中指定多个功能。

字符串数组

 
cpuPartitioningMode:

启用工作负载分区，这将隔离 OpenShift Container Platform 服务、集群管理工作负载和基础设施 Pod 以在保留的 CPU 集上运行。工作负载分区只能在安装期间启用，安装后无法禁用。虽然此字段启用了工作负载分区，但它不会配置工作负载以使用特定 CPU。有关更多信息，请参阅《可扩展性和性能》部分中的《工作负载分区》页面。

None 或 AllNodes。None 是默认值。

 
compute:

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

MachinePool 对象的数组。

 
compute:
  architecture:

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

字符串

 
compute:
  hyperthreading:

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

如果禁用同时多线程，请确保您的容量规划考虑了机器性能的急剧下降。

Enabled 或 Disabled

 
compute:
  smtLevel:

SMTLevel 指定要设置为控制平面和计算机的 SMT 级别。有效值为 1、2、3、4、5、6、7、8、off 和 on。

字符串

 
compute:
  name:

如果使用 compute，则为必需。机器池的名称。

worker

 
compute:
  platform:

如果使用 compute，则为必需。使用此参数指定托管工作机器的云提供商。此参数值必须与 controlPlane.platform 参数值匹配。例如，compute.platform.powervs.sysType。

aws、azure、gcp、ibmcloud、nutanix、openstack、powervs、vsphere 或 {}

 
compute:
  replicas:

要配置的计算机器（也称为工作机器）的数量。

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

 
featureSet:

为功能集启用集群。功能集是默认情况下未启用的 OpenShift Container Platform 功能的集合。有关在安装期间启用功能集的更多信息，请参阅“使用功能门启用功能”。

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

 
controlPlane:

构成控制平面的机器的配置。

MachinePool 对象的数组。

 
controlPlane:
  architecture:

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

字符串

 
controlPlane:
  hyperthreading:

是否启用或禁用控制平面机器上的同时多线程处理（或称超线程）。默认情况下，启用同时多线程处理以提高机器内核的性能。

如果禁用同时多线程，请确保您的容量规划考虑了机器性能的急剧下降。

Enabled 或 Disabled

 
controlPlane:
  name:

如果您使用controlPlane，则此项为必填。机器池的名称。

master

 
controlPlane:
  platform:

如果您使用controlPlane，则此项为必填。使用此参数指定托管控制平面机器的云提供商。此参数值必须与compute.platform参数值匹配。例如：controlPlane.platform.powervs.processors。

aws、azure、gcp、ibmcloud、nutanix、openstack、powervs、vsphere 或 {}

 
controlPlane:
  replicas:

要配置的控制平面机器数量。

支持的值为3，或在部署单节点 OpenShift 时为1。

 
credentialsMode:

云凭证操作员 (CCO) 模式。如果未指定模式，CCO 将动态尝试确定提供的凭据的功能，并在支持多种模式的平台上优先选择 mint 模式。

并非所有 CCO 模式都支持所有云提供商。有关 CCO 模式的更多信息，请参阅“身份验证和授权”内容中的“管理云提供商凭据”条目。

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

 
imageContentSources:

发行版镜像内容的来源和仓库。

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

 
imageContentSources:
  source:

如果您使用imageContentSources，则此项为必填。指定用户引用的仓库，例如，在镜像拉取规范中。

字符串

 
imageContentSources:
  mirrors:

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

字符串数组

 
publish:

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

Internal 或 External。默认值为External。

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

 
sshKey:

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

对于要执行安装调试或灾难恢复的生产 OpenShift Container Platform 集群，请指定您的ssh-agent进程使用的 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®名称。

字符串。例如：existing_vpcName。

 
platform:
  powervs:
    serviceInstanceGUID:

ServiceInstanceGUID 是从 IBM Cloud® 目录创建的 Power IAAS 实例的 ID。

字符串。例如：existing_service_instance_GUID。

 
platform:
  powervs:
    clusterOSImage:

ClusterOSImage 是预先创建的 IBM Power®虚拟服务器启动镜像，它会覆盖集群节点的默认镜像。

字符串。例如：existing_cluster_os_image。

 
platform:
  powervs:
    defaultMachinePlatform:

DefaultMachinePlatform 是在 IBM Power®虚拟服务器上安装时使用的默认配置，用于未定义自身平台配置的机器池。

字符串。例如：existing_machine_platform。

 
platform:
  powervs:
    memoryGiB:

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

有效整数必须是至少 2 GB，最多 64 GB 的整数（取决于机器类型）。

 
platform:
  powervs:
    procType:

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

有效值为 Capped、Dedicated 和 Shared。

 
platform:
  powervs:
    processors:

Processors 定义实例的处理单元。

处理器数量必须为 0.5 到 32 个内核。处理器必须以 0.25 为增量。

 
platform:
  powervs:
    sysType:

SysType 定义实例的系统类型。

系统类型必须为e980或s922。