第7章 Nutanix のインストール設定パラメーター

install-config.yaml コンテンツの API バージョン。現在のバージョンは v1 です。インストールプログラムは、古い API バージョンもサポートしている場合があります。

値: 文字列

クラウドプロバイダーのベースドメイン。ベースドメインは、OpenShift Container Platform クラスターコンポーネントへのルートを作成するために使用されます。クラスターの完全な DNS 名は、<metadata.name>.<baseDomain> 形式を使用する baseDomain と metadata.name パラメーターの値を組み合わせたものです。

値: example.com などの完全修飾ドメイン名またはサブドメイン名。

Kubernetes リソース ObjectMeta。ここからは name パラメーターのみが消費されます。

値: オブジェクト

クラスターの名前。クラスターの DNS レコードはすべて {{.metadata.name}}.{{.baseDomain}} のサブドメインです。

値: 小文字とハイフン (-) からなる文字列 (例: dev)。

インストールを実行する特定のプラットフォームの設定: aws、baremetal、azure、gcp、ibmcloud、nutanix、openstack、powervs、vsphere、または {}。platform.<platform> パラメーターに関する追加情報は、以下の表で特定のプラットフォームを参照してください。

値: オブジェクト

Red Hat OpenShift Cluster Manager からプルシークレット を取得して、Quay.io などのサービスから OpenShift Container Platform コンポーネントのコンテナーイメージをダウンロードすることを認証します。

値:

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

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

クラスターのネットワークの設定。

値: オブジェクト

インストールする Red Hat OpenShift Networking ネットワークプラグイン。

値: OVNKubernetes。OVNKubernetes は、Linux ネットワークおよび Linux サーバーと Windows サーバーの両方を含むハイブリッドネットワーク用の Container Network Interface (CNI) プラグインです。デフォルトの値は OVNKubernetes です。

Pod の IP アドレスブロック。

デフォルト値は 10.128.0.0/14 で、ホストの接頭辞は /23 です。

複数の IP アドレスブロックを指定する場合は、ブロックが重複しないようにしてください。

値: オブジェクトの配列。以下に例を示します。

networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23

networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23

networking.clusterNetwork を使用する場合に必須です。IP アドレスブロック。

IPv4 ネットワーク

値: Classless Inter-Domain Routing (CIDR) 表記の IP アドレスブロック。IPv4 ブロックの接頭辞長は 0 から 32 の間になります。

それぞれの個別ノードに割り当てるサブネット接頭辞長。たとえば、hostPrefix が 23 に設定される場合、各ノードに指定の cidr から /23 サブネットが割り当てられます。hostPrefix 値の 23 は、510 (2^(32 - 23) - 2) Pod IP アドレスを提供します。

値: サブネット接頭辞。

デフォルト値は 23 です。

サービスの IP アドレスブロック。デフォルト値は 172.30.0.0/16 です。

OVN-Kubernetes ネットワークプラグインは、サービスネットワークに対して単一の IP アドレスブロックのみをサポートします。

値: CIDR 形式の IP アドレスブロックを含む配列。以下に例を示します。

networking:
  serviceNetwork:
   - 172.30.0.0/16

networking:
  serviceNetwork:
   - 172.30.0.0/16

マシンの IP アドレスブロック。

複数の IP アドレスブロックを指定する場合は、ブロックが重複しないようにしてください。

値: オブジェクトの配列。以下に例を示します。

networking:
  machineNetwork:
  - cidr: 10.0.0.0/16

networking:
  machineNetwork:
  - cidr: 10.0.0.0/16

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

ovn-kubernetes によって内部的に使用される IPv4 join サブネットを設定します。このサブネットは、ノードネットワークを含め、OpenShift Container Platform が使用している他のサブネットと重複することはできません。サブネットのサイズは、ノード数より大きくする必要があります。インストール後に値を変更することはできません。

値: CIDR 表記の IP ネットワークブロック。デフォルト値は 100.64.0.0/16 です。

ノードの信頼済み証明書ストアに追加される PEM でエンコードされた X.509 証明書バンドル。このトラストバンドルは、プロキシーが設定されている場合にも使用される可能性があります。

値: 文字列

オプションのコアクラスターコンポーネントのインストールを制御します。オプションのコンポーネントを無効にすることで、OpenShift Container Platform クラスターのフットプリントを削減できます。詳細は、インストール の「クラスター機能ページ」を参照してください。

値: 文字列の配列

有効にするオプション機能の初期セットを選択します。有効な値は None、v4.11、v4.12、vCurrent です。デフォルト値は vCurrent です。

値: 文字列

