第5章 Console [operator.openshift.io/v1]


Description
コンソールは、コンソールを管理するように Operator を設定する手段を提供します。互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。
object
必須
  • spec

5.1. 仕様

プロパティー説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。更新はできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

ConsoleSpec は、コンソールの望ましい動作の仕様です。

status

object

ConsoleStatus は、コンソールの監視ステータスを定義します。

5.1.1. .spec

Description
ConsoleSpec は、コンソールの望ましい動作の仕様です。
タイプ
object
プロパティーDescription

カスタマイズ

object

カスタマイズは、オプションで Web コンソールにカスタマイズオプションの小さなセットを提供するために使用されます。

logLevel

string

logLevel は、コンポーネント全体のインテントベースのログです。きめ細かい制御はできませんが、Operator がオペランドに対して解釈する必要のある粗いロギングの選択を管理する簡単な方法です。有効な値は、Normal、Debug、Trace、TraceAll です。Defaults to "Normal".

managementState

string

managementState は、Operator がコンポーネントを管理する必要があるかどうか、およびその方法を示します

observedConfig

``

observedConfig は、コントローラーがクラスター状態から監視したスパース設定を保持します。Operator のレベルへの入力であるため、仕様に存在します

operatorLogLevel

string

operatorLogLevel は、オペレーター自体のインテントベースのログです。きめ細かい制御はできませんが、Operator が自分で解釈しなければならない粗いロギングの選択を管理する簡単な方法です。有効な値は、Normal、Debug、Trace、TraceAll です。Defaults to "Normal".

plugins

array (string)

plugins は、有効なコンソールプラグイン名のリストを定義します。

providers

object

プロバイダーには、特定のサービスプロバイダーを使用するための設定が含まれています。

route

object

ルートには、サービング証明書を含むホスト名とシークレット参照が含まれています。カスタムルートが指定されている場合、指定されたホスト名で新しいルートが作成され、その下でコンソールを使用できます。カスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット指定は必要ありません。カスタムホスト名が任意のドメインを指している場合は、手動の DNS 設定手順が必要です。カスタムルートが削除された場合、コンソールのデフォルトのホスト名を予約するために、デフォルトのコンソールルートが維持されます。指定しない場合、デフォルトルートが使用されます。非推奨

unsupportedConfigOverrides

``

unsupportedConfigOverrides は、以前に設定されたオプションをオーバーライドするスパース設定を保持します。オーバーライドするフィールドである必要があるだけで、次の順序でオーバーレイされます。1.ハードコードされたデフォルト 2.observedConfig 3. unsupportedConfigOverrides

5.1.2. .spec.customization

Description
カスタマイズは、オプションで Web コンソールにカスタマイズオプションの小さなセットを提供するために使用されます。
タイプ
object
プロパティーDescription

addPage

object

addPage を使用すると、開発者の観点から追加ページのアクションをカスタマイズできます。

brand

string

ブランドは Web コンソールのデフォルトのブランドであり、ブランドフィールドを指定することで上書きできます。特定のブランドオプションの限られたセットがあります。このフィールドは、ロゴなどのコンソールの要素を制御します。値が無効な場合、コンソールのロールアウトが妨げられます。

customLogoFile

object

customLogoFile は、マストヘッドおよびアバウトダイアログのデフォルトの OpenShift ロゴを置き換えます。これは、openshift-config 名前空間の ConfigMap への参照です。これは、oc create configmap custom-logo --from-file =/path/to/file-nopenshift-config のようなコマンドで作成できます。ConfigMap サイズの制約により、イメージサイズは 1MB 未満である必要があります。コンソールが正しい MIME タイプでファイルを提供できるように、ConfigMap キーにはファイル拡張子を含める必要があります。推奨されるロゴの仕様: 寸法: 最大高さ 68px、最大幅 200pxSVG 形式を推奨

customProductName

string

