OperatorHub API

address

string

アドレスは、OLM が既存のレジストリーに接続するために使用できるホストです。形式: <registry-host or ip>:<port> SourceType = SourceTypeGrpc の場合にのみ使用されます。イメージフィールドが設定されている場合は無視されます。

configMap

string

ConfigMap は、configmap-server レジストリーをバックアップするために使用される ConfigMap の名前です。SourceType=SourceTypeConfigmap または SourceTypeInternal の場合にのみ使用されます。

description

string

displayName

string

メタデータ

grpcPodConfig

object

GrpcPodConfig は、CatalogSource Pod の Pod 仕様のさまざまなオーバーライドを公開します。SourceType = SourceTypeGrpc かつ Image が設定されている場合にのみ使用されます。

icon

object

image

string

イメージは、レジストリーサーバーをインスタンス化するための Operator レジストリーコンテナーイメージです。SourceType=SourceTypeGrpc の場合にのみ使用されます。存在する場合、アドレスフィールドは無視されます。

priority

integer

優先度フィールドは、カタログソースに重みを割り当てて優先順位を付け、依存関係リゾルバーで使用できるようにします。使用法: 重みが大きいほど、依存関係の解決時に、重みが小さいカタログソースよりもこのカタログソースが優先されることを示します。優先度の値の範囲は、int32 の範囲で正から負になります。優先度が割り当てられていないカタログソースのデフォルト値は 0 です。同じ優先度の値を持つカタログソースは、その名前に基づいて辞書式にランク付けされます。

publisher

string

runAsRoot

boolean

RunAsRoot を使用すると、管理者は CatalogSource Pod を特権付き Pod で root として実行することを指定できます。これは、root 以外で実行できなかった古いカタログイメージを実行する場合にのみ有効にしてください。

secrets

array (string)

シークレットは、カタログのコンテンツにアクセスするために使用できるシークレットのセットを表します。カタログエントリーごとにそれぞれを試す必要があるため、このリストは小さくしておくことを推奨します。

sourceType

string

SourceType はソースのタイプです

updateStrategy

object

UpdateStrategy は、更新されたカタログソースイメージを検出する方法を定義します。ポーリング期間と埋め込まれた戦略タイプを定義する間隔で設定されます。

affinity

object

Affinity は、カタログソースの Pod のアフィニティーです。

extractContent

object

ExtractContent は、提供されたインデックスイメージからカタログメタデータを抽出し、既知のバージョンの opm サーバーを使用してそれを公開するように gRPC カタログ Pod を設定します。この機能を利用するには、この CatalogSource が使用するように設定されているカタログインデックスイメージで、ファイルベースのカタログが使用されている 必要があります。

memoryTarget

integer-or-string

MemoryTarget は、gRPC カタログ Pod の $GOMEMLIMIT 値を設定します。これはサーバーのソフトメモリー制限です。ランタイムはこの制限を満たすよう試みますが、制限が必ず満たされるという保証はありません。この値が設定されている場合、Pod はサーバーを実行しているコンテナーに次の変更を加えます。- $GOMEMLIMIT 環境変数をこの値 (バイト単位) に設定する - メモリー要求をこの値に設定する

このフィールドは、カタログサーバーのフットプリントを可能な限り削減する場合、または提供されるカタログが非常に大きく、デフォルトの割り当てよりも多くのサイズが必要な場合に設定してください。インデックスイメージにファイルシステムキャッシュがある場合は、インデックスイメージの/tmp/cache/cache/packages.json にあるパッケージキャッシュのサイズを 2 倍にして、この値の近似値を決定してください。

このフィールドはベストエフォートです。設定されていないと、デフォルト値が使用されず、Pod メモリー制限も $GOMEMLIMIT 値も設定されません。

nodeSelector

object (string)

NodeSelector は、Pod がノードに収まるようにするために true である必要があるセレクターです。そのノードでスケジュールされる Pod のノードのラベルと一致する必要があるセレクター。

priorityClassName

string

指定した場合、Pod の優先度を示します。指定しない場合、Pod の優先度はデフォルトになり、デフォルトがない場合はゼロになります。

securityContextConfig

string

SecurityContextConfig は、legacy または restricted のいずれかになります。CatalogSource の Pod に、適切な pod.spec.securityContext 値と pod.spec.container[*].securityContext 値が注入され、Pod が Pod Security Admission (PSA) の restricted モードで実行できるようになります。これらの値がまったく設定されていない場合、Pod は PSA の baseline または privileged namespace でのみ実行できます。SecurityContextConfig が指定されていない場合、モードは namespace の PSA 設定によって決定されます。namespace が restricted モードを適用している場合、Pod は restricted が指定されている場合と同様に設定されます。そうでない場合、Pod は legacy が指定されている場合と同様に設定されます。legacy または restricted 以外の値を指定すると、検証エラーが発生します。restricted モードで実行できない古いカタログイメージを使用する場合は、SecurityContextConfig を legacy に設定する必要があります。

