22.5. プロビジョニング metal3.io/v1alpha1

bootIsoSource

string

BootIsoSource は、ノードを起動する ISO イメージが提供される場所を設定する方法を提供します。デフォルトでは、ブート ISO イメージはローカルにキャッシュされ、補助 httpd サーバーを使用してプロビジョニングサービス (Ironic) ノードから提供されます。ブート ISO イメージがすでに httpd サーバーによって提供されている場合、このオプションを http に設定すると、そこからイメージを直接提供できます。この場合、ブート ISO をホストする httpd サーバーが存在するネットワーク (内部または外部) には、metal3Pod からアクセスできる必要があります。

preProvisioningOSDownloadURLs

object

PreprovisioningOSDownloadURLs は、仮想メディアまたは PXE のいずれかを使用してワーカーをプロビジョニングするために必要な CoreOSLiveURL のセットです。

provisioningDHCPExternal

ブール値

ProvisioningDHCPExternal は、プロビジョニング DHCP 範囲内の IP アドレスの DHCP サーバーが metal3 クラスター内に存在するか外部に存在するかを示します。このフィールドは、provisioningNetwork を優先して非推奨になりました。

provisioningDHCPRange

string

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 番目のアドレスは範囲内の最後の使用可能なアドレスを表します。

provisioningIP

string

ProvisioningIP は、ベアメタルサーバーの provisioningInterface に割り当てられた IP アドレスです。この IP アドレスは、プロビジョニングサブネット内にあり、DHCP 範囲外にある必要があります。

provisioningInterface

string

ProvisioningInterface は、プロビジョニングネットワークへのベアメタルサーバー上のネットワークインターフェイスの名前です。eth1 や ens3 のような値を持つことができます。

provisioningMacAddresses

array (string)

ProvisioningMacAddresses は、プロビジョニングネットワークへのベアメタルサーバー上のネットワークインターフェイスの MAC アドレスのリストです。異なる名前のインターフェイスを許可するには、ProvisioningInterface の代わりにこれを使用します。指定しない場合は、各マスターの BMH.Spec.BootMacAddress によって入力されます。

provisioningNetwork

string

ProvisioningNetwork は、プロビジョニングネットワークの基盤となるネットワーク設定の状態を示す方法を提供します。プロビジョニングネットワークがベアメタル IPI ソリューションによって完全に管理されている場合、このフィールドには次のいずれかの値 (管理対象) を指定できます。管理 されていない - プロビジョニングネットワークが存在して使用されているが、ユーザーが DHCP を管理する責任がある場合。仮想メディアのプロビジョニングが推奨されますが、必要に応じて PXE を引き続き利用できます。無効 - プロビジョニングネットワークが完全に無効になっている場合。ユーザーは、仮想メディアまたはアシストインストールを使用してベアメタルクラスターを起動できます。電力管理に metal3 を使用する場合は、マシンネットワークから BMC にアクセスできる必要があります。ユーザーは、プロビジョニングサービスに使用される外部ネットワーク上に 2 つの IP を提供する必要があります。

provisioningNetworkCIDR

string

ProvisioningNetworkCIDR は、ベアメタルノードがプロビジョニングされるネットワークです。プロビジョニング IP と dhcpRange 内の IP はすべて、このネットワーク内から取得されます。IPv6 を使用していて、ベアメタル IPI ソリューションによって管理されているネットワークでは、これを/64 よりも大きいネットワークにすることはできません。

provisioningOSDownloadURL

string

ProvisioningOSDownloadURL は、ベアメタルホストマシンの起動に使用される OS イメージを metal3 クラスターがダウンロードできる場所です。

virtualMediaViaExternalNetwork

ブール値

VirtualMediaViaExternalNetwork フラグを true に設定すると、ワーカーは仮想メディアを介して起動し、外部ネットワークを介して metal3 に接続できます。フラグが false (デフォルト) に設定されている場合でも、仮想メディアの展開は、ProvisioningNetwork で指定された設定に基づいて行うことができます。つまり、無効モードの場合、外部ネットワーク、および管理モードの場合はプロビジョニングネットワークを介して行われます。PXE 展開では、常にプロビジョニングネットワークが使用され、このフラグの影響を受けません。

watchAllNamespaces

ブール値

