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

IBM Power的安装配置参数

在部署 OpenShift Container Platform 集群之前，您需要提供一个自定义的 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 参数值的组合，使用 <metadata.name>.<baseDomain> 格式。

完全限定的域名或子域名，例如 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 集群管理器获取 pull secret 以验证从 Quay.io 等服务下载 OpenShift Container Platform 组件的容器镜像。

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

网络配置参数

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

在为集群配置网络参数之前，请考虑以下信息

  • 如果您使用 Red Hat OpenShift Networking OVN-Kubernetes 网络插件，则支持 IPv4 和 IPv6 地址族。

  • 如果您在支持 IPv4 和非链路本地 IPv6 地址的网络中部署了 OpenShift Container Platform 集群中的节点，请将集群配置为使用双栈网络。

    • 对于配置为双栈网络的集群，IPv4 和 IPv6 流量都必须使用与默认网关相同的网络接口。这确保了在多网络接口控制器 (NIC) 环境中，集群可以根据可用的网络接口检测要使用的 NIC。有关更多信息，请参阅关于 OVN-Kubernetes 网络插件中的“OVN-Kubernetes IPv6 和双栈限制”。

    • 为避免网络连接问题，请不要在支持双栈网络的主机上安装单栈 IPv4 集群。

如果您将集群配置为使用两个 IP 地址族，请查看以下要求

  • 两个 IP 地址族都必须为默认网关使用相同的网络接口。

  • 两个 IP 地址族都必须具有默认网关。

  • 您必须以相同的顺序为所有网络配置参数指定 IPv4 和 IPv6 地址。例如，在以下配置中，IPv4 地址列在 IPv6 地址之前。

    networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  - cidr: fd00:10:128::/56
    hostPrefix: 64
  serviceNetwork:
  - 172.30.0.0/16
  - fd00:172:16::/112
表 2. 网络参数
参数 描述 值 
networking:

集群网络的配置。

对象

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

 
networking:
  networkType:

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

OVNKubernetes。OVNKubernetes 是用于 Linux 网络和包含 Linux 和 Windows 服务器的混合网络的 CNI 插件。默认值为 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 地址块。

如果指定多个 IP 地址块，则这些块不能重叠。

如果指定多个 IP 内核参数，则 machineNetwork.cidr 值必须是主网络的 CIDR。

对象的数组。例如

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 网络块。

例如，10.0.0.0/16。

将 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:
  name:

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

worker

 
compute:
  platform:

如果使用compute，则为必填项。使用此参数指定托管 worker 机器的云提供商。此参数值必须与controlPlane.platform参数值匹配。

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

 
compute:
  replicas:

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

大于或等于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参数值匹配。

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

 
controlPlane:
  replicas:

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

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

 
credentialsMode:

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

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

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

 
fips:

启用或禁用 FIPS 模式。默认为false（禁用）。如果启用 FIPS 模式，则 OpenShift Container Platform 运行的 Red Hat Enterprise Linux CoreOS (RHCOS) 机器将绕过默认的 Kubernetes 加密套件，并改用随 RHCOS 提供的加密模块。

要为您的集群启用 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 核心组件仅在 x86_64、ppc64le 和 s390x 体系结构上使用已提交给 NIST 进行 FIPS 140-2/140-3 验证的 RHEL 加密库。

如果您使用 Azure 文件存储，则无法启用 FIPS 模式。

false 或 true

 
imageContentSources:

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

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

 
imageContentSources:
  source:

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

字符串

 
imageContentSources:
  mirrors:

指定可能也包含相同镜像的一个或多个存储库。

字符串数组

 
publish:

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

Internal 或 External。默认值为External。

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

如果字段的值设置为Internal，则集群将无法正常工作。更多信息，请参考BZ#1953035。

 
sshKey:

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

对于要执行安装调试或灾难恢复的生产 OpenShift Container Platform 集群，请指定您的ssh-agent进程使用的 SSH 密钥。

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