customProductName は、通常の OpenShift 製品名の代わりに、ページタイトル、ロゴの代替テキスト、およびバージョン情報ダイアログに表示される名前です。

developerCatalog

object

developerCatalog を使用すると、表示される開発者カタログカテゴリー(フィルター)およびタイプ(サブカタログ)を設定できます。

documentationBaseURL

string

外部ドキュメントへの documentationBaseURL リンクは、Web コンソールのさまざまなセクションに表示されます。DocumentationBaseURL を指定すると、デフォルトのドキュメント URL が上書きされます。値が無効な場合、コンソールのロールアウトが妨げられます。

パースペクティブ

array

パースペクティブを使用すると、ユーザーがパースペクティブのドロップダウンで表示できるパースペクティブの有効化/無効化が可能になります。

perspectives[]

object

 

projectAccess

object

projectAccess を使用すると、開発者パースペクティブのプロジェクトアクセスページで利用可能な ClusterRoles のリストをカスタマイズできます。このページは、プロジェクト管理者が他のユーザーにロールを指定したり、プロジェクト内のアクセスを制限したりするために使用できます。設定されている場合、リストはデフォルトの ClusterRole オプションに置き換わります。

quickStarts

object

quickStarts を使用すると、コンソールで使用可能な ConsoleQuickStart リソースをカスタマイズできます。

5.1.3. .spec.customization.addPage

Description
addPage を使用すると、開発者の観点から追加ページのアクションをカスタマイズできます。
タイプ
object
プロパティーDescription

disabledActions

array (string)

disableActions は、ユーザーに表示されないアクションのリストです。リスト内の各アクションは、その ID で表されます。

5.1.4. .spec.customization.customLogoFile

Description
customLogoFile は、マストヘッドおよびアバウトダイアログのデフォルトの OpenShift ロゴを置き換えます。これは、openshift-config 名前空間の ConfigMap への参照です。これは、oc create configmap custom-logo --from-file =/path/to/file-nopenshift-config のようなコマンドで作成できます。ConfigMap サイズの制約により、イメージサイズは 1MB 未満である必要があります。コンソールが正しい MIME タイプでファイルを提供できるように、ConfigMap キーにはファイル拡張子を含める必要があります。推奨されるロゴの仕様: 寸法: 最大高さ 68px、最大幅 200pxSVG 形式を推奨
タイプ
object
プロパティー説明

key

string

キーを使用すると、設定マップ内の特定のキー/値を指すことができます。これは、論理ファイルの参照に役立ちます。

name

string

 

5.1.5. .spec.customization.developerCatalog

説明
developerCatalog を使用すると、表示される開発者カタログカテゴリー(フィルター)およびタイプ(サブカタログ)を設定できます。
object
プロパティー説明

categories

array

開発者カタログに表示されているカテゴリー。

categories[]

object

開発者コンソールカタログの DeveloperConsoleCatalogCategory。

types

object

タイプを使用すると、ユーザーが開発者カタログで表示できるサブカタログタイプを有効または無効にすることができます。省略すると、すべてのサブカタログタイプが表示されます。

5.1.6. .spec.customization.developerCatalog.categories

Description
開発者カタログに表示されているカテゴリー。
タイプ
array

5.1.7. .spec.customization.developerCatalog.categories[]

Description
開発者コンソールカタログの DeveloperConsoleCatalogCategory。
タイプ
object
必須
  • id
  • ラベル
プロパティーDescription

id

string

ID は、コンソールでディープリンクを有効にするために URL で使用される識別子です。ID は必須であり、1〜32 の URL セーフ (AZ、az、0〜9、-、および _) 文字が必要です。

ラベル

string

label は、カテゴリー表示ラベルを定義します。必須であり、1〜64 文字である必要があります。

subcategories

array

サブカテゴリーは、子カテゴリーのリストを定義します。

subcategories[]

object

DeveloperConsoleCatalogCategoryMeta は、開発者カタログカテゴリーの主要な識別子です。

