12.6. 基于代理的安装程序的安装配置参数
在使用基于代理的安装程序部署 OpenShift Container Platform 集群前,您可以提供参数来自定义集群以及托管它的平台。在创建 install-config.yaml
和 agent-config.yaml
文件时,必须为所需参数提供值,您可以使用可选参数进一步自定义集群。
12.6.1. 可用的安装配置参数 复制链接链接已复制到粘贴板!
下表指定您可以在基于 Agent 的安装过程中设置的必要和可选安装配置参数。
这些值在 install-config.yaml
文件中指定。
这些设置仅用于安装,无法在安装后修改。
12.6.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 组件的容器镜像。 |
|
12.6.1.2. 网络配置参数 复制链接链接已复制到粘贴板!
您可以根据现有网络基础架构的要求自定义安装配置。例如,您可以扩展集群网络的 IP 地址块,或者提供不同于默认值的不同 IP 地址块。
- 如果使用 Red Hat OpenShift Networking OVN-Kubernetes 网络插件,则支持 IPv4 和 IPv6 地址系列。
- 如果您使用 Red Hat OpenShift Networking OpenShift SDN 网络插件,则只支持 IPv4 地址系列。
如果将集群配置为使用两个 IP 地址系列,请查看以下要求:
- 两个 IP 系列都必须将相同的网络接口用于默认网关。
- 两个 IP 系列都必须具有默认网关。
- 您必须为所有网络配置参数指定 IPv4 和 IPv6 地址。例如,以下配置 IPv4 地址列在 IPv6 地址的前面。
Red Hat OpenShift Data Foundation 灾难恢复解决方案不支持 Globalnet。对于区域灾难恢复场景,请确保为每个集群中的集群和服务网络使用非重叠的专用 IP 地址。
参数 | 描述 | 值 |
---|---|---|
networking:
| 集群网络的配置。 | 对象 注意
您无法在安装后修改 |
networking: networkType:
| 要安装的 Red Hat OpenShift Networking 网络插件。 |
|
networking: clusterNetwork:
| pod 的 IP 地址块。
默认值为 如果您指定了多个 IP 地址块,块不得重叠。 | 对象数组。例如: |
networking: clusterNetwork: cidr:
|
使用 如果使用 OpenShift SDN 网络插件,请指定 IPv4 网络。如果使用 OVN-Kubernetes 网络插件,您可以指定 IPv4 和 IPv6 网络。 |
使用 CIDR 形式的 IP 地址块。IPv4 块的前缀长度介于 |
networking: clusterNetwork: hostPrefix:
|
分配给每个节点的子网前缀长度。例如,如果 | 子网前缀。
对于 IPv4 网络,默认值为 |
networking: serviceNetwork:
|
服务的 IP 地址块。默认值为 OpenShift SDN 和 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:
|
使用 | CIDR 表示法中的 IP 网络块。
例如。 注意
将 |
12.6.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 模式。 |
|
fips:
|
启用或禁用 FIPS 模式。默认值为 重要 要为集群启用 FIPS 模式,您必须从配置为以 FIPS 模式操作的 Red Hat Enterprise Linux (RHEL) 计算机运行安装程序。有关在 RHEL 中配置 FIPS 模式的更多信息,请参阅在 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 集群,请指定 |
例如, |
- 不是所有 CCO 模式都支持所有云供应商。有关 CCO 模式的更多信息,请参阅身份验证和授权内容中的"管理云供应商凭证"条目。
12.6.2. 可用的代理配置配置参数 复制链接链接已复制到粘贴板!
下表指定您可以在基于 Agent 的安装过程中设置的必要和可选代理配置参数。
这些值在 agent-config.yaml
文件中指定。
这些设置仅用于安装,无法在安装后修改。
12.6.2.1. 所需的配置参数 复制链接链接已复制到粘贴板!
下表描述了所需的代理配置参数:
参数 | 描述 | 值 |
---|---|---|
apiVersion:
|
| 字符串 |
metadata:
|
Kubernetes 资源 | 对象 |
metadata: name:
|
集群的名称。集群的 DNS 记录是 |
小写字母和连字符 ( |
12.6.2.2. 可选的配置参数 复制链接链接已复制到粘贴板!
下表描述了可选的 Agent 配置参数:
参数 | 描述 | 值 |
---|---|---|
rendezvousIP:
|
执行 bootstrap 进程的节点的 IP 地址,以及运行 | IPv4 或 IPv6 地址。 |
bootArtifactsBaseURL:
| 使用基于代理的安装程序生成 iPXE 脚本时,将 Preboot Execution Environment (PXE) 资产上传到的服务器的 URL。如需更多信息,请参阅"为 OpenShift Container Platform 准备 PXE 资产"。 | 字符串. |
additionalNTPSources:
| 要添加到所有集群主机的网络时间协议 (NTP) 源列表,这些源被添加到通过其他方法配置的任何 NTP 源中。 | 主机名或 IP 地址列表。 |
hosts:
|
主机配置。可选的主机列表。定义的主机数量不能超过 | 主机配置对象的数组。 |
hosts: hostname:
| 主机名.覆盖从动态主机配置协议(DHCP)或反向 DNS 查找中获取的主机名。每个主机必须具有由这些方法提供的唯一主机名,尽管通过此参数配置主机名是可选的。 | 字符串. |
hosts: interfaces:
|
为主机上的接口提供名称和 MAC 地址映射表。如果在 | 主机配置对象的数组。 |
hosts: interfaces: name:
| 主机上接口名称。 | 字符串. |
hosts: interfaces: macAddress:
| 主机上接口的 MAC 地址。 |
一个 MAC 地址,如以下示例: |
hosts: role:
|
定义主机是 |
|
hosts: rootDeviceHints:
| 启用将 Red Hat Enterprise Linux CoreOS (RHCOS)镜像置备到特定设备。安装程序会按照发现设备的顺序检查设备,并将发现的值与 hint 值进行比较。它使用第一个与 hint 值匹配的发现设备。这是操作系统在安装过程中写入的设备。 | 键值对字典。如需更多信息,请参阅"为 OpenShift 安装设置环境"页面中的"Root 设备提示"。 |
hosts: rootDeviceHints: deviceName:
| RHCOS 镜像置备为的设备的名称。 | 字符串. |
hosts: networkConfig:
| 主机网络定义。配置必须与 nmstate 文档中定义的 Host Network Management API 匹配。 | 主机网络配置对象的字典。 |