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

裸金属安装配置参数

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

裸机可用的安装配置参数

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

安装后，您无法修改 `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 Cluster Manager 的 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
  - cidr: fd01::/48
    hostPrefix: 64
 
networking:
  clusterNetwork:
    cidr:

如果您使用 `networking.clusterNetwork`，则为必需项。IP 地址块。

如果您使用 OVN-Kubernetes 网络插件，则可以指定 IPv4 和 IPv6 网络。

无类别域间路由 (CIDR) 表示法中的 IP 地址块。IPv4 块的前缀长度在0和32之间。IPv6 块的前缀长度在0和128之间。例如，10.128.0.0/14或fd01::/48。

 
networking:
  clusterNetwork:
    hostPrefix:

分配给每个节点的子网前缀长度。例如，如果hostPrefix设置为23，则每个节点将分配一个/23子网，该子网来自给定的cidr。hostPrefix值为23提供510个 (2^(32 - 23) - 2) pod IP 地址。

子网前缀。

对于 IPv4 网络，默认值为23。对于 IPv6 网络，默认值为64。默认值也是 IPv6 的最小值。

 
networking:
  serviceNetwork:

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

OVN-Kubernetes 网络插件仅支持单个服务的 IP 地址块。

如果您使用 OVN-Kubernetes 网络插件，则可以为 IPv4 和 IPv6 地址族指定 IP 地址块。

包含 CIDR 格式 IP 地址块的数组。例如

networking:
  serviceNetwork:
   - 172.30.0.0/16
   - fd02::/112
 
networking:
  machineNetwork:

机器的 IP 地址块。

如果指定多个 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 网络块。

例如，10.0.0.0/16或fd00::/48。

将networking.machineNetwork设置为与首选网卡所在的 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:

确定池中机器的指令集架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为amd64和arm64。

字符串

 
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:

确定池中机器的指令集架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为amd64和arm64。

字符串

 
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..。
其他资源