第8章 Agent-based Installer のインストール設定パラメーター
Agent-based Installer を使用して OpenShift Container Platform クラスターをデプロイする前に、クラスターとそれをホストするプラットフォームをカスタマイズするパラメーターを指定します。install-config.yaml
ファイルと agent-config.yaml
ファイルの作成時に、必須パラメーターの値を指定する必要があります。オプションのパラメーターを使用してクラスターをさらにカスタマイズできます。
8.1. 使用可能なインストール設定パラメーター リンクのコピーリンクがクリップボードにコピーされました!
次の表に、エージェントベースのインストールプロセスの一部として設定できる必須およびオプションのインストール設定パラメーターを示します。
これらの値は、install-config.yaml
ファイルに指定されます。
これらの設定はインストール時にのみ使用され、インストール後は変更できません。
8.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 コンポーネントのコンテナーイメージをダウンロードすることを認証します。 |
|
8.1.2. ネットワーク設定パラメーター リンクのコピーリンクがクリップボードにコピーされました!
既存のネットワークインフラストラクチャーの要件に基づいて、インストール設定をカスタマイズできます。たとえば、クラスターネットワークの IP アドレスブロックを拡張したり、デフォルトとは異なる IP アドレスブロックを設定したりすることができます。
クラスターのネットワークパラメーターを設定する前に、次の情報を考慮してください。
- Red Hat OpenShift Networking OVN-Kubernetes ネットワークプラグインを使用する場合、IPv4 と IPv6 の両方のアドレスファミリーがサポートされます。
IPv4 アドレスと非リンクローカル IPv6 アドレスの両方をサポートするネットワークを持つ OpenShift Container Platform クラスターにノードをデプロイした場合は、デュアルスタックネットワークを使用するようにクラスターを設定します。
- デュアルスタックネットワークに設定されたクラスターでは、IPv4 と IPv6 の両方のトラフィックがデフォルトゲートウェイとして同じネットワークインターフェイスを使用する必要があります。これにより、複数のネットワークインターフェイスコントローラー (NIC) 環境で、使用可能なネットワークインターフェイスに基づいて、使用する NIC をクラスターが検出できるようになります。詳細は、OVN-Kubernetes ネットワークプラグインについて の「OVN-Kubernetes IPv6 とデュアルスタックの制限」を参照してください。
- ネットワーク接続の問題を防ぐために、デュアルスタックネットワークをサポートするホストにシングルスタック IPv4 クラスターをインストールしないでください。
両方の IP アドレスファミリーを使用するようにクラスターを設定する場合は、次の要件を確認してください。
- どちらの IP ファミリーも、デフォルトゲートウェイに同じネットワークインターフェイスを使用する必要があります。
- 両方の IP ファミリーにデフォルトゲートウェイが必要です。
すべてのネットワーク設定パラメーターに対して、IPv4 アドレスと IPv6 アドレスを同じ順序で指定する必要があります。たとえば、次の設定では、IPv4 アドレスが IPv6 アドレスの前に記載されています。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
パラメーター | 説明 | 値 |
---|---|---|
networking:
| クラスターのネットワークの設定。 | オブジェクト 注記
インストール後に |
networking: networkType:
| インストールする Red Hat OpenShift Networking ネットワークプラグイン。 |
|
networking: clusterNetwork:
| Pod の IP アドレスブロック。
デフォルト値は 複数の IP アドレスブロックを指定する場合は、ブロックが重複しないようにしてください。 | オブジェクトの配列。以下に例を示します。 |
networking: clusterNetwork: cidr:
|
OVN-Kubernetes ネットワークプラグインを使用する場合は、IPv4 および IPv6 ネットワークを指定できます。 |
CIDR (Classless Inter-Domain Routing) 表記の IP アドレスブロック。IPv4 ブロックの接頭辞長は |
networking: clusterNetwork: hostPrefix:
|
それぞれの個別ノードに割り当てるサブネット接頭辞長。たとえば、 | サブネット接頭辞。
IPv4 ネットワークの場合、デフォルト値は |
networking: serviceNetwork:
|
サービスの IP アドレスブロック。デフォルト値は 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 ネットワークブロック。
例: 注記
優先される NIC が置かれている CIDR に一致する |
networking: ovnKubernetesConfig: ipv4: internalJoinSubnet:
|
|
CIDR 表記の IP ネットワークブロック。デフォルト値は |
8.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 クラスターでは、 |
たとえば、 |
8.1.4. Agent-based Installer 用の追加のベアメタル設定パラメーター リンクのコピーリンクがクリップボードにコピーされました!
Agent-based Installer 用の追加のベアメタルインストール設定パラメーターについて、次の表で説明します。
以下のフィールドは、クラスターの初期プロビジョニング中には使用されませんが、クラスターのインストールが完了すると使用できるようになります。インストール時にこれらのフィールドを設定しておくと、Day 2 オペレーション中にフィールドを設定する必要がなくなります。
パラメーター | 説明 | 値 |
---|---|---|
platform: baremetal: clusterProvisioningIP:
|
プロビジョニングサービスが実行されるクラスター内の IP アドレス。デフォルトは、プロビジョニングサブネットの 3 番目の IP アドレスに設定されます。たとえば、 | IPV4 または IPV6 アドレス。 |
platform: baremetal: provisioningNetwork:
|
|
|
platform: baremetal: provisioningMACAddress:
| プロビジョニングサービスを実行するクラスター内の MAC アドレス。 | MAC アドレス |
platform: baremetal: provisioningNetworkCIDR:
| プロビジョニングに使用するネットワークの CIDR。このオプションは、プロビジョニングネットワークでデフォルトのアドレス範囲を使用しない場合に必要です。 |
有効な CIDR (例: |
platform: baremetal: provisioningNetworkInterface:
|
ベアメタルネットワークに接続されたノード上のネットワークインターフェイス名。 | 文字列。 |
platform: baremetal: provisioningDHCPRange:
|
プロビジョニングネットワーク上のノードの IP 範囲を定義します (例: | IP アドレスの範囲。 |
platform: baremetal: hosts:
| ベアメタルホストの設定。 | ホスト設定オブジェクトの配列。 |
platform: baremetal: hosts: name:
| ホストの名前。 | 文字列。 |
platform: baremetal: hosts: bootMACAddress:
| ホストのプロビジョニングに使用する NIC の MAC アドレス。 | MAC アドレス |
platform: baremetal: hosts: bmc:
| ホストがベースボード管理コントローラー (BMC) に接続するための設定。 | BMC 設定オブジェクトのディクショナリー。 |
platform: baremetal: hosts: bmc: username:
| BMC のユーザー名。 | 文字列。 |
platform: baremetal: hosts: bmc: password:
| BMC のパスワード。 | 文字列。 |
platform: baremetal: hosts: bmc: address:
|
ホストの BMC コントローラーと通信するための URL。address 設定ではプロトコルを指定します。たとえば、 | URL。 |
platform: baremetal: hosts: bmc: disableCertificateVerification:
|
| ブール値。 |
8.1.5. 追加の VMware vSphere 設定パラメーター リンクのコピーリンクがクリップボードにコピーされました!
追加の VMware vSphere 設定パラメーターは以下の表で説明されています。
パラメーター | 説明 | 値 |
---|---|---|
platform: vsphere:
| クラスターをホストするクラウドプラットフォーム上のアカウントを説明します。パラメーターを使用してプラットフォームをカスタマイズできます。マシンプール内のコンピュートマシンとコントロールプレーンマシンに追加の設定を指定する場合、このパラメーターは必要ありません。 | vSphere 設定オブジェクトのディクショナリー |
platform: vsphere: failureDomains:
|
リージョンとゾーン間の関係を確立します。障害ドメインは、 | 障害ドメイン設定オブジェクトの配列。 |
platform: vsphere: failureDomains: name:
| 障害ドメインの名前。 | 文字列 |
platform: vsphere: failureDomains: region:
|
クラスターに複数の障害ドメインを定義する場合は、タグを各 vCenter データセンターにアタッチする必要があります。リージョンを定義するには、 重要 vSphere ホストグループに対する OpenShift ゾーンのサポートは、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。 Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。 | 文字列 |
platform: vsphere: failureDomains: regionType:
|
ホストグループを有効にするには、 重要 vSphere ホストグループに対する OpenShift ゾーンのサポートは、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。 Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。 | 文字列 |
platform: vsphere: failureDomains: server:
|
クライアントが障害ドメインリソースにアクセスできるように、VMware vCenter Server の完全修飾ホスト名または IP アドレスを指定します。 | 文字列 |
platform: vsphere: failureDomains: zone:
|
クラスターに複数の障害ドメインを定義する場合は、各 vCenter クラスターにタグをアタッチする必要があります。ゾーンを定義するには、 重要 vSphere ホストグループに対する OpenShift ゾーンのサポートは、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。 Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。 | 文字列 |
platform: vsphere: failureDomains: zoneType:
|
ホストグループを有効にするには、 重要 vSphere ホストグループに対する OpenShift ゾーンのサポートは、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。 Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。 | 文字列 |
platform: vsphere: failureDomains: topology: computeCluster:
| vSphere コンピュートクラスターへのパス。 | 文字列 |
platform: vsphere: failureDomains: topology: datacenter:
|
OpenShift Container Platform 仮想マシン (VM) が動作するデータセンターをリストして定義します。データセンターのリストは、 | 文字列 |
platform: vsphere: failureDomains: topology: datastore:
| 仮想マシンファイル、テンプレート、ISO イメージを保持する vSphere データストアへのパス。 重要 データストアクラスター内に存在する任意のデータストアのパスを指定できます。デフォルトでは、Storage vMotion はデータストアクラスターに対して自動的に有効になります。Red Hat は Storage vMotion をサポートしていないため、OpenShift Container Platform クラスターのデータ損失の問題を回避するには、Storage vMotion を無効にする必要があります。
複数のデータストアにわたって仮想マシンを指定する必要がある場合は、 | 文字列 |
platform: vsphere: failureDomains: topology: folder:
|
オプション: ユーザーが仮想マシンを作成する既存のフォルダーの絶対パス (例: | 文字列 |
platform: vsphere: failureDomains: topology: hostGroup:
| 障害ドメインに関連付ける vSphere ホストグループを指定します。 重要 vSphere ホストグループに対する OpenShift ゾーンのサポートは、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。 Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。 | 文字列 |
platform: vsphere: failureDomains: topology: networks:
| 設定した仮想 IP アドレスと DNS レコードを含む vCenter インスタンス内のネットワークをリスト表示します。 | 文字列 |
platform: vsphere: failureDomains: topology: resourcePool:
|
オプション: このパラメーターは、インストールプログラムが仮想マシンを作成する既存のリソースプールの絶対パスを設定します (例: | 文字列 |
platform: vsphere: failureDomains: topology template:
| 既存の Red Hat Enterprise Linux CoreOS (RHCOS) イメージテンプレートまたは仮想マシンへの絶対パスを指定します。その後、インストールプログラムはイメージテンプレートまたは仮想マシンを使用して、vSphere ホストに RHCOS を迅速にインストールできます。RHCOS イメージを vSphere ホストにアップロードする代わりに、このパラメーターを使用することを検討してください。このパラメーターは、installer-provisioned infrastructure でのみ使用できます。 | 文字列 |
platform: vsphere: vcenters:
| サービスが vCenter サーバーと通信できるように接続の詳細を設定します。 | vCenter 設定オブジェクトの配列。 |
platform: vsphere: vcenters: datacenters:
|
OpenShift Container Platform 仮想マシン (VM) が動作するデータセンターをリストして定義します。データセンターのリストは、 | 文字列 |
platform: vsphere: vcenters: password:
| vSphere ユーザーに関連付けられたパスワード。 | 文字列 |
platform: vsphere: vcenters: port:
| vCenter サーバーとの通信に使用するポート番号。 | 整数 |
platform: vsphere: vcenters: server:
| vCenter サーバーの完全修飾ホスト名 (FQHN) または IP アドレス。 | 文字列 |
platform: vsphere: vcenters: user:
| vSphere ユーザーに関連付けられたユーザー名。 | 文字列 |
8.1.6. 非推奨の VMware vSphere 設定パラメーター リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform 4.13 では、次の vSphere 設定パラメーターが非推奨になりました。これらのパラメーターは引き続き使用できますが、インストールプログラムはこれらのパラメーターを install-config.yaml
ファイルに自動的に指定しません。
次の表に、非推奨になった各 vSphere 設定パラメーターを示します。
パラメーター | 説明 | 値 |
---|---|---|
platform: vsphere: cluster:
| OpenShift Container Platform クラスターをインストールする vCenter クラスター。 | 文字列 |
platform: vsphere: datacenter:
| OpenShift Container Platform 仮想マシン (VM) が動作するデータセンターを定義します。 | 文字列 |
platform: vsphere: defaultDatastore:
| ボリュームのプロビジョニングに使用するデフォルトデータストアの名前。 | 文字列 |
platform: vsphere: folder:
| オプション: インストールプログラムが仮想マシンを作成する既存のフォルダーの絶対パス。この値を指定しない場合、インストールプログラムは、データセンターの仮想マシンフォルダーにインフラストラクチャー ID を使用して名前が付けられたフォルダーを作成します。 |
文字列 (例: |
platform: vsphere: password:
| vCenter ユーザー名のパスワード。 | 文字列 |
platform: vsphere: resourcePool:
|
オプション: インストールプログラムが仮想マシンを作成する既存のリソースプールの絶対パス。値を指定しない場合、インストールプログラムは |
文字列 (例: |
platform: vsphere: username:
| vCenter インスタンスに接続するために使用するユーザー名。このユーザーには、vSphere での 静的または動的な永続ボリュームのプロビジョニング に必要なロールと特権が少なくとも必要です。 | 文字列 |
platform: vsphere: vCenter:
| vCenter サーバーの完全修飾ホスト名または IP アドレス。 | 文字列 |