オプションの機能のセットを、baselineCapabilitySet で指定したものを超えて拡張します。このパラメーターでは複数の機能を指定できます。

値: 文字列の配列

ワークロードパーティション設定を使用して、OpenShift Container Platform サービス、クラスター管理ワークロード、およびインフラストラクチャー Pod を分離し、予約された CPU セットで実行できます。ワークロードパーティショニングを有効にできるのはインストール時のみです。インストール後は無効にできません。このフィールドはワークロードのパーティショニングを有効にしますが、特定の CPU を使用するようにワークロードを設定するわけではありません。詳細は、スケーラビリティとパフォーマンス セクションの ワークロードパーティショニング ページを参照してください。

値: None または AllNodes。デフォルト値は None です。

コンピュートノードを構成するマシンの設定。

値: MachinePool オブジェクトの配列。

プール内のマシンの命令セットアーキテクチャーを決定します。現在、さまざまなアーキテクチャーのクラスターはサポートされていません。すべてのプールは同じアーキテクチャーを指定する必要があります。有効な値は amd64 (デフォルト) です。

値: 文字列

コンピュートマシンで同時マルチスレッドまたは hyperthreading を有効/無効にするかどうか。デフォルトでは、同時マルチスレッドはマシンのコアのパフォーマンスを上げるために有効化されます。

値: Enabled または Disabled

compute を使用する場合に必須です。マシンプールの名前。

値: worker

compute を使用する場合に必須です。このパラメーターを使用して、ワーカーマシンをホストするクラウドプロバイダーを指定します。このパラメーターの値は controlPlane.platform パラメーターの値に一致する必要があります。

値: aws、azure、gcp、ibmcloud、nutanix、openstack、powervs、vsphere、または {}

プロビジョニングするコンピュートマシン (ワーカーマシンとしても知られる) の数。

値: 2 以上の正の整数。デフォルト値は 3 です。

機能セットのクラスターを有効にします。機能セットは、デフォルトで有効にされない OpenShift Container Platform 機能のコレクションです。インストール中に機能セットを有効にする方法の詳細は、「機能ゲートの使用による各種機能の有効化」を参照してください。

値: 文字列。TechPreviewNoUpgrade など、有効にする機能セットの名前。

コントロールプレーンを構成するマシンの設定。

値: MachinePool オブジェクトの配列。

プール内のマシンの命令セットアーキテクチャーを決定します。現在、さまざまなアーキテクチャーのクラスターはサポートされていません。すべてのプールは同じアーキテクチャーを指定する必要があります。有効な値は amd64 (デフォルト) です。

値: 文字列

コントロールプレーンマシンで同時マルチスレッドまたは hyperthreading を有効/無効にするかどうか。デフォルトでは、同時マルチスレッドはマシンのコアのパフォーマンスを上げるために有効化されます。

値: Enabled または Disabled

controlPlane を使用する場合に必須です。マシンプールの名前。

値: master

controlPlane を使用する場合に必須です。このパラメーターを使用して、コントロールプレーンマシンをホストするクラウドプロバイダーを指定します。このパラメーターの値は compute.platform パラメーターの値に一致する必要があります。

値: aws、azure、gcp、ibmcloud、nutanix、openstack、powervs、vsphere、または {}

プロビジョニングするコントロールプレーンマシンの数。

値: サポートされる値は 3 です。シングルノード OpenShift をデプロイする場合は 1 です。

OpenShift Container Platform クラスターでは、アービターノードの名前が必要です。たとえば、arbiter です。

replicas パラメーターは、OpenShift Container Platform クラスターのアービターノードの数を設定します。このフィールドを 1 より大きい値に設定することはできません。

Cloud Credential Operator (CCO) モード。モードを指定しないと、CCO は指定された認証情報の機能を動的に判別しようとします。この場合、複数のモードがサポートされるプラットフォームで Mint モードが優先されます。

値: Mint、Passthrough、Manual、または空の文字列 ("")。

FIPS モードを有効または無効にします。デフォルトは false (無効) です。FIPS モードを有効にすると、OpenShift Container Platform が稼働している Red Hat Enterprise Linux CoreOS (RHCOS) マシンで、デフォルトの Kubernetes 暗号化スイートが無視され、代わりに RHCOS が提供する暗号化モジュールが使用されます。

値: false または true

release-image コンテンツのソースおよびリポジトリー。

値: オブジェクトの配列。この表の以下の行で説明されているように、source およびオプションで mirrors が含まれます。

imageContentSources を使用する場合に必須です。ユーザーが参照するリポジトリーを指定します (例: イメージプル仕様)。

値: 文字列

同じイメージが含まれている可能性があるリポジトリーを 1 つ以上指定します。

