第10章 Provisioning [metal3.io/v1alpha1]
- 説明
- Provisioning には、Provisioning サービス (Ironic) がベアメタルホストをプロビジョニングするために使用する設定が含まれています。Provisioning は、プロビジョニングネットワークおよび PXE ブートに使用できるサーバー上の NIC に関する管理者またはユーザー提供の情報を使用して、OpenShift インストーラーによって作成されます。この CR はシングルトンであり、インストーラーによって作成され、現在、metal3 クラスター内のコンテナーを起動および更新するために cluster-baremetal-operator によってのみ使用されます。
- 型
-
object
10.1. 仕様
プロパティー | 型 | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| ProvisioningSpec は、プロビジョニングの望ましい状態を定義します。 |
|
| ProvisioningStatus は、Provisioning の観測状態を定義します。 |
10.1.1. .spec
- 説明
- ProvisioningSpec は、プロビジョニングの望ましい状態を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| BootIsoSource は、ノードを起動する ISO イメージが提供される場所を設定する方法を提供します。デフォルトでは、ブート ISO イメージはローカルにキャッシュされ、補助 httpd サーバーを使用してプロビジョニングサービス (Ironic) ノードから提供されます。ブート ISO イメージがすでに httpd サーバーによって提供されている場合、このオプションを http に設定すると、そこからイメージを直接提供できます。この場合、ブート ISO をホストする httpd サーバーが存在するネットワーク (内部または外部) には、metal3 Pod からアクセスできる必要があります。 |
|
| DisableVirtualMediaTLS は、仮想メディアサーバー上の TLS をオフにします。これは、HTTPS リンクを受け入れることができないハードウェアに必要な場合があります。 |
|
| preProvisioningOSDownloadURLs は、仮想メディアまたは PXE のいずれかを使用してワーカーをプロビジョニングするために必要な CoreOS Live URL のセットです。 |
|
| provisioningDHCPExternal は、プロビジョニング DHCP 範囲内の IP アドレスの DHCP サーバーが metal3 クラスター内に存在するか外部に存在するかを示します。このフィールドは、provisioningNetwork を優先して非推奨になりました。 |
|
| provisioningDHCPRange は、provisioningDHCPExternal と一緒に解釈する必要があります。provisioningDHCPExternal の値が False に設定されている場合、provisioningDHCPRange は、metal3 クラスター内で実行されている DHCP サーバーがベアメタルサーバーのプロビジョニング中に使用できる IP アドレスの範囲を表します。ProvisioningDHCPExternal の値が True に設定されている場合、ProvisioningDHCPRange の値は無視されます。provisioningDHCPExternal の値が False に設定され、内部 DHCP サーバーを示し、provisioningDHCPRange の値が設定されていない場合、DHCP 範囲は、provisioningNetworkCIDR の.10 から.100 までのデフォルト範囲と見なされます。これは、インストーラーが CR を作成した後に変更できる、すべてのプロビジョニング設定の唯一の値です。この値は、provisioningNetworkCIDR 内の 2 つのコンマで区切られた IP アドレスである必要があります。ここで、1 番目のアドレスは範囲の開始を表し、2 番目のアドレスは範囲内の最後の使用可能なアドレスを表します。 |
|
| provisioningDNS を使用すると、プロビジョニングネットワーク上で DHCP 経由で DNS 情報を送信できます。Provisioning サービス自体 (Ironic) は DNS を必要としないため、デフォルトではオフになっていますが、階層化製品 (ZTP など) では役立つ場合があります。 |
|
| provisioningIP は、ベアメタルサーバーの provisioningInterface に割り当てられた IP アドレスです。この IP アドレスは、プロビジョニングサブネット内にあり、DHCP 範囲外にある必要があります。 |
|
| provisioningInterface は、プロビジョニングネットワークへのベアメタルサーバー上のネットワークインターフェイスの名前です。eth1 や ens3 のような値を持つことができます。 |
|
| provisioningMacAddresses は、プロビジョニングネットワークへのベアメタルサーバー上のネットワークインターフェイスの MAC アドレスのリストです。異なる名前のインターフェイスを許可するには、provisioningInterface の代わりにこれを使用します。指定しない場合は、各マスターの BMH.Spec.BootMacAddress によって入力されます。 |
|
|
provisioningNetwork は、プロビジョニングネットワークの基盤となるネットワーク設定の状態を示す方法を提供します。プロビジョニングネットワークがベアメタル IPI ソリューションによって完全に管理されている場合、このフィールドには次のいずれかの値 ( |
|
| provisioningNetworkCIDR は、ベアメタルノードがプロビジョニングされるネットワークです。provisioningIP と dhcpRange 内の IP はすべて、このネットワーク内から取得されます。IPv6 を使用していて、ベアメタル IPI ソリューションによって管理されているネットワークでは、これを/64 よりも大きいネットワークにすることはできません。 |
|
| ProvisioningOSDownloadURL は、ベアメタルホストマシンの起動に使用される OS イメージを metal3 クラスターがダウンロードできる場所です。 |
|
| VirtualMediaViaExternalNetwork フラグを "true" に設定すると、ワーカーは仮想メディアを介して起動し、外部ネットワークを介して metal3 に接続できます。フラグが "false" (デフォルト) に設定されている場合でも、仮想メディアのデプロイメントは、provisioningNetwork で指定された設定に基づいて行うことができます。つまり、無効モードの場合、外部ネットワーク、および管理モードの場合はプロビジョニングネットワークを介して行われます。PXE デプロイメントでは、常にプロビジョニングネットワークが使用され、このフラグの影響を受けません。 |
|
| WatchAllNamespaces は、すべての Namespace でこの Provisioning 設定の使用を明示的に許可する方法を提供します。これはオプションの設定であり、デフォルトは false であり、その状態では、openshift-machine-api namespace でのみベアメタルホストをプロビジョニングするために使用されます。true に設定すると、このプロビジョニング設定は、すべてのネームスペースのベアメタルホストに使用されます。 |
10.1.2. .spec.preProvisioningOSDownloadURLs
- 説明
- preProvisioningOSDownloadURLs は、仮想メディアまたは PXE のいずれかを使用してワーカーをプロビジョニングするために必要な CoreOS Live URL のセットです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| InitramfsURLPXE デプロイメントに使用されるイメージ URL |
|
| ライブ ISO デプロイメントに使用される IsoURL イメージ URL |
|
| KernelURL は、PXE デプロイメントに使用されるイメージ URL です。 |
|
| PXE デプロイメントに使用される RootfsURL イメージ URL |
10.1.3. .status
- 説明
- ProvisioningStatus は、Provisioning の観測状態を定義します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| conditions は、状態とそのステータスのリストです。 |
|
| OperatorCondition は、標準の状態フィールドです。 |
|
| generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。 |
|
| GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。 |
|
| observedGeneration はあなたが扱った最後の世代の変更です |
|
| readyReplicas は、準備ができて目的の状態にあるレプリカの数を示します |
|
| バージョンは、この可用性が適用されるレベルです |
10.1.4. .status.conditions
- 説明
- conditions は、状態とそのステータスのリストです。
- 型
-
array
10.1.5. .status.conditions[]
- 説明
- OperatorCondition は、標準の状態フィールドです。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
|
10.1.6. .status.generations
- 説明
- generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。
- 型
-
array
10.1.7. .status.generations[]
- 説明
- GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| グループはあなたが追跡しているもののグループです |
|
| ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。 |
|
| lastGeneration は、関連するワークロードコントローラーの最後の世代です。 |
|
| name は、追跡しているものの名前です |
|
| 名前空間は、追跡しているものがどこにあるかです |
|
| リソースは、追跡しているもののリソースタイプです |