第 7 章 Nutanix 的安装配置参数

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 Cluster Manager 获取 pull secret，验证从 Quay.io 等服务中下载 OpenShift Container Platform 组件的容器镜像。

{
   "auths":{
      "cloud.openshift.com":{
         "auth":"b3Blb=",
         "email":"you@example.com"
      },
      "quay.io":{
         "auth":"b3Blb=",
         "email":"you@example.com"
      }
   }
}

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，则每个节点从 given cidr 中分配 a /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 地址块，块不得重叠。

对象数组。例如：

networking:
  machineNetwork:
  - cidr: 10.0.0.0/16

networking:
  machineNetwork:
    cidr:

使用 networking.machineNetwork 时需要此项。IP 地址块。对于 libvirt 和 IBM Power® Virtual Server 以外的所有平台，默认值为 10.0.0.0/16。对于 libvirt，默认值 为 192.168.126.0/24。对于 IBM Power® Virtual Server，默认值为 192.168.0.0/24。

CIDR 表示法中的 IP 网络块。

例如： 10.0.0.0/16。

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。如需更多信息，请参阅 Scalability and Performance 部分中的 Workload partitioning 页面。

None 或 AllNodes.None 是默认值。

compute:

组成计算节点的机器的配置。

MachinePool 对象的数组。

compute:
  architecture:

决定池中机器的指令集合架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 amd64 （默认值）。

字符串

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:

组成 control plane 的机器的配置。

MachinePool 对象的数组。

controlPlane:
  architecture:

决定池中机器的指令集合架构。目前，不支持具有不同架构的集群。所有池都必须指定相同的架构。有效值为 amd64 （默认值）。

字符串

controlPlane:
  hyperthreading:

是否在 control plane 机器上启用或禁用并发多 线程或超线程。默认情况下，启用并发多线程以提高机器内核的性能。

enabled 或 Disabled

controlPlane:
  name:

使用 controlPlane 时需要此项。机器池的名称。

master

controlPlane:
  platform:

使用 controlPlane 时需要此项。使用此参数指定托管 control plane 机器的云供应商。此参数值必须与 compute.platform 参数值匹配。

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

controlPlane:
  replicas:

要置备的 control plane 机器数量。

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

credentialsMode:

Cloud Credential Operator(CCO)模式。如果没有指定模式，CCO 会动态尝试决定提供的凭证的功能，在支持多个模式的平台上首选 mint 模式。

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

fips:

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

false 或 true

imageContentSources:

release-image 内容的源和存储库。

对象数组。包括一个 source 以及可选的 mirrors，如本表的以下行所述。

imageContentSources:
  source:

使用 imageContentSources 时需要此项。指定用户在镜像拉取规格中引用的存储库。

字符串

imageContentSources:
  mirrors:

指定可能还包含同一镜像的一个或多个仓库。

字符串数组

publish:

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

内部或外部 .默认值为 External。

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

sshKey:

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

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

compute:
  platform:
    nutanix:
      categories:
        key:

应用到计算虚拟机的 prism category 键的名称。此参数必须由 value 参数加加，而 key 和 value 参数必须在 Prism Central 中存在。有关类别的更多信息，请参阅类别管理。

字符串

compute:
  platform:
    nutanix:
      categories:
        value:

应用到计算虚拟机的 prism category 键值对的值。此参数必须由 key 参数加加，而 key 和 value 参数必须在 Prism Central 中存在。

字符串

compute:
  platform:
    nutanix:
     failureDomains:

仅适用于计算机器的故障域。

故障域在 platform.nutanix.failureDomains 中指定。

列表。

一个或多个故障域的名称。

compute:
  platform:
    nutanix:
      gpus:
        type:

用于将 GPU 附加到计算机器的标识符类型。有效值为 "Name" 或 "DeviceID"。

字符串

compute:
  platform:
    nutanix:
      gpus:
        name:

附加到计算机器的 GPU 设备名称。如果 GPU 类型是 "Name"，则需要此参数。

字符串

compute:
  platform:
    nutanix:
      gpus:
        deviceID:

要附加到计算机器的 GPU 设备的设备标识符。此信息在 Prism Central 中提供。如果 GPU 类型是 "DeviceID"，则需要此参数。

整数

compute:
  platform:
    nutanix:
      project:
        type:

