第7章 Nutanix のインストール設定パラメーター
OpenShift Container Platform クラスターを Nutanix にデプロイする前に、クラスターとそれをホストするプラットフォームをカスタマイズするためのパラメーターを指定します。install-config.yaml
ファイルを作成するときは、コマンドラインを使用して必要なパラメーターの値を指定します。その後、install-config.yaml
ファイルを変更して、クラスターをさらにカスタマイズできます。
7.1. Nutanix で使用可能なインストール設定パラメーター
次の表では、インストールプロセスの一部として設定できる、必須、オプション、および Nutanix 固有のインストール設定パラメーターを指定します。
インストール後は、これらのパラメーターを install-config.yaml
ファイルで変更することはできません。
7.1.1. 必須設定パラメーター
必須のインストール設定パラメーターは、以下の表で説明されています。
パラメーター | 説明 | 値 |
---|---|---|
apiVersion: |
| 文字列 |
baseDomain: |
クラウドプロバイダーのベースドメイン。ベースドメインは、OpenShift Container Platform クラスターコンポーネントへのルートを作成するために使用されます。クラスターの完全な DNS 名は、 |
|
metadata: |
Kubernetes リソース | オブジェクト |
metadata: name: |
クラスターの名前。クラスターの DNS レコードはすべて |
小文字いちぶハイフン ( |
platform: |
インストールを実行する特定のプラットフォームの設定: | オブジェクト |
pullSecret: | 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" } } } |
7.1.2. ネットワーク設定パラメーター
既存のネットワークインフラストラクチャーの要件に基づいて、インストール設定をカスタマイズできます。たとえば、クラスターネットワークの IP アドレスブロックを拡張するか、デフォルトとは異なる IP アドレスブロックを指定できます。
IPv4 アドレスのみがサポートされます。
パラメーター | 説明 | 値 |
---|---|---|
networking: | クラスターのネットワークの設定。 | オブジェクト 注記
インストール後に |
networking: networkType: | インストールする Red Hat OpenShift Networking ネットワークプラグイン。 |
|
networking: clusterNetwork: | Pod の IP アドレスブロック。
デフォルト値は 複数の IP アドレスブロックを指定する場合は、ブロックが重複しないようにしてください。 | オブジェクトの配列。以下に例を示します。 networking: clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23 |
networking: clusterNetwork: cidr: |
IPv4 ネットワーク |
CIDR (Classless Inter-Domain Routing) 表記の IP アドレスブロック。IPv4 ブロックの接頭辞長は |
networking: clusterNetwork: hostPrefix: |
それぞれの個別ノードに割り当てるサブネット接頭辞長。たとえば、 | サブネット接頭辞。
デフォルト値は |
networking: serviceNetwork: |
サービスの IP アドレスブロック。デフォルト値は 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: |
| CIDR 表記の IP ネットワークブロック。
例: 注記
優先される NIC が置かれている CIDR に一致する |
7.1.3. オプションの設定パラメーター
オプションのインストール設定パラメーターは、以下の表で説明されています。
パラメーター | 説明 | 値 |
---|---|---|
additionalTrustBundle: | ノードの信頼済み証明書ストアに追加される PEM でエンコードされた X.509 証明書バンドル。この信頼バンドルは、プロキシーが設定される際にも使用できます。 | 文字列 |
capabilities: | オプションのコアクラスターコンポーネントのインストールを制御します。オプションのコンポーネントを無効にすることで、OpenShift Container Platform クラスターのフットプリントを削減できます。詳細は、インストール の「クラスター機能ページ」を参照してください。 | 文字列配列 |
capabilities: baselineCapabilitySet: |
有効にするオプション機能の初期セットを選択します。有効な値は | 文字列 |
capabilities: additionalEnabledCapabilities: |
オプションの機能のセットを、 | 文字列配列 |
cpuPartitioningMode: | ワークロードパーティション設定を使用して、OpenShift Container Platform サービス、クラスター管理ワークロード、およびインフラストラクチャー Pod を分離し、予約された CPU セットで実行できます。ワークロードパーティショニングはインストール中にのみ有効にすることができ、インストール後に無効にすることはできません。このフィールドはワークロードのパーティショニングを有効にしますが、特定の CPU を使用するようにワークロードを設定するわけではありません。詳細は、スケーラビリティとパフォーマンス セクションの ワークロードパーティショニング ページを参照してください。 |
|
compute: | コンピュートノードを構成するマシンの設定。 |
|
compute: architecture: |
プール内のマシンの命令セットアーキテクチャーを決定します。現在、さまざまなアーキテクチャーのクラスターはサポートされていません。すべてのプールは同じアーキテクチャーを指定する必要があります。有効な値は | 文字列 |
compute: hyperthreading: |
コンピュートマシンで同時マルチスレッドまたは 重要 同時スレッドを無効にする場合は、容量計画においてマシンパフォーマンスの大幅な低下が考慮に入れられていることを確認します。 |
|
compute: name: |
|
|
compute: platform: |
|
|
compute: replicas: | プロビジョニングするコンピュートマシン (ワーカーマシンとしても知られる) の数。 |
|
featureSet: | 機能セットのクラスターを有効にします。機能セットは、デフォルトで有効にされない OpenShift Container Platform 機能のコレクションです。インストール中に機能セットを有効にする方法の詳細は、「機能ゲートの使用による各種機能の有効化」を参照してください。 |
文字列。 |
controlPlane: | コントロールプレーンを構成するマシンの設定。 |
|
controlPlane: architecture: |
プール内のマシンの命令セットアーキテクチャーを決定します。現在、さまざまなアーキテクチャーのクラスターはサポートされていません。すべてのプールは同じアーキテクチャーを指定する必要があります。有効な値は | 文字列 |
controlPlane: hyperthreading: |
コントロールプレーンマシンで同時マルチスレッドまたは 重要 同時スレッドを無効にする場合は、容量計画においてマシンパフォーマンスの大幅な低下が考慮に入れられていることを確認します。 |
|
controlPlane: name: |
|
|
controlPlane: platform: |
|
|
controlPlane: replicas: | プロビジョニングするコントロールプレーンマシンの数。 |
サポートされる値は |
credentialsMode: | Cloud Credential Operator (CCO) モード。モードを指定しないと、CCO は指定された認証情報の機能を動的に判別しようとします。この場合、複数のモードがサポートされるプラットフォームで Mint モードが優先されます。 注記 すべてのクラウドプロバイダーですべての CCO モードがサポートされているわけではありません。CCO モードの詳細は、認証と認可 コンテンツの「クラウドプロバイダーの認証情報の管理」を参照してください。 |
|
fips: |
FIPS モードを有効または無効にします。デフォルトは 重要 クラスターで 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 アーキテクチャーのみで、FIPS 140-2/140-3 検証のために NIST に提出された RHEL 暗号化ライブラリーを使用します。 注記 Azure File ストレージを使用している場合、FIPS モードを有効にすることはできません。 |
|
imageContentSources: | release-image コンテンツのソースおよびリポジトリー。 |
オブジェクトの配列。この表の以下の行で説明されているように、 |
imageContentSources: source: |
| 文字列 |
imageContentSources: mirrors: | 同じイメージが含まれる可能性のあるリポジトリーを 1 つ以上指定します。 | 文字列の配列。 |
publish: | Kubernetes API、OpenShift ルートなどのクラスターのユーザーに表示されるエンドポイントをパブリッシュまたは公開する方法。 |
このパラメーターを 重要
フィールドの値が |
sshKey: | クラスターマシンへのアクセスを認証するための SSH キー。 注記
インストールのデバッグまたは障害復旧を実行する必要のある実稼働用の OpenShift Container Platform クラスターでは、 |
たとえば、 |
7.1.4. 追加の Nutanix 設定パラメーター
追加の Nutanix 設定パラメーターについては、次の表で説明します。
パラメーター | 説明 | 値 |
---|---|---|
compute: platform: nutanix: categories: key: |
コンピューティング VM に適用するプリズムカテゴリーのキーの名前。このパラメーターには、 | 文字列 |
compute: platform: nutanix: categories: value: |
コンピューティング VM に適用するプリズムカテゴリーのキーと値のペアの値。このパラメーターには、 | 文字列 |
compute: platform: nutanix: failureDomains: | コンピュートマシンのみに適用する障害ドメイン。
障害ドメインは | List。 1 つ以上の障害ドメインの名前。 |
compute: platform: nutanix: project: type: | コンピューティング VM のプロジェクトを選択するために使用する識別子のタイプ。プロジェクトは、権限、ネットワーク、およびその他のパラメーターを管理するためのユーザーロールの論理グループを定義します。プロジェクトの詳細は、プロジェクトの概要 を参照してください。 |
|
compute: platform: nutanix: project: name: or uuid: |
コンピューティング VM が関連付けられているプロジェクトの名前または UUID。このパラメーターには、 | 文字列 |
compute: platform: nutanix: bootType: |
コンピューティングマシンが使用するブートタイプ。OpenShift Container Platform 4.16 では、 |
|
controlPlane: platform: nutanix: categories: key: |
コントロールプレーン VM に適用するプリズムカテゴリーのキーの名前。このパラメーターには、 | 文字列 |
controlPlane: platform: nutanix: categories: value: |
コントロールプレーン VM に適用するプリズムカテゴリーのキーと値のペアの値。このパラメーターには、 | 文字列 |
controlPlane: platform: nutanix: failureDomains: | コントロールプレーンマシンのみに適用する障害ドメイン。
障害ドメインは | List。 1 つ以上の障害ドメインの名前。 |
controlPlane: platform: nutanix: project: type: | コントロールプレーン VM のプロジェクトを選択するために使用する識別子のタイプ。プロジェクトは、権限、ネットワーク、およびその他のパラメーターを管理するためのユーザーロールの論理グループを定義します。プロジェクトの詳細は、プロジェクトの概要 を参照してください。 |
|
controlPlane: platform: nutanix: project: name: or uuid: |
コントロールプレーン VM が関連付けられているプロジェクトの名前または UUID。このパラメーターには、 | 文字列 |
platform: nutanix: defaultMachinePlatform: categories: key: |
すべての VM に適用するプリズムカテゴリーのキーの名前。このパラメーターには、 | 文字列 |
platform: nutanix: defaultMachinePlatform: categories: value: |
すべての VM に適用するプリズムカテゴリーのキーと値のペアの値。このパラメーターには、 | 文字列 |
platform: nutanix: defaultMachinePlatform: failureDomains: | コントロールプレーンとコンピュートマシンの両方に適用する障害ドメイン。
障害ドメインは | List。 1 つ以上の障害ドメインの名前。 |
platform: nutanix: defaultMachinePlatform: project: type: | すべての VM のプロジェクトを選択するために使用する識別子のタイプ。プロジェクトは、権限、ネットワーク、およびその他のパラメーターを管理するためのユーザーロールの論理グループを定義します。プロジェクトの詳細は、プロジェクトの概要 を参照してください。 |
|
platform: nutanix: defaultMachinePlatform: project: name: or uuid: |
すべての VM が関連付けられているプロジェクトの名前または UUID。このパラメーターには、 | 文字列 |
platform: nutanix: defaultMachinePlatform: bootType: |
すべてのマシンのブートタイプ。OpenShift Container Platform 4.16 では、 |
|
platform: nutanix: apiVIP: | コントロールプレーン API のアクセス用に設定した仮想 IP (VIP) アドレス。 | IP アドレス |
platform: nutanix: failureDomains: - name: prismElement: name: uuid: subnetUUIDs: - | デフォルトでは、インストールプログラムはクラスターマシンを単一の Prism Element インスタンスにインストールします。フォールトトレランスのために追加の Prism Element インスタンスを指定し、そのインスタンスを次のものに適用できます。
| 設定した障害ドメインのリスト。 使用方法の詳細は、「Nutanix へのクラスターのインストール」の「障害ドメインの設定」を参照してください。 |
platform: nutanix: ingressVIP: | クラスター Ingress に設定した仮想 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 アドレス。 [1] | 文字列 |
platform: nutanix: prismElements: endpoint: port: | Prism Element へのログインに使用されるポート。 | 文字列 |
platform: nutanix: prismElements: uuid: | Prism Element の Universally Unique Identifier (UUID)。 | 文字列 |
platform: nutanix: subnetUUIDs: | 設定した仮想 IP アドレスと DNS レコードを含む Prism Element ネットワークの UUID。[2] | 文字列 |
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 |
-
prismElements
セクションには、Prism Elements (クラスター) のリストが含まれています。Prism Element は、OpenShift Container Platform クラスターをホストするために使用されるすべての Nutanix リソース (仮想マシンやサブネットなど) を包含します。 - OpenShift Container Platform クラスター内の Prism Element ごとに 1 つのサブネットのみがサポートされます。