第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 コンポーネントのコンテナーイメージをダウンロードすることを認証します。

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

オブジェクト

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

OVNKubernetes。OVNKubernetes は、Linux ネットワークと、Linux サーバーと Windows サーバーの両方を含む Linux ネットワークおよびハイブリッドネットワーク用の 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 ネットワーク

CIDR (Classless Inter-Domain Routing) 表記の 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 です。

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 で指定します。

List。

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

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

文字列

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

文字列

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

整数

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

name または uuid

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

文字列

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

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

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

文字列

オプション: 障害ドメイン内のデータソースイメージの参照名。このパラメーターを使用する場合は、コンピュートノードが占める各障害ドメインで、一致する dataSourceImage (同じ referenceName を持つ) を設定する必要があります。障害ドメインの設定の詳細は、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 の仮想マシンディスクで使用されるストレージコンテナーオブジェクトの名前。

文字列

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

文字列

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

文字列

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

文字列

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

文字列

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

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

List。

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

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

name または uuid

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

文字列

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

文字列

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

文字列

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

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

List。

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

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

name または uuid。

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

文字列

すべてのマシンのブートタイプ。OpenShift Container Platform 4.18 では、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