tags

array (string)

タグは、カテゴリーに一致する文字列のリストです。選択したカテゴリーには、カテゴリーとアイテムの間に少なくとも 1 つの重複するタグがあるすべてのアイテムが表示されます。

5.1.8. .spec.customization.developerCatalog.categories[].subcategories

Description
サブカテゴリーは、子カテゴリーのリストを定義します。
タイプ
array

5.1.9. .spec.customization.developerCatalog.categories[].subcategories[]

Description
DeveloperConsoleCatalogCategoryMeta は、開発者カタログカテゴリーの主要な識別子です。
タイプ
object
必須
  • id
  • ラベル
プロパティーDescription

id

string

ID は、コンソールでディープリンクを有効にするために URL で使用される識別子です。ID は必須であり、1〜32 の URL セーフ (AZ、az、0〜9、-、および _) 文字が必要です。

ラベル

string

label は、カテゴリー表示ラベルを定義します。必須であり、1〜64 文字である必要があります。

tags

array (string)

タグは、カテゴリーに一致する文字列のリストです。選択したカテゴリーには、カテゴリーとアイテムの間に少なくとも 1 つの重複するタグがあるすべてのアイテムが表示されます。

5.1.10. .spec.customization.developerCatalog.types

説明
タイプを使用すると、ユーザーが開発者カタログで表示できるサブカタログタイプを有効または無効にすることができます。省略すると、すべてのサブカタログタイプが表示されます。
object
必須
  • state
プロパティーDescription

disabled

array (string)

無効は、ユーザーに表示されない開発者カタログタイプ(サブカタログ ID)の一覧です。タイプ(サブカタログ)はコンソールプラグインを介して追加されます。利用可能なタイプ(サブカタログ ID)はクラスター設定ページのコンソールで利用でき、コンソールで YAML を編集する場合に利用できます。たとえば、"Devfile"、"HelmChart"、"BuilderImage" リストが空であるか、使用可能なすべてのサブカタログタイプが追加されている場合は、完全な開発者カタログを隠す必要があります。

enabled

array (string)

Enabled は、ユーザーに表示される開発者カタログタイプ(サブカタログ ID)の一覧です。タイプ(サブカタログ)はコンソールプラグインを介して追加されます。利用可能なタイプ(サブカタログ ID)はクラスター設定ページのコンソールで利用でき、コンソールで YAML を編集する場合に利用できます。例:"Devfile"、"HelmChart"、"BuilderImage" リストが空でない場合、リストに追加されるまで新しいタイプはユーザーに表示されません。リストが空の場合は、完全な開発者カタログが表示されます。

state

string

state は、カタログタイプの一覧を有効にするか無効にするかを定義します。

5.1.11. .spec.customization.perspectives

説明
パースペクティブを使用すると、ユーザーがパースペクティブのドロップダウンで表示できるパースペクティブの有効化/無効化が可能になります。
array

5.1.12. .spec.customization.perspectives[]

説明
object
必須
  • id
  • 制約
プロパティーDescription

id

string

id はパースペクティブの ID を定義します。例:"dev"、"admin"。利用可能なパースペクティブ ID は、yaml エディターの横にあるコードスニペットセクションにあります。正しくないか、不明な ID は無視されます。

制約

object

可視性は、パースペクティブの状態と、そのパースペクティブに必要なアクセスレビューチェックを定義します。

5.1.13. .spec.customization.perspectives[].visibility

説明
可視性は、パースペクティブの状態と、そのパースペクティブに必要なアクセスレビューチェックを定義します。
object
必須
  • state
プロパティー説明

accessReview

object

accessReview は、必須および欠落しているアクセスレビューチェックを定義します。

state

string

state は、パースペクティブを有効または無効にするか、またはアクセスレビューチェックが必要であるかを定義します。

5.1.14. .spec.customization.perspectives[].visibility.accessReview