値: 文字列の配列

Kubernetes API、OpenShift ルートなどのクラスターのユーザーに表示されるエンドポイントをパブリッシュまたは公開する方法。

値: Internal または External。デフォルト値は External です。

このパラメーターを Internal に設定することは、クラウド以外のプラットフォームではサポートされません。

クラスターマシンへのアクセスを認証するための SSH キー。

値: たとえば、sshKey: ssh-ed25519 AAAA.. です。

コンピューティング VM に適用するプリズムカテゴリーのキーの名前。このパラメーターには、value パラメーターを指定する必要があり、key と value の両方のパラメーターが Prism Central に存在する必要があります。カテゴリーの詳細は、カテゴリー管理 を参照してください。

値: 文字列

コンピューティング VM に適用するプリズムカテゴリーのキーと値のペアの値。このパラメーターには、key パラメーターを指定する必要があり、key と value の両方のパラメーターが Prism Central に存在する必要があります。

値: 文字列

コンピュートマシンのみに適用する障害ドメイン。

障害ドメインは platform.nutanix.failureDomains で指定します。

値: リスト。

1 つ以上の障害ドメインの名前。

GPU をコンピュートマシンに接続するために使用される識別子のタイプ。有効な値は "Name" または "DeviceID" です。

値: 文字列

コンピュートマシンに接続する GPU デバイスの名前。GPU type が "Name" の場合は、このパラメーターが必須です。

値: 文字列

コンピュートマシンに接続する GPU デバイスのデバイス識別子。この情報は Prism Central で入手できます。GPU type が "DeviceID" の場合、このパラメーターは必須です。

値: 整数

コンピューティング VM のプロジェクトを選択するために使用する識別子のタイプ。プロジェクトは、権限、ネットワーク、およびその他のパラメーターを管理するためのユーザーロールの論理グループを定義します。プロジェクトの詳細は、プロジェクトの概要 を参照してください。

値: name または uuid

コンピューティング VM が関連付けられているプロジェクトの名前または UUID。このパラメーターには、type パラメーターを指定する必要があります。

値: 文字列

コンピューティングマシンが使用するブートタイプ。OpenShift Container Platform 4.20 では、Legacy ブートタイプを使用する必要があります。ブートタイプの詳細は、仮想化環境内の UEFI、セキュアブート、および TPM について を参照してください。

値: Legacy、SecureBoot、または UEFI。デフォルトは、Legacy です。

オプション。Prism Central の仮想マシンディスクのデータソースイメージの名前。

値: 文字列

オプション。障害ドメイン内のデータソースイメージの参照名。このパラメーターを使用する場合は、コンピュートノードが配置されている各障害ドメインで、同じ referenceName を持つ対応する dataSourceImage を設定する必要があります。障害ドメインの設定の詳細は、Nutanix へのクラスターのインストール ページの 障害ドメインの設定 を参照してください。

値: 文字列

Prism Central のデータソースイメージの UUID。この値は必須です。

値: 文字列

ディスクアドレスのアダプタータイプ。ディスクタイプが "Disk" の場合、有効な値は "SCSI"、"IDE"、"PCI"、"SATA"、または "SPAPR" です。ディスクタイプが "CDRom" の場合、有効な値は "IDE" または "SATA" です。

値: 文字列

ディスクアドレスのインデックス。有効な値は 0 を含む負の値以外の整数です。同じアダプタータイプを共有するディスクのデバイスインデックスは 0 から始まり、連続して増加する必要があります。デフォルト値は 0 です。各仮想マシンに対して、Disk.SCSI.0 および CDRom.IDE.0 インデックスが予約されています。Disk.SCSI または CDRom.IDE ディスクおよびアダプタータイプを使用する場合、deviceIndex は 1 から始まる必要があります。

値: 0 を含む負の値以外の整数。

ディスクデバイスの種類。有効な値は "Disk" と "CDRom" です。

値: 文字列

仮想マシンに接続するディスクのサイズ。最小サイズは 1Gb です。

値: 100G や 100Gi などの数量形式。この形式の詳細は、次の link:https://pkg.go.dev/k8s.io/apimachinery/pkg/api/resource#Format を参照してください。

ディスクモード。有効な値は Standard または Flash で、デフォルトは Standard です。

値: 文字列

オプション。Prism Central の仮想マシンディスクで使用されるストレージコンテナーオブジェクトの名前。

値: 文字列

オプション。障害ドメイン内のストレージコンテナーの参照名。これを使用する場合は、コンピュートノードが配置されている各障害ドメインで、同じ referenceName を持つ対応する storageContainer を設定する必要があります。障害ドメインの設定の詳細は、Nutanix へのクラスターのインストール ページの 障害ドメインの設定 を参照してください。

値: 文字列

Prism Central 内のストレージコンテナーの UUID。

値: 文字列

コントロールプレーン VM に適用するプリズムカテゴリーのキーの名前。このパラメーターには、value パラメーターを指定する必要があり、key と value の両方のパラメーターが Prism Central に存在する必要があります。カテゴリーの詳細は、カテゴリー管理 を参照してください。

値: 文字列

コントロールプレーン VM に適用するプリズムカテゴリーのキーと値のペアの値。このパラメーターには、key パラメーターを指定する必要があり、key と value の両方のパラメーターが Prism Central に存在する必要があります。

値: 文字列

コントロールプレーンマシンのみに適用する障害ドメイン。

障害ドメインは platform.nutanix.failureDomains で指定します。

値: リスト。

1 つ以上の障害ドメインの名前。

コントロールプレーン VM のプロジェクトを選択するために使用する識別子のタイプ。プロジェクトは、権限、ネットワーク、およびその他のパラメーターを管理するためのユーザーロールの論理グループを定義します。プロジェクトの詳細は、プロジェクトの概要 を参照してください。

値: name または uuid

コントロールプレーン VM が関連付けられているプロジェクトの名前または UUID。このパラメーターには、type パラメーターを指定する必要があります。

値: 文字列

すべての VM に適用するプリズムカテゴリーのキーの名前。このパラメーターには、value パラメーターを指定する必要があり、key と value の両方のパラメーターが Prism Central に存在する必要があります。カテゴリーの詳細は、カテゴリー管理 を参照してください。

値: 文字列

すべての VM に適用するプリズムカテゴリーのキーと値のペアの値。このパラメーターには、key パラメーターを指定する必要があり、key と value の両方のパラメーターが Prism Central に存在する必要があります。

値: 文字列

コントロールプレーンとコンピュートマシンの両方に適用する障害ドメイン。

障害ドメインは platform.nutanix.failureDomains で指定します。

値: リスト。

1 つ以上の障害ドメインの名前。

すべての VM のプロジェクトを選択するために使用する識別子のタイプ。プロジェクトは、権限、ネットワーク、およびその他のパラメーターを管理するためのユーザーロールの論理グループを定義します。プロジェクトの詳細は、プロジェクトの概要 を参照してください。

値: name または uuid。

すべての VM が関連付けられているプロジェクトの名前または UUID。このパラメーターには、type パラメーターを指定する必要があります。

値: 文字列

すべてのマシンのブートタイプ。OpenShift Container Platform 4.20 では、Legacy ブートタイプを使用する必要があります。ブートタイプの詳細は、仮想化環境内の UEFI、セキュアブート、および TPM について を参照してください。

値: Legacy、SecureBoot、または UEFI。デフォルトは、Legacy です。

コントロールプレーン API のアクセス用に設定した仮想 IP (VIP) アドレス。

値: IP アドレス

デフォルトでは、インストールプログラムはクラスターマシンを単一の Prism Element インスタンスにインストールします。OpenShift Container Platform クラスター内の障害ドメイン (Prism Element) ごとに最大 32 個のサブネットがサポートされます。すべての subnetUUID 値が一意である必要があります。フォールトトレランスのために追加の Prism Element インスタンスを指定し、そのインスタンスを次のものに適用できます。

値: 設定した障害ドメインのリスト。

使用方法の詳細は、「Nutanix へのクラスターのインストール」の「障害ドメインの設定」を参照してください。

クラスター Ingress に設定した仮想 IP (VIP) アドレス。

値: IP アドレス

Prism Central ドメイン名または IP アドレス。

値: 文字列

Prism Central へのログインに使用されるポート。

値: 文字列

Prism Central ユーザー名のパスワード。

値: 文字列

このパラメーターは、各 OpenShift Container Platform クラスターの RHCOS イメージオブジェクトを作成してアップロードする代わりに、OpenShift Container Platform クラスターがデプロイされている Prism Elements から事前にロードされた名前付き RHCOS イメージオブジェクトを使用します。

値: 文字列

Prism Central へのログインに使用されるユーザー名。

値: 文字列

Prism Element ドメイン名または IP アドレス。[¹]

値: 文字列

Prism Element へのログインに使用されるポート。

値: 文字列

Prism Element の Universally Unique Identifier (UUID)。

値: 文字列

設定した仮想 IP アドレスと DNS レコードを含む Prism Element ネットワークの UUID。[²]

値: 文字列

オプション: デフォルトでは、インストールプログラムは 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