第7章 ConsoleQuickStart [console.openshift.io/v1]
- 説明
ConsoleQuickStart は、OpenShift Web コンソールのさまざまなワークフローを通じてユーザーをガイドするための拡張機能です。
互換性レベル 2: メジャーリリース内で最低 9 カ月間、または 3 つのマイナーリリース (どちらか長い方) で安定しています。
- 型
-
object
- 必須
-
spec
-
7.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 を参照してください。 | |
|
| ConsoleQuickStartSpec は、必要なクイックスタート設定です。 |
7.1.1. .spec
- 説明
- ConsoleQuickStartSpec は、必要なクイックスタート設定です。
- 型
-
object
- 必須
-
description
-
displayName
-
durationMinutes
-
概要
-
tasks
-
プロパティー | 型 | 説明 |
---|---|---|
|
| accessReviewResources には、ユーザーがクイックスタートを完了するためにユーザーのアクセスが確認されるリソースのリストが含まれています。アクセスレビューのいずれかが失敗した場合、クイックスタートは非表示になります。 |
|
| ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています |
|
| 結論はクイックスタートを要約し、可能な次のステップを提案します。(値下げを含む) |
|
| description は、クイックスタートの説明です。(値下げを含む) |
|
| displayName は、クイックスタートの表示名です。 |
|
| durationMinutes は、クイックスタートを完了するのにかかるおおよその分数を示します。 |
|
| icon は base64 でエンコードされたイメージで、クイックスタートの表示名の横に表示されます。icon は、簡単に拡大縮小できるようにベクターイメージである必要があります。icon のサイズは 40x40 である必要があります。 |
|
| はじめに、クイックスタートの目を説明します。(値下げを含む) |
|
| nextQuickStart は、次のクイックスタートのリストであり、ユーザーが試すことを推奨します。 |
|
| 前提条件には、クイックスタートを実行する前に満たす必要のあるすべての前提条件が含まれています。(値下げを含む) |
|
| タグは、クイックスタートを説明する文字列のリストです。 |
|
| タスクは、クイックスタートを完了するためにユーザーが実行する必要のあるステップのリストです。 |
|
| ConsoleQuickStartTask は、クイックスタートのシングルステップです。 |
7.1.2. .spec.accessReviewResources
- 説明
- accessReviewResources には、ユーザーがクイックスタートを完了するためにユーザーのアクセスが確認されるリソースのリストが含まれています。アクセスレビューのいずれかが失敗した場合、クイックスタートは非表示になります。
- 型
-
array
7.1.3. .spec.accessReviewResources[]
- 説明
- ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| fieldSelector は、フィールドに基づくアクセスの制限を記述します。アクセスを制限することはできますが、拡大することはできません。
このフィールドはアルファレベルです。このフィールドを使用するには、 |
|
| グループは、リソースの API グループです。"*" はすべてを意味します。 |
|
| labelSelector は、ラベルに基づくアクセスの制限を記述します。アクセスを制限することはできますが、拡大することはできません。
このフィールドはアルファレベルです。このフィールドを使用するには、 |
|
| 名前は、"取得" のために要求されているリソース、または "削除" のために削除されているリソースの名前です。"" (空) はすべてを意味します。 |
|
| namespace は、要求されているアクションの namespace です。現在、名前空間なしとすべての名前空間の区別はありません ""(空) は LocalSubjectAccessReviews のデフォルトです ""(空) はクラスタースコープのリソースでは空です ""(空) は SubjectAccessReview からの名前空間スコープのリソースの " すべて " を意味します SelfSubjectAccessReview |
|
| リソースは、既存のリソースタイプの 1 つです。"*" はすべてを意味します。 |
|
| サブリソースは、既存のリソースタイプの 1 つです。"" は何もないことを意味します。 |
|
| 動詞は、get、list、watch、create、update、delete、proxy などの kubernetes リソース API 動詞です。"*" はすべてを意味します。 |
|
| バージョンは、リソースの API バージョンです。"*" はすべてを意味します。 |
7.1.4. .spec.accessReviewResources[].fieldSelector
- 説明
fieldSelector は、フィールドに基づくアクセスの制限を記述します。アクセスを制限することはできますが、拡大することはできません。
このフィールドはアルファレベルです。このフィールドを使用するには、
AuthorizeWithSelectors
フィーチャーゲートを有効にする必要があります (デフォルトでは無効)。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| rawSelector は、クエリーパラメーターに含まれるフィールドセレクターのシリアル化です。Webhook 実装では、rawSelector を無視することが推奨されます。kube-apiserver の *SubjectAccessReview は、requirements が存在しない限り、rawSelector を解析します。 |
|
| requirements は、フィールドセレクターの解析された解釈です。リソースインスタンスがセレクターと一致するためには、requirements に含まれるすべての条件が適用される必要があります。Webhook 実装は要件を処理する必要がありますが、それをどのように処理するかは Webhook 次第です。Requirements はリクエストを制限する役割しか持たないため、内容が理解できない場合は、無制限のリクエストとして承認しても問題ありません。 |
|
| FieldSelectorRequirement は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
7.1.5. .spec.accessReviewResources[].fieldSelector.requirements
- 説明
- requirements は、フィールドセレクターの解析された解釈です。リソースインスタンスがセレクターと一致するためには、requirements に含まれるすべての条件が適用される必要があります。Webhook 実装は要件を処理する必要がありますが、それをどのように処理するかは Webhook 次第です。Requirements はリクエストを制限する役割しか持たないため、内容が理解できない場合は、無制限のリクエストとして承認しても問題ありません。
- 型
-
array
7.1.6. .spec.accessReviewResources[].fieldSelector.requirements[]
- 説明
- FieldSelectorRequirement は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、要件が適用されるフィールドセレクターキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な Operator は、In、NotIn、Exists、DoesNotExist です。Operator のリストは、今後増える可能性があります。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。 |
7.1.7. .spec.accessReviewResources[].labelSelector
- 説明
labelSelector は、ラベルに基づくアクセスの制限を記述します。アクセスを制限することはできますが、拡大することはできません。
このフィールドはアルファレベルです。このフィールドを使用するには、
AuthorizeWithSelectors
フィーチャーゲートを有効にする必要があります (デフォルトでは無効)。- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| rawSelector は、クエリーパラメーターに含まれるフィールドセレクターのシリアル化です。Webhook 実装では、rawSelector を無視することが推奨されます。kube-apiserver の *SubjectAccessReview は、requirements が存在しない限り、rawSelector を解析します。 |
|
| requirements は、ラベルセレクターを解析した結果の解釈です。リソースインスタンスがセレクターと一致するためには、requirements に含まれるすべての条件が適用される必要があります。Webhook 実装は要件を処理する必要がありますが、それをどのように処理するかは Webhook 次第です。Requirements はリクエストを制限する役割しか持たないため、内容が理解できない場合は、無制限のリクエストとして承認しても問題ありません。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
7.1.8. .spec.accessReviewResources[].labelSelector.requirements
- 説明
- requirements は、ラベルセレクターを解析した結果の解釈です。リソースインスタンスがセレクターと一致するためには、requirements に含まれるすべての条件が適用される必要があります。Webhook 実装は要件を処理する必要がありますが、それをどのように処理するかは Webhook 次第です。Requirements はリクエストを制限する役割しか持たないため、内容が理解できない場合は、無制限のリクエストとして承認しても問題ありません。
- 型
-
array
7.1.9. .spec.accessReviewResources[].labelSelector.requirements[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |
7.1.10. .spec.tasks
- 説明
- タスクは、クイックスタートを完了するためにユーザーが実行する必要のあるステップのリストです。
- 型
-
array
7.1.11. .spec.tasks[]
- 説明
- ConsoleQuickStartTask は、クイックスタートのシングルステップです。
- 型
-
object
- 必須
-
description
-
title
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 説明では、タスクを完了するために必要な手順を説明します。(値下げを含む) |
|
| レビューには、タスクが完了したことを検証するための手順が含まれています。ユーザーは 'Yes' または 'No' を選択します。ステップが正常に完了したを示すラジオボタンを使用します。 |
|
| 要約には、渡されたステップに関する情報が含まれています。 |
|
| タイトルはタスクを説明し、ステップ見出しとして表示されます。 |
7.1.12. .spec.tasks[].review
- 説明
- レビューには、タスクが完了したことを検証するための手順が含まれています。ユーザーは 'Yes' または 'No' を選択します。ステップが正常に完了したを示すラジオボタンを使用します。
- 型
-
object
- 必須
-
failedTaskHelp
-
手順
-
プロパティー | 型 | 説明 |
---|---|---|
|
| failedTaskHelp には、失敗したタスクレビューの提案が含まれており、タスクの最後に表示されます。(値下げを含む) |
|
| 手順には、タスクを実行した後にユーザーが自分の作業を検証するために実行する必要のある手順が含まれています。(値下げを含む) |
7.1.13. .spec.tasks[].summary
- 説明
- 要約には、渡されたステップに関する情報が含まれています。
- 型
-
object
- 必須
-
failed
-
success
-
プロパティー | 型 | 説明 |
---|---|---|
|
| failed は、失敗したタスクを簡単に説明します。(値下げを含む) |
|
| 成功は、正常に渡されたタスクを表します。 |