説明
accessReview は、必須および欠落しているアクセスレビューチェックを定義します。
object
プロパティー説明

missing

array

missing は、パーミッションチェックのリストを定義します。パースペクティブは、1 つ以上のチェックが失敗した場合にのみ表示されます。省略した場合、アクセスレビューはスキップされ、必要なアクセスレビューリストの設定に基づいて実行する必要がない限り、パースペクティブは表示されません。

missing[]

object

ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています

required

array

必須 は、パーミッションチェックのリストを定義します。パースペクティブは、すべてのチェックが成功した場合にのみ表示されます。省略した場合、アクセスレビューはスキップされ、不足しているアクセスレビューリストの設定に基づいて実行する必要がない限り、パースペクティブは表示されません。

required[]

object

ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています

5.1.15. .spec.customization.perspectives[].visibility.accessReview.missing

説明
missing は、パーミッションチェックのリストを定義します。パースペクティブは、1 つ以上のチェックが失敗した場合にのみ表示されます。省略した場合、アクセスレビューはスキップされ、必要なアクセスレビューリストの設定に基づいて実行する必要がない限り、パースペクティブは表示されません。
array

5.1.16. .spec.customization.perspectives[].visibility.accessReview.missing[]

説明
ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています
タイプ
object
プロパティー説明

group

string

グループは、リソースの API グループです。*はすべてを意味します。

name

string

名前は、取得のために要求されているリソース、または削除のために削除されているリソースの名前です。""(空) はすべてを意味します。

namespace

string

namespace は、要求されているアクションの namespace です。現在、名前空間なしとすべての名前空間の区別はありません ""(空) は LocalSubjectAccessReviews のデフォルトです ""(空) はクラスタースコープのリソースでは空です ""(空) は SubjectAccessReview からの名前空間スコープのリソースの " すべて " を意味します SelfSubjectAccessReview

resource

string

リソースは、既存のリソースタイプの 1 つです。* はすべてを意味します。

subresource

string

サブリソースは、既存のリソースタイプの 1 つです。"" は何もないことを意味します。

verb

string

動詞は、get、list、watch、create、update、delete、proxy などの kubernetes リソース API 動詞です。* はすべてを意味します。

version

string

バージョンは、リソースの API バージョンです。* はすべてを意味します。

5.1.17. .spec.customization.perspectives[].visibility.accessReview.required

説明
必須 は、パーミッションチェックのリストを定義します。パースペクティブは、すべてのチェックが成功した場合にのみ表示されます。省略した場合、アクセスレビューはスキップされ、不足しているアクセスレビューリストの設定に基づいて実行する必要がない限り、パースペクティブは表示されません。
array

5.1.18. .spec.customization.perspectives[].visibility.accessReview.required[]

説明
ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています
タイプ
object
プロパティー説明

group

string

グループは、リソースの API グループです。*はすべてを意味します。

name

string

名前は、取得のために要求されているリソース、または削除のために削除されているリソースの名前です。""(空) はすべてを意味します。

namespace

string

namespace は、要求されているアクションの namespace です。現在、名前空間なしとすべての名前空間の区別はありません ""(空) は LocalSubjectAccessReviews のデフォルトです ""(空) はクラスタースコープのリソースでは空です ""(空) は SubjectAccessReview からの名前空間スコープのリソースの " すべて " を意味します SelfSubjectAccessReview

resource

string

リソースは、既存のリソースタイプの 1 つです。* はすべてを意味します。

subresource

string

サブリソースは、既存のリソースタイプの 1 つです。"" は何もないことを意味します。

verb

string

動詞は、get、list、watch、create、update、delete、proxy などの kubernetes リソース API 動詞です。* はすべてを意味します。

version

string

バージョンは、リソースの API バージョンです。* はすべてを意味します。

5.1.19. .spec.customization.projectAccess