用于为计算虚拟机选择项目的标识符类型。项目定义用于管理权限、网络和其他参数的用户角色的逻辑组。如需有关项目的更多信息，请参阅项目概述。

name 或 uuid

compute:
  platform:
    nutanix:
      project:
        name: or uuid:

与计算机器关联的项目的名称或 UUID。此参数必须由 type 参数显示。

字符串

compute:
  platform:
    nutanix:
      bootType:

计算机器使用的引导类型。您必须在 OpenShift Container Platform 4.17 中使用 Legacy 引导类型。有关引导类型的更多信息，请参阅 虚拟环境中的了解 UEFI、安全引导和 TPM。

Legacy、SecureBoot 或 UEFI。默认值为 Legacy。

compute:
  platform:
    nutanix:
      dataDisks:
        dataSourceImage:
          name:

可选。Prism Central 中虚拟机磁盘的数据源镜像的名称。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        dataSourceImage:
          referenceName:

可选。故障域中数据源镜像的引用名称。如果使用此参数，则必须在计算节点占用的每个故障域中配置匹配的 dataSourceImage（具有相同 referenceName）。有关配置故障域的更多信息，请参阅在 Nutanix 中安装集群页中的配置故障域。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        dataSourceImage:
          uuid:

Prism Central 中数据源镜像的 UUID。此值是必需的。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        deviceProperties:
          adapterType:

磁盘地址的适配器类型。如果磁盘类型是 "Disk"，则有效值为 "SCSI", "IDE", "PCI", "SATA" 或 "SPAPR"。如果磁盘类型是 "CDRom"，则有效值为 "IDE" 或 "SATA"。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        deviceProperties:
          deviceIndex:

磁盘地址的索引。有效值为非负整数，包括 0。共享相同适配器类型的磁盘的设备索引应该从 0 开始，并连续增加。默认值为 0。对于每个虚拟机，保留 Disk.SCSI.0 和 CDRom.IDE.0 索引。如果您使用 Disk.SCSI 或 CDRom.IDE 磁盘和适配器类型，则 deviceIndex 应该从 1 开始。

非负整数，包括 0。

compute:
  platform:
    nutanix:
      dataDisks:
        deviceProperties:
          deviceType:

磁盘设备类型。有效值为 "Disk" 和 "CDRom"。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        diskSize:

要附加到虚拟机的磁盘大小。最小值为 1Gb。

数量格式，如 100G 或 100Gi。有关此格式的更多信息，请参阅 link:https://pkg.go.dev/k8s.io/apimachinery/pkg/api/resource#Format。

compute:
  platform:
    nutanix:
      dataDisks:
        storageConfig:
          diskMode:

磁盘模式。有效值为 "Standard" 或 "Flash"，默认值为 "Standard"。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        storageConfig:
          storageContainer:
            name:

可选。Prism Central 中虚拟机磁盘使用的存储容器对象的名称。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        storageConfig:
          storageContainer:
            referenceName:

可选。故障域中存储容器的引用名称。如果使用此功能，您必须在计算节点占用的每个故障域中配置匹配的 storageContainer （具有相同 referenceName）。有关配置故障域的更多信息，请参阅在 Nutanix 中安装集群页中的配置故障域。

字符串

compute:
  platform:
    nutanix:
      dataDisks:
        storageConfig:
          storageContainer:
            uuid:

Prism Central 中存储容器的 UUID。

字符串

controlPlane:
  platform:
    nutanix:
      categories:
        key:

应用到 control plane 虚拟机的 prism category 键的名称。此参数必须由 value 参数加加，而 key 和 value 参数必须在 Prism Central 中存在。有关类别的更多信息，请参阅类别管理。

字符串

controlPlane:
  platform:
    nutanix:
      categories:
        value:

应用到 control plane 虚拟机的 prism category 键值对的值。此参数必须由 key 参数加加，而 key 和 value 参数必须在 Prism Central 中存在。

字符串

controlPlane:
  platform:
    nutanix:
     failureDomains:

仅适用于 control plane 机器的故障域。

故障域在 platform.nutanix.failureDomains 中指定。

列表。

一个或多个故障域的名称。

controlPlane:
  platform:
    nutanix:
      project:
        type:

