8.2. 使用可能なエージェント設定パラメーター


次の表に、エージェントベースのインストールプロセスの一部として設定できる必須およびオプションのエージェント設定パラメーターを示します。

これらの値は、agent-config.yaml ファイルに指定されています。

注記

これらの設定はインストールのみに使用され、インストール後は変更できません。

8.2.1. 必須設定パラメーター

次の表は、必須のエージェント設定パラメーターを説明しています。

Expand
表8.7 必須パラメーター
パラメーター説明
apiVersion:

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

値: 文字列

metadata:

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

値: オブジェクト

metadata:
  name:

クラスターの名前。クラスターの DNS レコードはすべて {{.metadata.name}}.{{.baseDomain}} のサブドメインです。agent-config.yaml ファイルに入力された値は無視され、代わりに install-config.yaml ファイルに指定された値が使用されます。install-config.yaml ファイルまたは agent-config.yaml ファイルのいずれかを介して metadata.name を指定しない場合 (たとえば、ZTP マニフェストのみを使用する場合)、クラスター名は agent-cluster に設定されます。

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

8.2.2. オプションの設定パラメーター

次の表は、オプションのエージェント設定パラメーターを説明しています。

Expand
表8.8 オプションのパラメーター
パラメーター説明
rendezvousIP:

ブートストラッププロセスを実行し、assisted-service コンポーネントを実行するノードの IP アドレス。networkConfig パラメーターで少なくとも 1 つのホストの IP アドレスを指定しない場合は、ランデブー IP アドレスを指定する必要があります。このアドレスが指定されていない場合は、指定されたホストの networkConfig から 1 つの IP アドレスが選択されます。

値: IPv4 または IPv6 アドレス。

bootArtifactsBaseURL:

Agent-based Installer を使用して最小限の ISO イメージを生成する場合、このパラメーターで、クラスターのインストール中に rootfs イメージファイルを取得できる URL を指定します。このパラメーターは、接続環境で最小限の ISO イメージを起動する場合に任意で指定します。

Agent-based Installer を使用して iPXE スクリプトを生成する場合、このパラメーターで、Preboot Execution Environment (PXE) アセットをアップロードするサーバーの URL を指定します。詳細は、「OpenShift Container Platform の PXE アセットの準備」を参照してください。

値: 文字列。

additionalNTPSources:

すべてのクラスターホストに追加される Network Time Protocol (NTP) ソースのリスト。これらは、他の手段で設定された NTP ソースに追加されます。

値: ホスト名または IP アドレスのリスト。

hosts:

ホストの設定。オプションのホストリスト。定義されたホストの数は、install-config.yaml ファイルで定義されたホストの総数 (compute.replicas および controlPlane.replicas パラメーターの値の合計) を超えてはなりません。

値: ホスト設定オブジェクトの配列。

hosts:
  hostname:

ホスト名。動的ホスト設定プロトコル (DHCP) または逆引き DNS ルックアップから取得したホスト名をオーバーライドします。各ホストには、いずれかの手段で指定された一意のホスト名が必要ですが、このパラメーターを使用したホスト名の設定はオプションです。

値: 文字列。

hosts:
  interfaces:

ホスト上のインターフェイスの名前と MAC アドレスのマッピングテーブルを提供します。agent-config.yaml ファイルに NetworkConfig セクションが指定されている場合は、このテーブルを含める必要があり、値は NetworkConfig セクションで指定されたマッピングと一致する必要があります。

値: ホスト設定オブジェクトの配列。

hosts:
  interfaces:
    name:

ホスト上のインターフェイスの名前。

値: 文字列。

hosts:
  interfaces:
    macAddress:

ホスト上のインターフェイスの MAC アドレス。

値: たとえば 00-B0-D0-63-C2-26 などの MAC アドレス。

hosts:
  role:

ホストが master ノードと worker ノードのどちらであるかを定義します。agent-config.yaml ファイルにロールが定義されていない場合は、クラスターのインストール時にロールがランダムに割り当てられます。

値: master または worker

hosts:
  rootDeviceHints:

特定デバイスへの Red Hat Enterprise Linux CoreOS (RHCOS) イメージのプロビジョニングを有効にします。インストールプログラムは、検出順にデバイスを検査し、検出された値をヒントの値と比較します。ヒントの値と一致する最初に検出されたデバイスが使用されます。これは、インストール中にオペレーティングシステムが書き込まれるデバイスです。

値: キーと値のペアのディクショナリー。詳細は、「OpenShift インストール環境のセットアップ」ページの「ルートデバイスのヒント」を参照してください。

hosts:
  rootDeviceHints:
    deviceName:

RHCOS イメージがプロビジョニングされるデバイスの名前。

値: 文字列。

hosts:
  networkConfig:

ホストネットワーク定義。この設定は、nmstate ドキュメント で定義されている Host Network Management API と一致する必要があります。

値: ホストネットワーク設定オブジェクトのディクショナリー。

minimalISO:

Agent-based Installer によって完全な ISO イメージを生成するか、最小限の ISO イメージを生成するかを定義します。このパラメーターを True に設定すると、Agent-based Installer は、rootfs イメージファイルなしで ISO を生成し、代わりに rootfs ファイルの取得元に関する詳細を含めます。

最小限の ISO を生成する場合、bootArtifactsBaseURL パラメーターを使用して rootfs の URL を指定しないと、Agent-based Installer により、インターネット接続環境でアクセス可能なデフォルトの URL が埋め込まれます。

デフォルト値は False です。

値: ブール値。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る