PSA の詳細は、https://kubernetes.io/docs/concepts/security/pod-security-admission/ を参照してください。

tolerations

array

toleration は、カタログソースの Pod の toleration です。

tolerations[]

object

この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致する taint を許容します。

nodeAffinity

object

Pod のノードアフィニティースケジューリングルールを説明します。

podAffinity

object

Pod アフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置します)。

podAntiAffinity

object

Pod のアンチアフィニティースケジューリングルールを説明します (たとえば、この Pod を他の Pod と同じノード、ゾーンなどに配置しないでください)。

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードが対応する matchExpressions と一致する場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

空の優先スケジューリング用語は、暗黙の重み 0 を持つすべてのオブジェクトに一致します (つまり、操作なしです)。null の優先スケジューリング用語は、オブジェクトに一致しません (つまり、no-op でもあります)。

requiredDuringSchedulingIgnoredDuringExecution

object

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (更新など)、システムは最終的に Pod をノードから退避しようとする場合としない場合があります。

preference

object

対応する重みに関連付けられたノードセレクター用語。

weight

integer

対応する nodeSelectorTerm の一致に関連する重み (1〜100 の範囲)。

matchExpressions

array

ノードのラベルごとのノードセレクター要件のリスト。

matchExpressions[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchFields

array

ノードのフィールドごとのノードセレクター要件のリスト。

matchFields[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

values

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

values

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

nodeSelectorTerms

array

必須。ノードセレクター用語のリスト。用語は OR されています。

nodeSelectorTerms[]

object

null または空のノードセレクター用語はオブジェクトに一致しません。これらの要件は AND で結合されます。TopologySelectorTerm タイプは、NodeSelectorTerm のサブセットを実装します。

matchExpressions

array

ノードのラベルごとのノードセレクター要件のリスト。

matchExpressions[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchFields

array

ノードのフィールドごとのノードセレクター要件のリスト。

matchFields[]

object

ノードセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

values

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

key

string

セレクターが適用されるラベルキー。

operator

string

キーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Gt、および Lt。

values

array (string)

文字列値の配列。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。Operator が Gt または Lt の場合、values 配列には、整数として解釈される単一の要素が必要です。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アフィニティー式など) を満たすノードごとに、このフィールドの要素を反復処理して合計を計算します。ノードに対応する podAffinityTerm に一致する Pod がある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。

requiredDuringSchedulingIgnoredDuringExecution

array

このフィールドで指定されたアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから退避しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。

requiredDuringSchedulingIgnoredDuringExecution[]

object

この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。

podAffinityTerm

object

必須。対応する重みに関連付けられた Pod アフィニティー用語。

weight

integer

対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。matchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。

namespaceSelector

object

用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。

namespaces

array (string)

namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび null namespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。matchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。

namespaceSelector

object

用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。

namespaces

array (string)

namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび null namespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

preferredDuringSchedulingIgnoredDuringExecution

array

スケジューラーは、このフィールドで指定されたアンチアフィニティー式を満たすノードに Pod をスケジュールすることを好みますが、1 つ以上の式に違反するノードを選択する場合があります。最も優先されるノードは、重みの合計が最大のノードです。つまり、すべてのスケジューリング要件 (リソース要求、requiredDuringScheduling アンチアフィニティー式など) を満たすノードごとに、の要素を反復処理して合計を計算します。このフィールドと、対応する podAffinityTerm に一致する Pod がノードにある場合は、合計に "重み" を追加します。合計が最も高いノードが最も優先されます。

preferredDuringSchedulingIgnoredDuringExecution[]

object

一致したすべての WeightedPodAffinityTerm フィールドの重みがノードごとに追加され、最も優先されるノードが検索されます。

requiredDuringSchedulingIgnoredDuringExecution

array

このフィールドで指定されたアンチアフィニティー要件がスケジュール時に満たされない場合、Pod はノードにスケジュールされません。このフィールドで指定されたアンチアフィニティー要件が Pod 実行中のある時点で満たされない場合 (Pod ラベルの更新など)、システムは最終的に Pod をノードから退避しようとする場合としない場合があります。複数の要素がある場合、各 podAffinityTerm に対応するノードのリストが交差します。つまり、すべての用語が満たされる必要があります。

requiredDuringSchedulingIgnoredDuringExecution[]

object

この Pod を同じ場所に配置する (アフィニティー) または同じ場所に配置しない (アンチアフィニティー) 必要がある Pod のセット (つまり、指定された namespace に対して labelSelector に一致するもの) を定義します。この場合の同じ場所とは、キー <topologyKey> のラベルの値が、一連の Pod の Pod が実行されているノードの値と一致するノードで実行されていることを意味します。

podAffinityTerm

object

必須。対応する重みに関連付けられた Pod アフィニティー用語。

weight

integer

対応する podAffinityTerm の一致に関連する重み (1〜100 の範囲)。

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。matchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。

namespaceSelector

object

用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。

namespaces

array (string)

namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび null namespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

labelSelector

object

リソースのセット (この場合は Pod) に対するラベルクエリー。null の場合、この PodAffinityTerm はどの Pod とも一致しません。

matchLabelKeys

array (string)

MatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key in (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。matchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、matchLabelKeys は設定できません。

mismatchLabelKeys

array (string)

MismatchLabelKeys は、考慮する Pod を選択するための Pod ラベルキーのセットです。キーは、着信 Pod ラベルから値を検索するために使用され、それらのキー値ラベルは key notin (value) として labelSelector にマージされ、着信 Pod の Pod アフィニティー (アンチアフィニティー) として考慮される既存の Pod のグループを選択します。受信 Pod ラベルに存在しないキーは無視されます。デフォルト値は空です。mismatchLabelKeys と labelSelector の両方に同じキーが存在することは禁止されています。また、labelSelector が設定されていない場合、mismatchLabelKeys は設定できません。

namespaceSelector

object

用語が適用される namespace のセットに対するラベルクエリー。この用語は、このフィールドで選択された namespace と、namespace フィールドにリストされている namespace の和集合に適用されます。null セレクターと null または空の namespace リストは "この Pod の namespace" を意味します。空のセレクター ({}) は、すべての namespace に一致します。

namespaces

array (string)

namespaces は、用語が適用される namespace 名の静的リストを指定します。この用語は、このフィールドにリストされている namespace と、namespaceSelector によって選択された namespace の和集合に適用されます。null または空の namespace リストおよび null namespaceSelector は、"この Pod の namespace" を意味します

topologyKey

string

この Pod は、指定された namespace の labelSelector と一致する Pod と同じ場所 (affinity) または異なる場所 (anti-affinity) に配置します。同じ場所とは、topologyKey キーが含まれるラベルの値が一致し、選択した Pod のいずれかが実行されているノード上で実行されていることを意味します。空の topologyKey は許可されていません。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

cacheDir

string

CacheDir は、事前に計算された API キャッシュを保存するディレクトリー (オプション) です。

catalogDir

string

CatalogDir は、ファイルベースのカタログコンテンツを格納するディレクトリーです。

effect

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) が taint を許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (退避しないでください)。ゼロ値と負の値は、システムによって 0 (すぐに退避) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

base64data

string

mediatype

string

registryPoll

object

interval

string

間隔は、最新のカタログソースバージョンのチェック間の時間間隔を決定するために使用されます。カタログ Operator は、カタログソースの新しいバージョンが利用可能かどうかを確認するためにポーリングします。利用可能な場合、最新のイメージがプルされ、gRPC トラフィックは最新のカタログソースに転送されます。

conditions

array

CatalogSource の状態を表します。メッセージと理由は元のステータス情報を表し、将来的に条件に基づいて移行される可能性があることに注意してください。導入された新機能はすべて条件を使用します。

conditions[]

object

condition には、この API Resource の現在の状態のある側面の詳細が含まれます。

configMapReference

object

ConfigMapReference (非推奨) は、カタログソースが ConfigMap である場合、カタログソースの設定を含む ConfigMap への参照です。

connectionState

object

ConnectionState は、CatalogSource からレジストリーに対する現在の接続の状態を表します。

latestImageRegistryPoll

string

イメージが最新であることを確認するために CatalogSource イメージレジストリーが最後にポーリングされたとき

message

string

CatalogSource がこの状態にある理由の詳細を示す人間が読めるメッセージ。

reason

string

理由は、CatalogSource が現在の状態に移行した理由です。

registryService

object

RegistryService は、カタログを提供するために使用される GRPC サービスの現在の状態を表します。

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。

lastUpdateTime

string

name

string

namespace

string

resourceVersion

string

uid

string

UID は、UUID を含む一意の ID 値を保持するタイプです。UUID のみを使用するわけではないため、これは文字列のエイリアスです。タイプであることは意図を捉え、UID と名前が混同されないようにするのに役立ちます。

address

string

lastConnect

string

lastObservedState

string

createdAt

string

port

string

protocol

string

serviceName

string

serviceNamespace

string

200 - OK

CatalogSourceList スキーマ

401 - Unauthorized

空白

200 - OK

Status スキーマ

401 - Unauthorized

空白

200 - OK

CatalogSourceList スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

body

CatalogSource スキーマ

200 - OK

CatalogSource スキーマ

201 - Created

CatalogSource スキーマ

202 - Accepted

CatalogSource スキーマ

401 - Unauthorized

空白

name

string

CatalogSource の名前

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

200 - OK

CatalogSource スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

200 - OK

CatalogSource スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

body

CatalogSource スキーマ

200 - OK

CatalogSource スキーマ

201 - Created

CatalogSource スキーマ

401 - Unauthorized

空白

name

string

CatalogSource の名前

200 - OK

CatalogSource スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

200 - OK

CatalogSource スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

body

CatalogSource スキーマ

200 - OK

CatalogSource スキーマ

201 - Created

CatalogSource スキーマ

401 - Unauthorized

空白

availabilityMode

string

availabilityMode を使用すると、ユーザーは ClusterCatalog をクラスター上のクライアントがどのように利用できるようにするかを定義できます。availabilityMode はオプションです。

許可される値は "Available"、"Unavailable"、または省略できます。

省略した場合、デフォルト値は "Available" です。

"Available" に設定すると、カタログコンテンツが展開され、カタログコンテンツ HTTP サーバー経由で提供されます。availabilityMode を "Available" に設定すると、クライアントはこの ClusterCatalog とそのコンテンツを使用可能と見なすように指示されます。

"Unavailable" に設定すると、カタログコンテンツはカタログコンテンツ HTTP サーバー経由で提供されなくなります。この availabilityMode に設定されている場合は、ClusterCatalog が存在しない場合と同じように解釈する必要があります。availabilityMode を "Unavailable" に設定すると、ユーザーが ClusterCatalog を完全に削除したくないが、存在しないものとして扱いたい場合に役立ちます。

priority

integer

priority を使用すると、ユーザーは ClusterCatalog の優先度を定義できます。priority はオプションです。

ClusterCatalog の優先度は、クライアントの要件を満たす ClusterCatalog 間で、競合を解消する決定要因 (tie-breaker) としてクライアントによって使用されます。数値が大きいほど優先度が高くなります。

同じ優先度を持つ複数の ClusterCatalog が要件を満たすシナリオをどのように処理するかは、クライアントが決定します。このシナリオで、競合を解消する方法を決定する際は、クライアントがユーザーに追加の入力を促すことが推奨されます。

省略した場合、デフォルトの優先度は 0 になります。これは整数のゼロ値であるためです。

負の数を使用すると、デフォルトよりも低い優先度を指定できます。正の数を使用すると、デフォルトよりも高い優先度を指定できます。

可能な最小値は -2147483648 です。可能な最大値は 2147483647 です。

source

object

source を使用すると、ユーザーはカタログのソースを定義できます。"catalog" には、クラスターにインストールできるコンテンツに関する情報が含まれています。カタログソースを提供すると、カタログの内容が他のクラスター上のコンポーネントによって検出および使用できるようになります。これらのクラスター上のコンポーネントは、GUI ダッシュボードにコンテンツを表示したり、カタログからクラスターにコンテンツをインストールしたりするなど、この情報を使用してさまざまな処理を実行できます。カタログソースには、ファイルベースカタログ (FBC) 形式のカタログメタデータが含まれている必要があります。FBC の詳細は、https://olm.operatorframework.io/docs/reference/file-based-catalogs/#docs を参照してください。source は必須フィールドです。

以下は、イメージからカタログを取得する ClusterCatalogSpec の最小限の例です。

source: type: Image image: ref: quay.io/operatorhubio/catalog:latest

image

object

image は、カタログコンテンツが OCI イメージから取得される方法を設定するために使用されます。このフィールドは、タイプが Image の場合は必須であり、それ以外の場合は禁止されます。

type

string

type は、カタログの提供元のソースのタイプへの参照です。type は必須です。

許可される値は "Image" のみです。

"Image" に設定すると、ClusterCatalog コンテンツは OCI イメージから取得されます。イメージソースを使用する場合は、イメージフィールドを設定する必要があり、このタイプに対して定義されている唯一のフィールドである必要があります。

pollIntervalMinutes

integer

pollIntervalMinutes を使用すると、ユーザーはイメージソースが新しいコンテンツに対してポーリングする間隔を分単位で設定できます。pollIntervalMinutes はオプションです。ref がダイジェストベースの参照である場合は、pollIntervalMinutes を指定できません。

省略すると、イメージは新しいコンテンツに対してポーリングされません。

ref

string

ref を使用すると、ユーザーは Catalog コンテンツを含むコンテナーイメージへの参照を定義できます。ref は必須です。ref は 1000 文字を超えることはできません。

参照は、ドメイン、名前、識別子の 3 つの部分に分けられます。

ドメインは通常、イメージが配置されているレジストリーです。"." 文字で区切られた英数字 (小文字と大文字) である必要があります。ハイフンの使用は許可されますが、ドメインの最初と最後は英数字である必要があります。使用するポートを指定するには、":" 文字の後に数値を追加することもできます。ポートはドメイン内の最後の値である必要があります。有効なドメイン値の例として、"registry.mydomain.io"、"quay.io"、"my-registry.io:8080" などがあります。

名前は通常、イメージが配置されているレジストリー内のリポジトリーです。"."、"_"、"\__"、"-" 文字のみで区切られた小文字の英数字を含める必要があります。複数の名前は、"/" 文字を使用して連結できます。ドメインと名前は、"/" 文字を使用して結合されます。有効な名前の値の例として、"operatorhubio/catalog"、"catalog"、"my-catalog.prod" などがあります。参照のドメイン部分と名前部分が結合された例として、"quay.io/operatorhubio/catalog" があります。

識別子は通常、イメージ参照のタグまたはダイジェストであり、参照の最後に存在します。名前の終わりと識別子の始まりを区別するために使用される区切り文字で始まります。ダイジェストベースの参照の場合は、"@" 文字が区切り文字になります。タグベースの参照の場合、":" 文字が区切り文字になります。参照には識別子が必要です。

ダイジェストベースの参照には、"@" で区切った直後にアルゴリズム参照が含まれている必要があります。アルゴリズム参照の後には、":" 文字とエンコードされた文字列が続く必要があります。アルゴリズムは、大文字または小文字の英字で始まり、その後に英数字が続く必要があり、"-"、"_"、"+"、"." の文字を含めることができます。有効なアルゴリズム値の例として、"sha256"、"sha256+b64u"、"multihash+base58" などがあります。アルゴリズムに続くエンコードされた文字列は 16 進数 (a-f、A-F、0-9) で、最低 32 文字である必要があります。

タグベースの参照は、単語文字 (英数字 + "\_") で始まり、その後に単語文字または "."、および "-" 文字が続く必要があります。タグは 127 文字以下である必要があります。

有効なダイジェストベースのイメージ参照の例として、"quay.io/operatorhubio/catalog@sha256:200d4ddb2a73594b91358fe6397424e975205bfbe44614f5846033cad64b3f05" があります。有効なタグベースのイメージ参照の例として、"quay.io/operatorhubio/catalog:latest" があります。

conditions

array

conditions は、この ClusterCatalog の現在の状態を表します。

現在の状態タイプは、Serving と Progressing です。

Serving 状態は、カタログのコンテンツが HTTP(S) Web サーバー経由で提供されているかどうかを表すために使用されます。ステータスが True で理由が Available の場合、カタログのコンテンツは提供されています。ステータスが False で理由が Unavailable の場合、カタログのコンテンツはまだ利用できないため、提供されていません。ステータスが False で理由が UserSpecifiedUnavailable の場合、カタログは意図的に利用不可とマークされているため、カタログのコンテンツは提供されません。

Progressing 状態は、ClusterCatalog が進行中であるか、または新しい状態へ移行する準備が整っているかどうかを示します。ステータスが True で理由が Retrying の場合、ClusterCatalog の処理中にエラーが発生したものの、後続の調整試行によって解決される可能性があることを意味します。ステータスが True で理由が Succeeded の場合、ClusterCatalog は新しい状態に正常に進み、続行する準備ができています。ステータスが False で理由が Blocked の場合、ClusterCatalog の進行にエラーが発生したため、回復には手動による介入が必要です。

Serving 状態が True で理由が Available であり、Progressing 状態が True で理由が Retrying である場合、新しいバージョンのカタログコンテンツの提供を進めている間も、以前に取得されたカタログコンテンツは HTTP(S) Web サーバー経由で引き続き提供されます。これは、最初にこのカタログのソースから最新のコンテンツを取得し、コンテンツの変更をポーリングしたときに、コンテンツに更新があることが確認された場合に発生する可能性があります。

conditions[]

object

condition には、この API Resource の現在の状態のある側面の詳細が含まれます。

lastUnpacked

string

lastUnpacked は、カタログの内容がソース形式から最後に抽出された時刻を表します。たとえば、イメージソースを使用する場合、OCI イメージがプルされ、イメージレイヤーがファイルシステムにバックアップされたキャッシュに書き込まれます。ソース形式からこの抽出を行う行為を "unpacking" と呼びます。

resolvedSource

object

resolvedSource には、ソースタイプに基づいて解決されたソースに関する情報が含まれます。

urls

object

urls には、カタログにアクセスするために使用できる URL が含まれています。

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。

image

object

image は、イメージから取得されたカタログの解像度情報を格納するフィールドです。タイプが Image の場合、このフィールドを設定する必要があり、それ以外の場合は禁止されます。

type

string

type は、カタログの提供元のソースのタイプへの参照です。type は必須です。

許可される値は "Image" のみです。

"Image" に設定すると、解決されたイメージソースに関する情報が 'image' フィールドに設定されます。

ref

string

ref には、解決されたイメージダイジェストベースの参照が含まれます。ダイジェスト形式を使用すると、ユーザーは他のツールを使用して、カタログの内容を抽出するために使用されたものとまったく同じな OCI マニフェストを取得できます。

base

string

base は、カタログのコンテンツにアクセスするためのエンドポイントを提供するクラスター内部 URL です。

クライアントが、アクセスしたいエンドポイントのパスを追加することが期待されます。

現在、単一のエンドポイントのみが提供されており、パス /api/v1 でアクセスできます。

v1 API で提供されるエンドポイントは /all で、このエンドポイントはカタログコンテンツ全体を FBC 形式で返します。

ユーザーとクライアントのニーズが進化するにつれて、新しいエンドポイントが追加される可能性があります。

200 - OK

Status スキーマ

401 - Unauthorized

空白

200 - OK

ClusterCatalogList スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

body

ClusterCatalog スキーマ

200 - OK

ClusterCatalog スキーマ

201 - Created

ClusterCatalog スキーマ

202 - Accepted

ClusterCatalog スキーマ

401 - Unauthorized

空白

name

string

ClusterCatalog の名前です。

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

200 - OK

Status スキーマ

202 - Accepted

Status スキーマ

401 - Unauthorized

空白

200 - OK

ClusterCatalog スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

200 - OK

ClusterCatalog スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

body

ClusterCatalog スキーマ

200 - OK

ClusterCatalog スキーマ

201 - Created

ClusterCatalog スキーマ

401 - Unauthorized

空白

name

string

ClusterCatalog の名前です。

200 - OK

ClusterCatalog スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

200 - OK

ClusterCatalog スキーマ

401 - Unauthorized

空白

dryRun

string

これは、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合は、リクエストが BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

body

ClusterCatalog スキーマ

200 - OK

ClusterCatalog スキーマ

201 - Created

ClusterCatalog スキーマ

401 - Unauthorized

空白

install

object

install は、プリフライトチェック設定などの ClusterExtension のインストールオプションを設定するために使用されるオプションフィールドです。

namespace

string

namespace は Kubernetes namespace への参照です。これは、提供された ServiceAccount が存在する必要がある namespace です。また、拡張機能の namespace スコープのリソースがクラスターに適用されるデフォルトの namespace も指定します。一部の拡張機能には、他の namespace に適用される namespace スコープのリソースが含まれている場合があります。この namespace は存在している必要があります。

namespace は必須かつ変更不可能で、[RFC 1123] で定義されている DNS ラベル標準に従います。小文字の英数字またはハイフン (-) のみを含み、先頭と末尾は英数字で、63 文字以内である必要があります。

[RFC 1123]: https://tools.ietf.org/html/rfc1123

serviceAccount

object

serviceAccount は、拡張機能の管理に必要なクラスターとのすべてのやり取りを実行するために使用される ServiceAccount への参照です。これらのやり取りを実行するには、ServiceAccount に必要なパーミッションを設定する必要があります。ServiceAccount は、spec で参照される namespace に存在する必要があります。serviceAccount は必須です。

source

object

source は必須フィールドで、この ClusterExtension のコンテンツのインストールソースを選択します。選択は、sourceType を設定することによって実行されます。

現在実装されている sourceType は Catalog のみであり、sourcetype を "Catalog" に設定するには、catalog フィールドも定義する必要があります。

以下は、source 定義の最小限の例 (yaml 形式) です。

source: sourceType: Catalog catalog: packageName: example-package

preflight

object

preflight は、packageName フィールドで指定されたパッケージのコンテンツをインストールまたはアップグレードする前に実行されるチェックを設定するために使用できるオプションフィールドです。

指定すると、インストール/アップグレードアクションのデフォルトの preflight 設定が置き換えられます。指定しない場合は、デフォルトの設定が使用されます。

crdUpgradeSafety

object

crdUpgradeSafety は、インストールされたコンテンツのアップグレード前に実行される CRD Upgrade Safety のプリフライトチェックを設定するために使用されます。

CRD Upgrade Safety のプリフライトチェックは、データ損失など、CRD をアップグレードする際に意図しない結果が生じることから保護するためのものです。

enforcement

string

enforcement は必須フィールドであり、CRD Upgrade Safety のプリフライトチェックの状態を設定するために使用されます。

許可される値は "None" または "Strict" です。デフォルト値は "Strict" です。

"None" に設定すると、アップグレード操作の実行時に CRD Upgrade Safety のプリフライトチェックがスキップされます。データ損失などの予期しない結果が発生する可能性があるため、注意して使用する必要があります。

"Strict" に設定すると、アップグレード操作の実行時に CRD Upgrade Safety のプリフライトチェックが実行されます。

name

string

name は、packageName フィールドで指定されたパッケージのコンテンツのインストールと管理に使用される ServiceAccount の名前への必須かつ変更不可能な参照です。

この ServiceAccount は installNamespace に存在する必要があります。

name は [RFC 1123] で定義されている DNS サブドメイン標準に従います。小文字の英数字、ハイフン (-)、またはピリオド (.) のみを含み、先頭と末尾は英数字で、長さは 253 文字以下にする必要があります。

有効な値の例: - some-serviceaccount - 123-serviceaccount - 1-serviceaccount-2 - someserviceaccount - some.serviceaccount

無効な値の例: - -some-serviceaccount - some-serviceaccount-

[RFC 1123]: https://tools.ietf.org/html/rfc1123

catalog

object

catalog は、カタログから情報を取得する方法を設定するために使用されます。このフィールドは、sourceType が "Catalog" の場合に必須であり、それ以外の場合は禁止されます。

sourceType

string

sourceType は、インストールソースのタイプへの必須の参照です。

許可される値は "Catalog" です。

このフィールドを "Catalog" に設定すると、インストールする適切なコンテンツバンドルを決定するための情報が、クラスター上に存在する ClusterCatalog リソースから取得されます。Catalog sourceType を使用する場合は、カタログフィールドも設定する必要があります。

channels

array (string)

channels は、packageName フィールドで指定されたパッケージに属するチャネルセットへのオプションの参照です。

"channel" とは、パッケージ作成者が定義した拡張機能の更新ストリームです。

リスト内の各チャネルは、[RFC 1123] で定義されている DNS サブドメイン標準に従う必要があります。小文字の英数字、ハイフン (-)、またはピリオド (.) のみを含み、先頭と末尾は英数字で、長さは 253 文字以下にする必要があります。指定可能なチャネルは 256 以下です。

指定すると、インストール可能なバンドルのセットと自動アップグレードパスを制約するために使用されます。この制約は、version フィールドとの AND 演算になります。例: - 指定されたチャネルが "foo" に設定され、指定されたバージョンが ">=1.0.0, <1.5.0" に設定されている場合、"foo" チャネルに存在し、かつバージョン範囲の比較を満たすバンドルのみが、インストール可能と見なされます。自動アップグレードは、選択されたチャネルによって定義されたアップグレードエッジに制約されます。

指定しない場合は、すべてのチャネルにわたるアップグレードエッジを使用して、有効な自動アップグレードパスが識別されます。

有効な値の例: - 1.1.x - alpha - stable - stable-v1 - v1-stable - dev-preview - preview - community

無効な値の例: - -some-channel - some-channel- - thisisareallylongchannelnamethatisgreaterthanthemaximumlength - original_40 - --default-channel

[RFC 1123]: https://tools.ietf.org/html/rfc1123

packageName

string

packageName は、インストールするパッケージの名前への参照であり、カタログからコンテンツをフィルタリングするために使用されます。

packageName は必須かつ変更不可能で、[RFC 1123] で定義されている DNS サブドメイン標準に従います。小文字の英数字、ハイフン (-)、またはピリオド (.) のみを含み、先頭と末尾は英数字で、長さは 253 文字以下にする必要があります。

有効な値の例: - some-package - 123-package - 1-package-2 - somepackage

無効な値の例: - -some-package - some-package- - thisisareallylongpackagenamethatisgreaterthanthemaximumlength - some.package

[RFC 1123]: https://tools.ietf.org/html/rfc1123

selector

object

selector はオプションのフィールドで、バンドル選択プロセスで使用される ClusterCatalog のセットをフィルタリングするために使用できます。

指定しない場合は、バンドル選択プロセスですべての ClusterCatalog が使用されます。

upgradeConstraintPolicy

string

upgradeConstraintPolicy はオプションのフィールドで、カタログで定義されたアップグレードパスが、packageName フィールドで参照されるパッケージに適用されるかどうかを制御します。

許可される値は、"CatalogProvided"、"SelfCertified、または省略できます。

このフィールドが "CatalogProvided" に設定されている場合、パッケージ作成者によって指定されたアップグレード制約が満たされた場合にのみ自動アップグレードが実行されます。

このフィールドが "SelfCertified" に設定されている場合、パッケージ作成者が指定したアップグレード制約は無視されます。これにより、パッケージの任意のバージョンへのアップグレードとダウングレードが可能になります。これは、データ損失など、未知の潜在的に悲惨な結果につながる可能性があるため、危険な操作と見なされています。このオプションを使用する場合、ユーザーが変更を独自に検証していることが前提となります。

このフィールドを省略した場合、デフォルト値は "CatalogProvided" です。

version

string

version はオプションの semver 制約 (特定のバージョンまたはバージョンの範囲) です。指定しない場合は、利用可能な最新バージョンがインストールされます。

許容されるバージョン範囲は 64 文字以内です。バージョン範囲は、コンマまたはスペースで区切られた値と、比較文字列と呼ばれる 1 つ以上の比較 Operator で構成されます。OR Operator (||) を使用して、追加の比較文字列を追加できます。

# 範囲の比較

バージョン範囲を指定するには、">=3.0, <3.6" のような比較文字列を使用できます。範囲を指定すると、その範囲内で自動更新が行われます。この例の比較文字列は、「3.0.0 以上 3.6.0 未満の任意のバージョンをインストールする」という意味です。また、最初のインストール後にバージョン範囲内でアップグレードが利用可能になった場合は、それらのアップグレードが自動的に実行されるという意図も示されています。

# 固定バージョン

インストールする正確なバージョンを指定するには、特定のバージョンに「固定」するバージョン範囲を使用できます。特定のバージョンに固定すると、自動更新は行われません。固定されたバージョン範囲の例は "0.6.0" です。これは、「バージョン 0.6.0 のみをインストールし、このバージョンからはアップグレードしないこと」を意味します。

# 基本的な比較 Operator

基本的な比較 Operator とその意味: "=" は同等 (特定の Operator にエイリアスされていない)、"!=" は同等ではない。"<" はより小さい。">" はより大きい。">=" は以上。"⇐" は以下。

# ワイルドカードの比較

すべての比較演算では、"x"、"X"、および "" 文字をワイルドカード文字として使用できます。ワイルドカード文字の使用例: "1.2.x"、"1.2.X"、および "1.2." は、">=1.2.0, < 1.3.0" と同等です。">= 1.2.x"、">= 1.2.X"、および ">= 1.2." は、">= 1.2.0" と同等です。"⇐ 2.x"、"⇐ 2.X"、および "⇐ 2." は、"< 3" と同等です。"x"、"X"、および "*" は、">= 0.0.0" と同等です。

# パッチリリースの比較

マイナーバージョンから次のメジャーバージョンまでを指定する場合は、"~" 文字を使用してパッチの比較を実行できます。例: "~1.2.3" は ">=1.2.3, <1.3.0" と同等です。"~1" および "~1.x" は ">=1, <2" と同等です。"~2.3" は ">=2.3、<2.4" と同等です。"~1.2.x" は ">=1.2.0, <1.3.0" と同等です。

# メジャーリリースの比較

stable 1.0.0 バージョンが公開された後、メジャーリリースの比較を行うには、"^" 文字を使用できます。stable バージョンが公開されていない場合は、// マイナーバージョンが安定性レベルを定義します。例: "^1.2.3" は ">=1.2.3, <2.0.0" と同等です。"^1.2.x" は ">=1.2.0, <2.0.0" と同等です。"^2.3" は ">=2.3, <3" と同等です。"^2.x" は ">=2.0.0, <3" と同等です。"^0.2.3" は ">=0.2.3, <0.3.0" と同等です。"^0.2"は ">=0.2.0, <0.3.0" と同等です。"^0.0.3" は ">=0.0.3, <0.0.4" と同等です。"^0.0" は ">=0.0.0, <0.1.0" と同等です。"^0" は ">=0.0.0, <1.0.0" と同等です。

# OR 比較。バージョン範囲内で OR 演算を表すには、"||" 文字を使用できます。一部の例: - ">=1.2.3, <2.0.0 || >3.0.0" - "^0 || ^3 || ^5"

semver の詳細は、https://semver.org/ を参照してください。

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

conditions

array

すべての spec.source バリエーションに適用される状態タイプのセットは、Installed と Progressing です。

Installed 状態は、この ClusterExtension に対してバンドルがインストールされているかどうかを表します。Installed が True で、Reason が Succeeded の場合、バンドルは正常にインストールされています。Installed が False で Reason が Failed の場合、バンドルはインストールに失敗しました。

Progressing 条件は、ClusterExtension が新しい状態に向かって進んでいるかどうかを表します。Progressing が True で Reason が Succeeded の場合、ClusterExtension は新しい状態に向けて進行中です。Progressing が True で、Reason が Retrying の場合、ClusterExtension でエラーが発生しましたが、これは後続の調整試行で解決できる可能性があります。Progressing が False で Reason が Blocked の場合、ClusterExtension でエラーが発生し、回復には手動による介入が必要です。

ClusterExtension がカタログから取得される場合、非推奨条件も伝えられることがあります。これらは、パッケージ所有者がユーザーを特定のパッケージ、チャネル、またはバンドルから遠ざけるように指示するものです。リクエストされたバンドルバージョンがカタログ内で非推奨とマークされている場合、BundleDeprecated が設定されます。リクエストされたチャネルがカタログ内で非推奨とマークされている場合、ChannelDeprecated が設定されます。リクエストされたパッケージがカタログ内で非推奨とマークされている場合、PackageDeprecated が設定されます。Deprecated は、非推奨の条件のいずれかが存在する場合に存在するロールアップ条件です。

conditions[]

object

condition には、この API Resource の現在の状態のある側面の詳細が含まれます。

install

object

install は、この ClusterExtension の現在のインストールステータスを表します。

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。

message

string

message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。

observedGeneration

integer

observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。

reason

string

reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。

status

string

条件のステータス、True、False、Unknown のいずれか。

type

string

CamelCase または foo.example.com/CamelCase の条件のタイプ。

bundle

object

bundle は必須フィールドで、バンドルの識別属性を表します。

"bundle" とは、パッケージをインストールするためにクラスターに適用する必要があるリソースを表す、バージョン管理されたコンテンツのセットです。