用于为 control plane 虚拟机选择项目的标识符类型。项目定义用于管理权限、网络和其他参数的用户角色的逻辑组。如需有关项目的更多信息，请参阅项目概述。

name 或 uuid

controlPlane:
  platform:
    nutanix:
      project:
        name: or uuid:

与 control plane 虚拟机关联的项目的名称或 UUID。此参数必须由 type 参数显示。

字符串

platform:
  nutanix:
    defaultMachinePlatform:
      categories:
        key:

适用于所有虚拟机的 prism category 键的名称。此参数必须由 value 参数加加，而 key 和 value 参数必须在 Prism Central 中存在。有关类别的更多信息，请参阅类别管理。

字符串

platform:
  nutanix:
    defaultMachinePlatform:
      categories:
        value:

应用到所有虚拟机的 prism category 键值对的值。此参数必须由 key 参数加加，而 key 和 value 参数必须在 Prism Central 中存在。

字符串

platform:
  nutanix:
    defaultMachinePlatform:
      failureDomains:

适用于 control plane 和计算机器的故障域。

故障域在 platform.nutanix.failureDomains 中指定。

列表。

一个或多个故障域的名称。

platform:
  nutanix:
    defaultMachinePlatform:
      project:
        type:

用于为所有虚拟机选择项目的标识符类型。项目定义用于管理权限、网络和其他参数的用户角色的逻辑组。如需有关项目的更多信息，请参阅项目概述。

name 或 uuid。

platform:
  nutanix:
    defaultMachinePlatform:
      project:
        name: or uuid:

与所有虚拟机关联的项目的名称或 UUID。此参数必须由 type 参数显示。

字符串

platform:
  nutanix:
    defaultMachinePlatform:
      bootType:

所有机器的引导类型。您必须在 OpenShift Container Platform 4.17 中使用 Legacy 引导类型。有关引导类型的更多信息，请参阅 虚拟环境中的了解 UEFI、安全引导和 TPM。

Legacy、SecureBoot 或 UEFI。默认值为 Legacy。

platform:
  nutanix:
    apiVIP:

为 control plane API 访问配置的虚拟 IP(VIP)地址。

IP 地址

platform:
  nutanix:
    failureDomains:
    - name:
      prismElement:
        name:
        uuid:
      subnetUUIDs:
      -

默认情况下，安装程序会将集群机器安装到单个 Prism Element 实例。您可以为容错指定额外的 Prism Element 实例，然后将它们应用到：

配置的故障域列表。

有关使用的更多信息，请参阅"在 Nutanix 上安装集群"中的"配置故障域"。

platform:
  nutanix:
    ingressVIP:

为集群入口配置的虚拟 IP(VIP)地址。

IP 地址

platform:
  nutanix:
    prismCentral:
      endpoint:
        address:

Prism Central 域名或 IP 地址。

字符串

platform:
  nutanix:
    prismCentral:
      endpoint:
        port:

用于登录到 Prism Central 的端口。

字符串

platform:
  nutanix:
    prismCentral:
      password:

Prism Central 用户名的密码。

字符串

platform:
  nutanix:
    prismCentral:
      username:

用于登录到 Prism Central 的用户名。

字符串

platform:
  nutanix:
    prismElements:
      endpoint:
        address:

Prism Element 域名或 IP 地址。[¹]

字符串

platform:
  nutanix:
    prismElements:
      endpoint:
        port:

用于登录到 Prism Element 的端口。

字符串

platform:
  nutanix:
    prismElements:
      uuid:

Prism Element 的通用唯一标识符 (UUID)。

字符串

platform:
  nutanix:
    subnetUUIDs:

包含您配置的虚拟 IP 地址和 DNS 记录的 Prism Element 网络的 UUID。[²]

字符串

platform:
  nutanix:
    clusterOSImage:

可选： 默认情况下，安装程序会下载并安装 Red Hat Enterprise Linux CoreOS (RHCOS) 镜像。如果 Prism Central 没有互联网访问，您可以通过在任何 HTTP 服务器上托管 RHCOS 镜像来覆盖默认行为，并将安装程序指向镜像。

HTTP 或 HTTPS URL，可选使用 SHA-256 校验和。例如：http://example.com/images/rhcos-47.83.202103221318-0-nutanix.x86_64.qcow2