Description
projectAccess を使用すると、開発者パースペクティブのプロジェクトアクセスページで利用可能な ClusterRoles のリストをカスタマイズできます。このページは、プロジェクト管理者が他のユーザーにロールを指定したり、プロジェクト内のアクセスを制限したりするために使用できます。設定されている場合、リストはデフォルトの ClusterRole オプションに置き換わります。
タイプ
object
プロパティーDescription

availableClusterRoles

array (string)

availableClusterRoles は、プロジェクトアクセスタブを介してユーザーに割り当てることができる ClusterRole 名のリストです。

5.1.20. .spec.customization.quickStarts

Description
quickStarts を使用すると、コンソールで使用可能な ConsoleQuickStart リソースをカスタマイズできます。
タイプ
object
プロパティーDescription

disabled

array (string)

無効は、ユーザーに表示されない ConsoleQuickStart リソース名のリストです。

5.1.21. .spec.providers

Description
プロバイダーには、特定のサービスプロバイダーを使用するための設定が含まれています。
タイプ
object
プロパティーDescription

statuspage

object

statuspage には、ステータス情報を提供する statuspage.io ページの ID が含まれています。

5.1.22. .spec.providers.statuspage

Description
statuspage には、ステータス情報を提供する statuspage.io ページの ID が含まれています。
タイプ
object
プロパティーDescription

pageID

string

pageID は、Statuspage によってページに割り当てられた一意の ID です。これは公開ページである必要があります。

5.1.23. .spec.route

Description
ルートには、サービング証明書を含むホスト名とシークレット参照が含まれています。カスタムルートが指定されている場合、指定されたホスト名で新しいルートが作成され、その下でコンソールを使用できます。カスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット指定は必要ありません。カスタムホスト名が任意のドメインを指している場合は、手動の DNS 設定手順が必要です。カスタムルートが削除された場合、コンソールのデフォルトのホスト名を予約するために、デフォルトのコンソールルートが維持されます。指定しない場合、デフォルトルートが使用されます。非推奨
タイプ
object
プロパティー説明

hostname

string

ホスト名は、コンソールを使用できる目的のカスタムドメインです。

secret

object

シークレットは、カスタム証明書とキーを含み、クラスター管理者が手動で作成する必要がある openshift-config 名前空間のシークレットを指します。参照シークレットには、次のキーと値のペアが含まれている必要があります。-"tls.crt"- カスタム証明書を指定します -"tls.key"- カスタム証明書の秘密キーを指定しますカスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット仕様は必要ありません。

5.1.24. .spec.route.secret

Description
シークレットは、カスタム証明書とキーを含み、クラスター管理者が手動で作成する必要がある openshift-config 名前空間のシークレットを指します。参照シークレットには、次のキーと値のペアが含まれている必要があります。-"tls.crt"- カスタム証明書を指定します -"tls.key"- カスタム証明書の秘密キーを指定しますカスタムホスト名がクラスターのデフォルトのルーティング接尾辞を使用する場合、サービング証明書のシークレット仕様は必要ありません。
タイプ
object
必須
  • name
プロパティー説明

name

string

name は、参照されるシークレットの metadata.name です。

5.1.25. .status

Description
ConsoleStatus は、コンソールの監視ステータスを定義します。
タイプ
object
プロパティー説明

conditions

array

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

conditions[]

object

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

generations

array

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

generations[]

object

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

observedGeneration

integer

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

readyReplicas

integer

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

version

string

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

5.1.26. .status.conditions

Description
条件は、条件とそのステータスのリストです
タイプ
array

5.1.27. .status.conditions[]

Description
OperatorCondition は、単なる標準の条件フィールドです。
タイプ
object
プロパティー説明

lastTransitionTime

string

 

message

string

 

reason

string

 

status

string

 

type

string

 

5.1.28. .status.generations

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

5.1.29. .status.generations[]

Description
GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
タイプ
object
プロパティー説明

group

string

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

ハッシュ

string

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

lastGeneration

integer

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

name

string

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

namespace

string

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

resource

string

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

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.