WatchAllNamespaces は、すべての名前空間でこのプロビジョニング設定の使用を明示的に許可する方法を提供します。これはオプションの設定であり、デフォルトは false であり、その状態では、openshift-machine-api 名前空間でのみベアメタルホストをプロビジョニングするために使用されます。true に設定すると、このプロビジョニング設定は、すべてのネームスペースのベアメタルホストに使用されます。

initramfsURL

string

InitramfsURLPXE 展開に使用されるイメージ URL

isoURL

string

ライブ ISO 展開に使用される IsoURL イメージ URL

kernelURL

string

KernelURL は、PXE 展開に使用されるイメージ URL です。

rootfsURL

string

PXE 展開に使用される RootfsURL イメージ URL

conditions

array

条件は、条件とそのステータスのリストです

conditions[]

object

OperatorCondition は、単なる標準の条件フィールドです。

generations

array

世代は、アイテムを調整する必要がある場合、または反応が必要な方法で変更された場合を判別するために使用されます。

generations[]

object

GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。

observedGeneration

integer

observedGeneration はあなたが扱った最後の世代の変更です

readyReplicas

integer

readyReplicas は、準備ができて目的の状態にあるレプリカの数を示します

version

string

バージョンは、この可用性が適用されるレベルです

lastTransitionTime

string

message

string

reason

string

status

string

type

string

group

string

グループはあなたが追跡しているもののグループです

ハッシュ

string

ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。

lastGeneration

integer

lastGeneration は、関連するワークロードコントローラーの最後の世代です。

name

string

name は、追跡しているものの名前です

namespace

string

名前空間は、追跡しているものがどこにあるかです

resource

string

リソースは、追跡しているもののリソースタイプです

pretty

string

'true' の場合、出力はきれいに印刷されます。

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

200 - OK

Status_v2 schema

401 - Unauthorized

空白

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

200 - OK

ProvisioningList スキーマ

401 - Unauthorized

空白

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

ボディー

プロビジョニング スキーマ

200 - OK

プロビジョニング スキーマ

201 - Created

プロビジョニング スキーマ

202 - Accepted

プロビジョニング スキーマ

401 - Unauthorized

空白

name

string

プロビジョニングの名前

pretty

string

'true' の場合、出力はきれいに印刷されます。

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

gracePeriodSeconds

integer

オブジェクトが削除されるまでの時間 (秒)。値は負の値ではない整数にする必要があります。値をゼロに指定すると、ただちに削除されます。この値が nil の場合、指定されたタイプのデフォルトの猶予期間が使用されます。指定しない場合、デフォルトでオブジェクトごとの値になります。ゼロはすぐに削除することを意味します。

orphanDependents

boolean

非推奨: PropagationPolicy を使用してください。このフィールドは 1.7 で非推奨となります。依存オブジェクトが孤立している必要があります。true/false の場合、孤立したファイナライザーがオブジェクトのファイナライザー一覧で追加/削除されます。このフィールドまたは PropagationPolicy のいずれかを設定できますが、両方を設定することはできません。

propagationPolicy

string

ガベージコレクションが実行されるかどうか、およびその方法。このフィールドまたは OrphanDependents のどちらかを設定できますが、両方を設定することはできません。デフォルトポリシーは、metadata.finalizers に設定されている既存のファイナライザーとリソース固有のデフォルトポリシーによって決定されます。許容値は次のとおりです。'Orphan' - 依存を削除して孤立させます。'Background' - ガベージコレクターがバックグラウンドで依存関係を削除できるようにします。'Foreground' - フォアグラウンド内のすべての依存関係を削除するカスケードポリシー。

body

DeleteOptions_v2 schema

200 - OK

Status_v2 schema

202 - Accepted

Status_v2 schema

401 - Unauthorized

空白

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

200 - OK

プロビジョニング スキーマ

401 - Unauthorized

空白

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

body

Patch schema

200 - OK

プロビジョニング スキーマ

401 - Unauthorized

空白

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

ボディー

プロビジョニング スキーマ

200 - OK

プロビジョニング スキーマ

201 - Created

プロビジョニング スキーマ

401 - Unauthorized

空白

name

string

プロビジョニングの名前

pretty

string

'true' の場合、出力はきれいに印刷されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

200 - OK

プロビジョニング スキーマ

401 - Unauthorized

空白

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

body

Patch schema

200 - OK

プロビジョニング スキーマ

401 - Unauthorized

空白

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

ボディー

プロビジョニング スキーマ

200 - OK

プロビジョニング スキーマ

201 - Created

プロビジョニング スキーマ

401 - Unauthorized

空白