第8章 OperatorGroup [operators.coreos.com/v1]
- 説明
- OperatorGroup は、OLM マネージドオペレーターのマルチテナンシーの単位です。名前空間への Operator のインストールを、指定されたターゲット名前空間のセットに制限します。
- 型
-
object
- 必須
-
metadata
-
8.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 を参照してください。 | |
|
| OperatorGroupSpec は、OperatorGroup リソースの仕様です。 |
|
| OperatorGroupStatus は、OperatorGroupResource のステータスです。 |
8.1.1. .spec
- 説明
- OperatorGroupSpec は、OperatorGroup リソースの仕様です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| Selector は、OperatorGroup のターゲット名前空間を選択します。 |
|
| ServiceAccountName は、この Operator グループにオペレーターをデプロイするために使用される管理者指定のサービスアカウントです。 |
|
| Static は、OperatorGroup の providedAPIs アノテーションを更新しないように OLM に指示します |
|
| TargetNamespaces は、ターゲットとする名前空間の明示的なセットです。設定されている場合、セレクターは無視されます。 |
|
| UpgradeStrategy は、namespace 内の Operator のアップグレードストラテジーを定義します。現在サポートされているアップグレードストラテジーは 2 つあります。 Default: clusterServiceVersions が成功フェーズから置換フェーズに移行することだけが OLM によって許可されます。つまり、インストールまたはアップグレードが失敗した場合、Operator が次のバージョンに移行することが OLM によって許可されません。 TechPreviewUnsafeFailForward: clusterServiceVersions が成功フェーズまたは失敗フェーズから置換フェーズに移行することが OLM によって許可されます。また、サブスクリプションが失敗した installPlan を参照しており、既存の Operator セットの新しいアップグレードでカタログが更新された場合に、OLM が新しい installPlan を生成します。 警告: TechPreviewUnsafeFailForward アップグレードストラテジーは安全ではありません。namespace で管理されている Operator セットについて深く理解していないと、予期しない動作や回復不可能なデータ損失が発生する可能性があります。 |
8.1.2. .spec.selector
- 説明
- Selector は、OperatorGroup のターゲット名前空間を選択します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
8.1.3. .spec.selector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
8.1.4. .spec.selector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
8.1.5. .status
- 説明
- OperatorGroupStatus は、OperatorGroupResource のステータスです。
- 型
-
object
- 必須
-
lastUpdated
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 条件は、OperatorGroup の条件の配列です。 |
|
| 条件には、この API リソースの現在の状態の詳細が含まれます。 |
|
| LastUpdated は、OperatorGroup のステータスが最後に更新されたときのタイムスタンプです。 |
|
| 名前空間は、OperatorGroup のターゲット名前空間のセットです。 |
|
| ServiceAccountRef は、指定されたサービスアカウントオブジェクトを参照します。 |
8.1.6. .status.conditions
- 説明
- 条件は、OperatorGroup の条件の配列です。
- 型
-
array
8.1.7. .status.conditions[]
- 説明
- 条件には、この API リソースの現在の状態の詳細が含まれます。
- 型
-
object
- 必須
-
lastTransitionTime
-
message
-
reason
-
status
-
type
-
プロパティー | 型 | 説明 |
---|---|---|
|
| lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。 |
|
| message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。 |
|
| observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。 |
|
| reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。 |
|
| 条件のステータス、True、False、Unknown のいずれか。 |
|
| CamelCase または foo.example.com/CamelCase の条件のタイプ。 |
8.1.8. .status.serviceAccountRef
- 説明
- ServiceAccountRef は、指定されたサービスアカウントオブジェクトを参照します。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 参照先の API バージョン。 |
|
| オブジェクト全体ではなく一部を参照する場合に、この文字列には、desiredState.manifest.containers[2] など、有効な JSON/Go フィールドアクセスステートメントを含める必要があります。たとえば、オブジェクトの参照先が Pod 内のコンテナーの場合には、"spec.containers{name}" などの値に設定されます ("name" はイベントをトリガーしたコンテナー名に置き換えます)。またはコンテナー名が指定されていない場合には、"spec.containers[2]" の値に設定されます (この Pod 内でインデックスが 2 のコンテナー)。この構文が選択された唯一の理由は、オブジェクトの一部の参照を明確に定義するためです。 |
|
| 参照先の種類。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| この参照が作成される特定の resourceVersion (ある場合)。詳細: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 参照先の UID。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |