红帽全球峰会第 10 章 IBM Cloud 的安装配置参数
在 IBM Cloud® 上部署 OpenShift Container Platform 集群前，您可以提供参数来自定义集群以及托管它的平台。在创建 install-config.yaml 文件时，您可以通过命令行为所需参数提供值。然后，您可以修改 install-config.yaml 文件以进一步自定义集群。
10.1. IBM Cloud 可用的安装配置参数
下表指定您可以在安装过程中设置所需的、可选和 IBM Cloud 特定安装配置参数。
安装后，您无法更改 install-config.yaml 文件中的这些参数。
10.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 组件的容器镜像。 |
|
10.1.2. 网络配置参数
您可以根据现有网络基础架构的要求自定义安装配置。例如，您可以扩展集群网络的 IP 地址块，或者配置与默认值不同的 IP 地址块。
仅支持 IPv4 地址。
| 参数 | 描述 | 值 |
|---|---|---|
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 地址块。默认值为 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 网络块。
例如： 注意
将 |
networking:
ovnKubernetesConfig:
ipv4:
internalJoinSubnet:
|
配置 |
CIDR 表示法中的 IP 网络块。默认值为 |
10.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: hyperthreading: |
是否在计算机器上启用或禁用并发多 重要 如果您禁用并发多线程，请确保您的容量规划考虑机器性能显著降低的情况。 |
|
compute: name: |
使用 |
|
compute: platform: |
使用 |
|
compute: replicas: | 要置备的计算机器数量，也称为 worker 机器。 |
大于或等于 |
featureSet: | 为功能集启用集群。功能集是 OpenShift Container Platform 功能的集合，默认情况下不启用。有关在安装过程中启用功能集的更多信息，请参阅"使用功能门启用功能"。 |
字符串.要启用的功能集的名称，如 |
controlPlane: | 组成 control plane 的机器的配置。 |
|
controlPlane: architecture: |
决定池中机器的指令集合架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 | 字符串 |
controlPlane: hyperthreading: |
是否在 control plane 机器上启用或禁用并发多 重要 如果您禁用并发多线程，请确保您的容量规划考虑机器性能显著降低的情况。 |
|
controlPlane: name: |
使用 |
|
controlPlane: platform: |
使用 |
|
controlPlane: replicas: | 要置备的 control plane 机器数量。 |
部署单节点 OpenShift 时支持的值为 |
credentialsMode: | Cloud Credential Operator(CCO)模式。如果没有指定模式，CCO 会动态尝试决定提供的凭证的功能，在支持多个模式的平台上首选 mint 模式。 注意 不是所有 CCO 模式都支持所有云供应商。有关 CCO 模式的更多信息，请参阅身份验证和授权内容中的"管理云供应商凭证"条目。 |
|
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 集群，请指定 |
例如， |
10.1.4. 其他 IBM Cloud 配置参数
下表描述了其他 IBM Cloud® 配置参数：
| 参数 | 描述 | 值 |
|---|---|---|
controlPlane:
platform:
ibmcloud:
bootVolume:
encryptionKey:
| 一个 IBM® Key Protect for IBM Cloud® (Key Protect) root 密钥，应只用于加密 control plane 机器的 root (boot) 卷。 | root 密钥的 Cloud Resource Name (CRN)。 CRN 必须用引号 ("") 括起。 |
compute:
platform:
ibmcloud:
bootVolume:
encryptionKey:
| 一个 Key Protect root 密钥，应只用于加密计算机器的 root (boot) 卷。 | root 密钥的 CRN。 CRN 必须用引号 ("") 括起。 |
platform:
ibmcloud:
defaultMachinePlatform:
bootvolume:
encryptionKey:
| 一个 Key Protect root 密钥，应用于加密所有集群机器的 root (boot) 卷。 当作为默认机器配置的一部分指定时，所有受管存储类都会使用此密钥更新。安装后置备的数据卷也使用此密钥加密。 | root 密钥的 CRN。 CRN 必须用引号 ("") 括起。 |
platform:
ibmcloud:
resourceGroupName:
| 现有资源组的名称。默认情况下，会创建安装程序置备的 VPC 和集群资源，并放置在此资源组中。如果没有指定这些参数，安装程序会为集群创建资源组。
如果您要将集群部署到现有的 VPC 中，则安装-program-provisioned 集群资源将放置在此资源组中。如果没有指定这些参数，安装程序会为集群创建资源组。您置备的 VPC 资源必须存在于您使用 在这两种情况下，此资源组必须仅用于单个集群安装，因为集群组件假定资源组中所有资源的所有权 [1] |
字符串，如 |
platform:
ibmcloud:
serviceEndpoints:
- name:
url:
| 服务端点名称和 URI 列表。 默认情况下，安装程序和集群组件使用公共服务端点访问所需的 IBM Cloud® 服务。 如果网络限制限制对公共服务端点的访问，您可以指定一个备用服务端点来覆盖默认行为。 您只能为每个服务指定一个备用服务端点：
| 有效服务端点名称和完全限定的 URI。 有效名称包括：
|
platform:
ibmcloud:
networkResourceGroupName:
| 现有资源组的名称。此资源包含集群要部署到的现有 VPC 和子网。当将集群部署到已置备的 VPC 时，需要此参数。 |
字符串，如 |
platform:
ibmcloud:
dedicatedHosts:
profile:
|
要创建的新专用主机。如果您为 |
有效的 IBM Cloud® 专用主机配置文件，如 |
platform:
ibmcloud:
dedicatedHosts:
name:
|
存在一个现有的专用主机。如果您为 |
字符串，如 |
platform:
ibmcloud:
type:
| 所有 IBM Cloud® 机器的实例类型。 |
有效的 IBM Cloud® 实例类型，如 |
platform:
ibmcloud:
vpcName:
| 要将集群部署到的现有 VPC 的名称。 | 字符串. |
platform:
ibmcloud:
controlPlaneSubnets:
| 要将 control plane 机器部署到的 VPC 中现有子网的名称。为每个可用区指定一个子网。 | 字符串数组 |
platform:
ibmcloud:
computeSubnets:
| 要将计算机器部署到的 VPC 中现有子网的名称。为每个可用区指定一个子网。不支持子网 ID。 | 字符串数组 |
- 不论您定义现有资源组还是安装程序创建了资源组，都决定在卸载资源组时如何对待资源组。如果您定义了资源组，安装程序会删除所有安装程序置备的资源，但只保留资源组；如果资源组是作为安装的一部分创建，安装程序将删除所有安装程序置备的资源和资源组。
- 要确定哪个配置集最符合您的需要，请参阅 IBM® 文档中的实例配置集。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}