安装配置参数 - 在 IBM Z 和 IBM LinuxONE 上安装 | 安装 | OpenShift Container Platform 4.17

IBM Z 可用的安装配置参数

在部署 OpenShift Container Platform 集群之前，您需要提供一个自定义的 `install-config.yaml` 安装配置文件，其中描述了您环境的详细信息。

虽然本文档仅涉及 IBM Z®，但其中所有信息也适用于 IBM® LinuxONE。

IBM Z 可用的安装配置参数

下表指定了您可以在安装过程中设置的必需、可选和 IBM Z 特定的安装配置参数。

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

必需的配置参数

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

表 1. 必需参数
参数	描述	值
apiVersion:	`install-config.yaml` 内容的 API 版本。当前版本为 `v1`。安装程序也可能支持旧的 API 版本。	字符串
baseDomain:	云提供商的基本域。基本域用于创建到 OpenShift Container Platform 集群组件的路由。集群的完整 DNS 名称是 `<metadata.name>.<baseDomain>` 格式的 `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]" } } }`

网络配置参数

您可以根据现有网络基础设施的要求自定义安装配置。例如，您可以扩展集群网络的 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

参数描述值

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 以匹配首选网卡所在的 CIDR。

可选配置参数

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

参数描述值

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:

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

字符串

compute:
  hyperthreading:

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

如果禁用同时多线程处理，请确保您的容量规划已考虑机器性能的大幅下降。

Enabled 或 Disabled

compute:
  name:

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

worker

compute:
  platform:

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

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

compute:
  replicas:

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

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

featureSet:

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

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

controlPlane:

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

MachinePool 对象的数组。

controlPlane:
  architecture:

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

字符串

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..。

IBM Z 和 IBM LinuxONE 的安装配置参数

IBM Z 可用的安装配置参数

必需的配置参数

网络配置参数

可选配置参数