7.5. 動的プラグイン参照
プラグインのカスタマイズを可能にするエクステンションを追加できます。これらのエクステンションは、ランタイム時にコンソールにロードされます。
7.5.1. 動的プラグインエクステンションのタイプ
console.action/filter
ActionFilter
を使用してアクションを絞り込むことができます。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
コンテキスト ID は、提供したアクションのスコープをアプリケーションの特定のエリアに限定するのに役立ちますたとえば、 |
|
| いいえ |
一部の条件に基づいてアクションをフィルターする関数。 |
console.action/group
ActionGroup
は、サブメニューに指定可能なアクショングループを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | アクションの選択を識別するための ID。 |
|
| はい | UI に表示されるラベル。サブメニューに必要です。 |
|
| はい | このグループをサブメニューとして表示するかどうか。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
console.action/provider
ActionProvider
は、特定のコンテキストに対するアクションのリストを返すフックを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
コンテキスト ID は、提供したアクションのスコープをアプリケーションの特定のエリアに限定するのに役立ちますたとえば、 |
|
| いいえ |
指定のスコープのアクションを返す React フック。 |
console.action/resource-provider
ResourceActionProvider
は、特定のリソースモデルに対するアクションのリストを返すフックを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このプロバイダーがアクションを提供するモデル。 |
|
| いいえ | 指定のリソースモデルに対するアクションを返す反応フック |
console.alert-action
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | |
|
| いいえ | |
|
| いいえ |
console.catalog/item-filter
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このプロバイダーが提供するカタログの一意の識別子。 |
|
| いいえ | カタログ項目タイプのタイプ ID。 |
|
| いいえ |
特定のタイプの項目をフィルタリングします。Value は、 |
console.catalog/item-metadata
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このプロバイダーが提供するカタログの一意の識別子。 |
|
| いいえ | カタログ項目タイプのタイプ ID。 |
|
| いいえ | 特定のタイプのカタログ項目にメタデータを提供するために使用される関数を返すフック。 |
console.catalog/item-provider
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このプロバイダーが提供するカタログの一意の識別子。 |
|
| いいえ | カタログ項目タイプのタイプ ID。 |
|
| いいえ | カタログ項目プロバイダーのタイトル |
|
| いいえ | 項目を取得し、これをカタログ用に正規化します。値は反応効果フックです。 |
|
| はい |
このプロバイダーの優先順位。デフォルトは |
console.catalog/item-type
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | カタログ項目をタイプ。 |
|
| いいえ | カタログ項目のタイトル。 |
|
| はい | カタログに固有のタイプの説明。 |
|
| はい | カタログ項目タイプの説明。 |
|
| はい | カタログ項目に固有のカスタムフィルター。 |
|
| はい | カタログ項目に固有のカスタムグルーピング。 |
console.catalog/item-type-metadata
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | カタログ項目をタイプ。 |
|
| はい | カタログ項目に固有のカスタムフィルター。 |
|
| はい | カタログ項目に固有のカスタムグルーピング。 |
console.cluster-overview/inventory-item
新しいインベントリー項目をクラスターの概要ページに追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | レンダリングされるコンポーネント。 |
console.cluster-overview/multiline-utilization-item
新しいクラスター概要のマルチライン使用状況項目を追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 使用状況項目のタイトル。 |
|
| いいえ | Prometheus 使用状況クエリー。 |
|
| いいえ | Prometheus データを人間が判読できる形式に変換します。 |
|
| はい | プレーン値の代わりに Top コンシューマーのポップオーバーを表示します。 |
console.cluster-overview/utilization-item
新しいクラスター概要の使用状況項目を追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 使用状況項目のタイトル。 |
|
| いいえ | Prometheus 使用状況クエリー。 |
|
| いいえ | Prometheus データを人間が判読できる形式に変換します。 |
|
| はい | Prometheus 合計のクエリー。 |
|
| はい | Prometheus 要求のクエリー。 |
|
| はい | Prometheus 制限のクエリー。 |
|
| はい | プレーン値の代わりに Top コンシューマーのポップオーバーを表示します。 |
console.context-provider
新しい React コンテキストプロバイダーを Web コンソールのアプリケーションルートに追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | Context プロバイダーコンポーネント。 |
|
| いいえ | コンテキスト値のフック。 |
console.dashboards/card
新しいダッシュボードカードを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | カードを追加するダッシュボードタブの ID。 |
|
| いいえ | ダッシュボードのカードのグリッド位置。 |
|
| いいえ | ダッシュボードカードのコンポーネント。 |
|
| はい |
列内のカードの垂直スパン。小さな画面では無視され、デフォルトは |
console.dashboards/overview/activity/resource
Kubernetes リソースの監視に基づいてアクティビティーをトリガーしている Overview ダッシュボードの Activity カードにアクティビティーを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 置き換える使用状況項目。 |
|
| いいえ | アクションコンポーネント。 |
|
| はい | 指定のリソースがアクションを表すかどうかを判断する関数。定義されていない場合は、すべてのリソースがアクティビティーを表します。 |
|
| はい | 指定のアクションのタイムスタンプで、順序付けに使用されます。 |
console.dashboards/overview/detail/item
Overview ダッシュボードの Details カードに項目を追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
|
console.dashboards/overview/health/operator
ステータスのソースが Kubernetes REST API である Overview ダッシュボードのステータスカードに health サブシステムを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ポップアップメニューの Operators セクションのタイトル。 |
|
| いいえ |
フェッチされ、 |
|
| はい | Operator のステータスを解決します。 |
|
| はい | ポップアップ行コンポーネントのローダー。 |
|
| はい | すべてのリソースページへのリンク。指定しない場合は、resources prop から最初のリソースのリストページが使用されます。 |
console.dashboards/overview/health/prometheus
ステータスのソースが Prometheus である Overview ダッシュボードのステータスカードに health サブシステムを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | サブシステムの表示名。 |
|
| いいえ | Prometheus クエリー |
|
| いいえ | サブシステムの健全性を解決します。 |
|
| はい |
フェッチされ、 |
|
| はい | ポップアップメニューコンテンツのローダー。定義された場合、health 項目はリンクとして表され、指定のコンテンツを含むポップアップメニューが開きます。 |
|
| はい | ポップオーバーのタイトル。 |
|
| はい | サブシステムを非表示にする必要のあるコントロールプレーントポロジー。 |
console.dashboards/overview/health/resource
ステータスのソースが Kubernetes リソースである概要ダッシュボードのステータスカードに health サブシステムを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | サブシステムの表示名。 |
|
| いいえ |
フェッチされ、 |
|
| いいえ | サブシステムの健全性を解決します。 |
|
| はい | ポップアップメニューコンテンツのローダー。定義された場合、health 項目はリンクとして表され、指定のコンテンツを含むポップアップメニューが開きます。 |
|
| はい | ポップオーバーのタイトル。 |
console.dashboards/overview/health/url
ステータスのソースが Kubernetes REST API である概要ダッシュボードのステータスカードに health サブシステムを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | サブシステムの表示名。 |
|
| いいえ | データの取得元の URL。これには、ベース Kubernetes URL が接頭辞として付けられます。 |
| `CodeRef<URLHealthHandler<T, K8sResourceCommon | K8sResourceCommon[]>>` | いいえ |
サブシステムの健全性を解決します。 |
|
| はい |
フェッチされ、 |
|
| はい |
ポップアップコンテンツのローダー。定義された場合、health 項目は指定のコンテンツのポップアップが開くリンクとして表示されます。 |
|
| はい |
console.dashboards/overview/inventory/item
概要インベントリーカードにリソースタイルを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
取得する |
|
| はい | さまざまなステータスをグループにマッピングする関数。 |
|
| はい |
フェッチされ、 |
console.dashboards/overview/inventory/item/group
インベントリーのステータスグループを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ステータスグループの ID。 |
|
| いいえ | ステータスグループアイコンを表す React コンポーネント。 |
console.dashboards/overview/inventory/item/replacement
概要のインベントリーカードを置き換えます。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
取得する |
|
| はい | さまざまなステータスをグループにマッピングする関数。 |
|
| はい |
フェッチされ、 |
console.dashboards/overview/prometheus/activity/resource
Kubernetes リソースの監視に基づいてアクティビティーをトリガーしている Prometheus Overview ダッシュボードの Activity カードにアクティビティーを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 監視するクエリー |
|
| いいえ | アクションコンポーネント。 |
|
| はい | 指定のリソースがアクションを表すかどうかを判断する関数。定義されていない場合は、すべてのリソースがアクティビティーを表します。 |
console.dashboards/project/overview/item
プロジェクトの概要インベントリーカードにリソースタイルを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
取得する |
|
| はい | さまざまなステータスをグループにマッピングする関数。 |
|
| はい |
フェッチされ、 |
console.dashboards/tab
Overview タブの後に置かれた新規ダッシュボードタブを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
このタブにカードを追加する場合にタブリンク |
|
| いいえ | タブが属するナビゲーションセクション。 |
|
| いいえ | タブのタイトル。 |
console.file-upload
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | サポートされるファイル拡張子。 |
|
| いいえ | ファイルドロップアクションを処理する関数。 |
console.flag
Web コンソール機能フラグを完全に制御します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 任意の機能フラグを設定または設定解除するのに使用されます。 |
console.flag/hookProvider
フックハンドラーを使用して Web コンソール機能フラグを完全に制御します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 任意の機能フラグを設定または設定解除するのに使用されます。 |
console.flag/model
クラスターに CRD の存在によって駆動される新規 Web コンソール機能フラグを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | CRD が検出されると設定するフラグの名前。 |
|
| いいえ |
|
console.global-config
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | クラスター設定リソースインスタンスの一意の識別子。 |
|
| いいえ | クラスター設定リソースインスタンスの名前。 |
|
| いいえ | クラスター設定リソースを参照するモデル。 |
|
| いいえ | クラスター設定リソースインスタンスの namespace。 |
console.model-metadata
API 検出で取得および生成される値を上書きして、モデルの表示をカスタマイズします。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | カスタマイズするモデル。グループのみ、またはオプションのバージョンおよび種類を指定できます。 |
|
| はい | このモデル参照をテクノロジープレビューまたは開発者プレビューとみなすかどうか。 |
|
| はい | このモデルに関連付ける色。 |
|
| はい |
ラベルをオーバーライドします。 |
|
| はい |
複数形のラベルをオーバーライドします。 |
|
| はい |
省略形をカスタマイズします。デフォルトは |
console.navigation/href
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この項目の一意の識別子。 |
|
| いいえ | この項目の名前。 |
|
| いいえ | リンクの href の値。 |
|
| はい | この項目が属するパースペクティブ ID。指定されていない場合は、デフォルトのパースペクティブに提供します。 |
|
| はい | この項目が属するナビゲーションセクション。指定されていない場合は、この項目を最上位のリンクとしてレンダリングします。 |
|
| はい | データ属性を DOM に追加します。 |
|
| はい | URL がこのパスのいずれかで始まる場合は、この項目をアクティブと識別します。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
|
|
| はい |
|
console.navigation/resource-cluster
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この項目の一意の識別子。 |
|
| いいえ | このナビゲーション項目がリンクするモデル。 |
|
| はい | この項目が属するパースペクティブ ID。指定されていない場合は、デフォルトのパースペクティブに提供します。 |
|
| はい | この項目が属するナビゲーションセクション。指定しない場合は、この項目をトップレベルのリンクとしてレンダリングします。 |
|
| はい | データ属性を DOM に追加します。 |
|
| はい | URL がこのパスのいずれかで始まる場合は、この項目をアクティブと識別します。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい | デフォルト名をオーバーライドします。指定されていない場合、リンクの名前はモデルの複数形の値と同じになります。 |
console.navigation/resource-ns
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この項目の一意の識別子。 |
|
| いいえ | このナビゲーション項目がリンクするモデル。 |
|
| はい | この項目が属するパースペクティブ ID。指定されていない場合は、デフォルトのパースペクティブに提供します。 |
|
| はい | この項目が属するナビゲーションセクション。指定しない場合は、この項目をトップレベルのリンクとしてレンダリングします。 |
|
| はい | データ属性を DOM に追加します。 |
|
| はい | URL がこのパスのいずれかで始まる場合は、この項目をアクティブと識別します。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい | デフォルト名をオーバーライドします。指定されていない場合、リンクの名前はモデルの複数形の値と同じになります。 |
console.navigation/section
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この項目の一意の識別子。 |
|
| はい | この項目が属するパースペクティブ ID。指定されていない場合は、デフォルトのパースペクティブに提供します。 |
|
| はい | データ属性を DOM に追加します。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい | このセクションの名前。指定しない場合は、セクションの上に区切り記号のみが表示されます。 |
console.navigation/separator
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この項目の一意の識別子。 |
|
| はい | この項目が属するパースペクティブ ID。指定されていない場合は、デフォルトのパースペクティブに提供します。 |
|
| はい | この項目が属するナビゲーションセクション。指定されていない場合は、この項目を最上位のリンクとしてレンダリングします。 |
|
| はい | データ属性を DOM に追加します。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
console.page/resource/details
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このリソースページがリンクするモデル。 |
|
| いいえ | ルートがマッチしたときにレンダリングされるコンポーネント。 |
console.page/resource/list
Console ルーターに新しいリソースリストのページを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このリソースページがリンクするモデル。 |
|
| いいえ | ルートがマッチしたときにレンダリングされるコンポーネント。 |
console.page/route
Web コンソールルーターに新しいページを追加します。React Router を参照してください。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ルートがマッチしたときにレンダリングされるコンポーネント。 |
|
| いいえ |
|
|
| はい | このページが属するパースペクティブ。指定されていない場合は、すべてのパースペクティブに提供します。 |
|
| はい |
true の場合、パスが |
console.page/route/standalone
一般的なページレイアウトの外部でレンダリングされる新しいスタンドアロンページを Web コンソールルーターに追加します。React Router を参照してください。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ルートがマッチしたときにレンダリングされるコンポーネント。 |
|
| いいえ |
|
|
| はい |
true の場合、パスが |
console.perspective
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | パースペクティブの識別子。 |
|
| いいえ | パースペクティブの表示名。 |
|
| いいえ | パースペクティブの表示アイコン。 |
|
| いいえ | パースペクティブのランディングページの URL を取得する関数。 |
|
| いいえ | インポートフローのリダイレクト URL を取得する関数。 |
|
| はい | パースペクティブがデフォルトであるかどうか。デフォルトは 1 つのみです。 |
|
| はい | ナビゲーション上のデフォルトの固定されたリソース |
|
| はい | デフォルトのパースペクティブを検出するフック |
console.project-overview/inventory-item
新しいインベントリー項目を プロジェクトの概要 ページに追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | レンダリングされるコンポーネント。 |
console.project-overview/utilization-item
新しいプロジェクト概要の使用状況項目を追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | 使用状況項目のタイトル。 |
|
| いいえ | Prometheus 使用状況クエリー。 |
|
| いいえ | Prometheus データを人間が判読できる形式に変換します。 |
|
| はい | Prometheus 合計のクエリー。 |
|
| はい | Prometheus 要求のクエリー。 |
|
| はい | Prometheus 制限のクエリー。 |
|
| はい | プレーン値の代わりに最上位のコンシューマーポップオーバーを表示します。 |
console.pvc/alert
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | アラートコンポーネント。 |
console.pvc/create-prop
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | prop アクション作成のラベル。 |
|
| いいえ | prop アクション作成のパス。 |
console.pvc/delete
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | エクステンションを使用するかどうかを示す述語。 |
|
| いいえ | PVC 削除操作の方法。 |
|
| いいえ | 追加情報を表示するアラートコンポーネント。 |
console.pvc/status
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | status コンポーネントの優先度。値が大きいほど優先度が高くなります。 |
|
| いいえ | status コンポーネント。 |
|
| いいえ | ステータスコンポーネントをレンダリングするかどうかを示す述語。 |
console.redux-reducer
plugins.<scope>
サブ状態で動作する Console Redux ストアに新しい reducer を追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | Redux 状態オブジェクト内の reducer が管理するサブ状態を表すキー。 |
|
| いいえ | reducer が管理するサブ状態で動作する reducer 関数 |
console.resource/create
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この create resource ページがレンダリングされるモデル。 |
|
| いいえ | モデルがマッチする場合にレンダリングされるコンポーネント |
console.storage-provider
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | |
|
| いいえ |
console.tab/horizontalNav
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このプロバイダーがタブを表示するモデル。 |
|
| いいえ | 水平タブに表示されるページ。名前としてタブ名およびタブの href を取ります。 |
|
| いいえ | ルートがマッチしたときにレンダリングされるコンポーネント。 |
console.telemetry/listener
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | テレメトリーイベントをリッスンします |
console.topology/adapter/build
BuildAdapter
は、Build
コンポーネントで使用できるデータに要素を適応させるアダプターを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
| CodeRef<(element: GraphElement) ⇒ AdapterDataType<BuildConfigData> | undefined> | いいえ |
console.topology/adapter/network
NetworkAdapater
は、Networking
コンポーネントで使用できるデータに要素を適応させるアダプターを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
| <(element: GraphElement) ⇒ NetworkAdapterType | undefined> | いいえ |
console.topology/adapter/pod
PodAdapter
はアダプターを提供し、Pod
コンポーネントで使用できるデータに要素を適合させます。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
| `CodeRef<(element: GraphElement) ⇒ AdapterDataType<PodsAdapterDataType> | undefined> | いいえ |
console.topology/component/factory
ViewComponentFactory
の Getter。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ |
|
console.topology/create/connector
コネクター作成関数の getter。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | コネクター作成関数の getter。 |
console.topology/data/factory
トポロジーデータモデルファクトリーエクステンション
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ファクトリーの一意の ID。 |
|
| いいえ | ファクトリーの優先度 |
|
| はい | useK8sWatchResources フックから取得されるリソース。 |
|
| はい | ワークロードが含まれるリソースのキー。 |
|
| はい | データモデルファクトリーの Getter。 |
|
| はい | リソースがこのモデルファクトリーによって記述されているかどうかを判断する関数の Getter。 |
|
| はい | すべてのエクステンションのモデルがロードされた後にデータモデルを調整する関数の Getter。 |
console.topology/decorator/provider
トポロジーデコレータープロバイダーエクステンション
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | |
|
| いいえ | |
|
| いいえ | |
|
| いいえ |
console.topology/details/resource-alert
DetailsResourceAlert
は、特定のトポロジーコンテキストまたはグラフ要素のアラートを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このアラートの ID。アラートの破棄後に表示しない場合に状態を保存するために使用されます。 |
| CodeRef<(element: GraphElement) ⇒ DetailsResourceAlertContent | null> | いいえ |
console.topology/details/resource-link
DetailsResourceLink
は、特定のトポロジーコンテキストまたはグラフ要素のリンクを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
| CodeRef<(element: GraphElement) ⇒ React.Component | undefined> | いいえ |
指定された場合はリソースリンクを返し、指定されない場合は未定義を返します。スタイルには |
|
| はい |
console.topology/details/tab
DetailsTab
は、トポロジーの詳細パネルのタブを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この詳細タブの一意の識別子。 |
|
| いいえ | UI に表示されるタブのラベル。 |
|
| はい | ここで参照される項目の前に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
|
| はい |
ここで参照される項目の後に、この項目を挿入します。配列の場合は、最初に見つかったものが順番に使用されます。 |
console.topology/details/tab-section
DetailsTabSection
は、トポロジーの詳細パネルの特定タブのセクションを提供します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | この詳細タブセクションの一意の識別子。 |
|
| いいえ | このセクションが提供する必要のある親タブ ID。 |
|
| いいえ | トポロジー/サイドバーでレンダリングされるコンポーネントまたは null/undefined を返すフック。SKD コンポーネント:<Section title=\{}>… padded area |
| CodeRef<(element: GraphElement, renderNull?: () ⇒ null) ⇒ React.Component | undefined> | いいえ |
プロバイダーが定義されていない場合 @非推奨のフォールバック。renderNull はすでに運用されません。 |
|
| はい |
ここで参照される項目の前にこの項目を挿入します。配列の場合は、最初に見つかった項目が順番に使用されます。 |
|
| はい |
console.topology/display/filters
トポロジー表示フィルターエクステンション
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | |
|
| いいえ |
console.topology/relationship/provider
トポロジー関係プロバイダーコネクターエクステンション
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | |
|
| いいえ | |
|
| いいえ | |
|
| いいえ |
console.user-preference/group
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ユーザー設定グループを識別するのに使用される ID。 |
|
| いいえ | ユーザー設定グループのラベル |
|
| はい | このユーザー設定グループの後に配置しなければならないグループの ID |
|
| はい | このユーザー設定グループの前に配置しなければならないグループの ID |
console.user-preference/item
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | ユーザー設定項目を特定するのに使用され、項目の順序を定義するのに insertAfter および insertBefore で参照される ID。 |
|
| いいえ | ユーザー設定のラベル |
|
| いいえ | ユーザー設定の説明。 |
|
| いいえ | ユーザー設定を定義するために値をレンダリングするのに使用される入力フィールドのオプション。 |
|
| はい | 項目が属するユーザー優先グループを識別するのに使用される ID。 |
|
| はい | このユーザー設定項目の後に配置しなければならない項目の ID |
|
| はい | このユーザー設定項目の前に配置しなければならない項目の ID |
console.yaml-template
yaml エディターを使用してリソースを編集するための YAML テンプレート。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | テンプレートに関連付けられたモデル。 |
|
| いいえ | YAML テンプレート。 |
|
| いいえ |
テンプレートの名前。名前 |
dev-console.add/action
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | アクションを識別するための ID。 |
|
| いいえ | アクションのラベル |
|
| いいえ | アクションの説明。 |
|
| いいえ | 移動先の href。 |
|
| はい | アクションが属するアクショングループを識別するのに使用される ID。 |
|
| はい | パースペクティブの表示アイコン。 |
|
| はい | アクションの可視性または有効化を制御するオプションのアクセスレビュー。 |
dev-console.add/action-group
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | アクショングループを識別するのに使用される ID。 |
|
| いいえ | アクショングループのタイトル |
|
| はい | このアクショングループの後に配置しなければならないグループの ID |
|
| はい | このアクショングループの前に配置しなければならないグループの ID |
dev-console.import/environment
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | カスタム環境変数を指定するイメージストリームの名前 |
|
| いいえ | サポートされるイメージストリームタグのリスト |
|
| いいえ | 環境変数のリスト |
console.page/resource/tab
非推奨。代わりに console.tab/horizontalNav
を使用してください。Console ルーターに新しいリソースタブページを追加します。
名前 | 値のタイプ | 任意 | 説明 |
---|---|---|---|
|
| いいえ | このリソースページがリンクするモデル。 |
|
| いいえ | ルートがマッチしたときにレンダリングされるコンポーネント。 |
|
| いいえ | タブの名前。 |
|
| はい |
タブリンクのオプション href。指定しない場合は、最初の |
|
| はい |
true の場合、パスが |
7.5.2. OpenShift Container Platform コンソール API
useActivePerspective
現在アクティブなパースペクティブとアクティブなパースペクティブを設定するためのコールバックを提供するフック。現在アクティブなパースペクティブとセッターコールバックを含むタプルを返します。
const Component: React.FC = (props) => { const [activePerspective, setActivePerspective] = useActivePerspective(); return <select value={activePerspective} onChange={(e) => setActivePerspective(e.target.value)} > { // ...perspective options } </select> }
GreenCheckCircleIcon
緑色のチェックマークの円形アイコンを表示するためのコンポーネント。
<GreenCheckCircleIcon title="Healthy" />
パラメーター名 | 説明 |
---|---|
| (オプション) コンポーネントの追加クラス名 |
| (オプション) アイコンのタイトル |
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
RedExclamationCircleIcon
赤い感嘆符の円形アイコンを表示するためのコンポーネント。
<RedExclamationCircleIcon title="Failed" />
パラメーター名 | 説明 |
---|---|
| (オプション) コンポーネントの追加クラス名 |
| (オプション) アイコンのタイトル |
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
YellowExclamationTriangleIcon
黄色の三角形の感嘆符アイコンを表示するためのコンポーネント。
<YellowExclamationTriangleIcon title="Warning" />
パラメーター名 | 説明 |
---|---|
| (オプション) コンポーネントの追加クラス名 |
| (オプション) アイコンのタイトル |
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
BlueInfoCircleIcon
青い情報円形アイコンを表示するためのコンポーネント。
<BlueInfoCircleIcon title="Info" />
パラメーター名 | 説明 |
---|---|
| (オプション) コンポーネントの追加クラス名 |
| (オプション) アイコンのタイトル |
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
ErrorStatus
エラーステータスのポップオーバーを表示するためのコンポーネント。
<ErrorStatus title={errorMsg} />
パラメーター名 | 説明 |
---|---|
| (オプション) ステータステキスト |
| (オプション) true の場合、アイコンのみを表示します |
| (オプション) true の場合、ツールチップは表示されません |
| (オプション) コンポーネントの追加クラス名 |
| (オプション) ポップオーバーのタイトル |
InfoStatus
情報ステータスのポップオーバーを表示するためのコンポーネント。
<InfoStatus title={infoMsg} />
パラメーター名 | 説明 |
---|---|
| (オプション) ステータステキスト |
| (オプション) true の場合、アイコンのみを表示します |
| (オプション) true の場合、ツールチップは表示されません |
| (オプション) コンポーネントの追加クラス名 |
| (オプション) ポップオーバーのタイトル |
ProgressStatus
進行状況のポップオーバーを表示するためのコンポーネント。
<ProgressStatus title={progressMsg} />
パラメーター名 | 説明 |
---|---|
| (オプション) ステータステキスト |
| (オプション) true の場合、アイコンのみを表示します |
| (オプション) true の場合、ツールチップは表示されません |
| (オプション) コンポーネントの追加クラス名 |
| (オプション) ポップオーバーのタイトル |
SuccessStatus
成功ステータスのポップオーバーを表示するためのコンポーネント。
<SuccessStatus title={successMsg} />
パラメーター名 | 説明 |
---|---|
| (オプション) ステータステキスト |
| (オプション) true の場合、アイコンのみを表示します |
| (オプション) true の場合、ツールチップは表示されません |
| (オプション) コンポーネントの追加クラス名 |
| (オプション) ポップオーバーのタイトル |
checkAccess
特定のリソースへのユーザーアクセスに関する情報を提供します。リソースアクセス情報を含むオブジェクトを返します。
パラメーター名 | 説明 |
---|---|
| アクセスレビューのリソース属性 |
| 権限借用の詳細 |
useAccessReview
特定のリソースへのユーザーアクセスに関する情報を提供するフック。isAllowed
と loading
値を含む配列を返します。
パラメーター名 | 説明 |
---|---|
| アクセスレビューのリソース属性 |
| 権限借用の詳細 |
useResolvedExtensions
解決された CodeRef
プロパティーで Console 拡張機能を使用するための React フック。このフックは、useExtensions
フックと同じ引数を受け入れ、拡張インスタンスの適合したリストを返し、各拡張のプロパティー内のすべてのコード参照を解決します。最初に、フックは空の配列を返します。解決が完了すると、React コンポーネントが再レンダリングされ、適合した拡張機能のリストが返されます。一致する拡張子のリストが変更されると、解決が再開されます。解決が完了するまで、フックは前の結果を返し続けます。フックの結果要素は、再レンダリング全体で参照的に安定していることが保証されています。解決されたコード参照、解決が完了したかどうかを示すブール値フラグ、および解決中に検出されたエラーのリストを含む適応拡張インスタンスのリストを含むタプルを返します。
const [navItemExtensions, navItemsResolved] = useResolvedExtensions<NavItem>(isNavItem); // process adapted extensions and render your component
パラメーター名 | 説明 |
---|---|
| それぞれが動的プラグイン拡張機能を引数として受け入れ、拡張機能が目的の型制約を満たしているかどうかを示すブール値フラグを返すコールバックのリスト |
HorizontalNav
ページのナビゲーションバーを作成するコンポーネント。ルーティングはコンポーネントの一部として処理されます。console.tab/horizontalNav
を使用して、任意の水平ナビゲーションにコンテンツを追加できます。
const HomePage: React.FC = (props) => { const page = { href: '/home', name: 'Home', component: () => <>Home</> } return <HorizontalNav match={props.match} pages={[page]} /> }
パラメーター名 | 説明 |
---|---|
| K8sResourceCommon タイプのオブジェクトである、このナビゲーションに関連付けられたリソース |
| ページオブジェクトの配列 |
| React Router が提供する match オブジェクト |
VirtualizedTable
仮想化されたテーブルを作成するためのコンポーネント。
const MachineList: React.FC<MachineListProps> = (props) => { return ( <VirtualizedTable<MachineKind> {...props} aria-label='Machines' columns={getMachineColumns} Row={getMachineTableRow} /> ); }
パラメーター名 | 説明 |
---|---|
| テーブルのデータ |
| データがロードされたことを示すフラグ |
| データのロードで問題が発生した場合のエラーオブジェクト |
| 列の設定 |
| 行の設定 |
| フィルターなしの元のデータ |
| (オプション) データのない空のメッセージコンポーネント |
| (オプション) 空のメッセージコンポーネント |
| (オプション) スクロールを処理する関数 |
| (オプション) テーブルのラベル |
| (オプション) aria ラベル |
| 応答性のためにグリッドを分割する方法のサイジング |
| (オプション) テーブルの選択を処理する関数 |
| (オプション) 行に固有のデータ |
TableData
テーブル行内にテーブルデータを表示するためのコンポーネント。
const PodRow: React.FC<RowProps<K8sResourceCommon>> = ({ obj, activeColumnIDs }) => { return ( <> <TableData id={columns[0].id} activeColumnIDs={activeColumnIDs}> <ResourceLink kind="Pod" name={obj.metadata.name} namespace={obj.metadata.namespace} /> </TableData> <TableData id={columns[1].id} activeColumnIDs={activeColumnIDs}> <ResourceLink kind="Namespace" name={obj.metadata.namespace} /> </TableData> </> ); };
パラメーター名 | 説明 |
---|---|
| テーブルの一意の ID |
| アクティブな列 |
| (オプション) スタイリングのオプションクラス名 |
useActiveColumns
ユーザーが選択したアクティブな TableColumns のリストを提供するフック。
// See implementation for more details on TableColumn type const [activeColumns, userSettingsLoaded] = useActiveColumns({ columns, showNamespaceOverride: false, columnManagementID, }); return userSettingsAreLoaded ? <VirtualizedTable columns= {activeColumns} {...otherProps} /> : null
パラメーター名 | 説明 |
---|---|
| キーと値のマップとして渡されるもの。 |
`` | \{TableColumn[]} options.columns - 利用可能なすべての TableColumn の配列 |
`` | {boolean} [options.showNamespaceOverride] - (オプション) true の場合、列管理の選択に関係なく、namespace 列が含まれます。 |
`` | {string} [options.columnManagementID] - (オプション) ユーザー設定との間で列管理の選択を保持および取得するために使用される一意の ID。通常、リソースの groupverionkind 文字列。 |
現在のユーザーが選択したアクティブな列 (options.columns のサブセット) と、ユーザー設定がロードされたかどうかを示すブール値フラグを含むタプル。
ListPageHeader
ページヘッダーを生成するためのコンポーネント。
const exampleList: React.FC = () => { return ( <> <ListPageHeader title="Example List Page"/> </> ); };
パラメーター名 | 説明 |
---|---|
| 見出しタイトル |
| (オプション) 反応ノードとしてのヘルプセクション |
| (オプション) 反応ノードとしてのバッジアイコン |
ListPageCreate
特定のリソースの種類に対して、そのリソースの作成用 YAML へのリンクを自動的に生成する作成ボタンを追加するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => { return ( <> <ListPageHeader title="Example Pod List Page"/> <ListPageCreate groupVersionKind="Pod">Create Pod</ListPageCreate> </ListPageHeader> </> ); };
パラメーター名 | 説明 |
---|---|
| 表すためのリソースグループ/バージョン/種類 |
ListPageCreateLink
定型化されたリンクを作成するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => { return ( <> <ListPageHeader title="Example Pod List Page"/> <ListPageCreateLink to={'/link/to/my/page'}>Create Item</ListPageCreateLink> </ListPageHeader> </> ); };
パラメーター名 | 説明 |
---|---|
| リンク先の文字列の場所 |
| (オプション) アクセスを決定するために使用される namespace と種類を持つオブジェクト |
| (オプション) コンポーネントの子 |
ListPageCreateButton
ボタンを作成するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => { return ( <> <ListPageHeader title="Example Pod List Page"/> <ListPageCreateButton createAccessReview={access}>Create Pod</ListPageCreateButton> </ListPageHeader> </> ); };
パラメーター名 | 説明 |
---|---|
| (オプション) アクセスを決定するために使用される namespace と種類を持つオブジェクト |
| (オプション) Patternfly Button のプロパティー |
ListPageCreateDropdown
権限チェックでラップされたドロップダウンを作成するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => { const items = { SAVE: 'Save', DELETE: 'Delete', } return ( <> <ListPageHeader title="Example Pod List Page"/> <ListPageCreateDropdown createAccessReview={access} items={items}>Actions</ListPageCreateDropdown> </ListPageHeader> </> ); };
パラメーター名 | 説明 |
---|---|
| key: ドロップダウンコンポーネントに表示する項目の ReactNode のペア |
| ドロップダウン項目をクリックするためのコールバック関数 |
| (オプション) アクセスを決定するために使用される namespace と種類を持つオブジェクト |
| (オプション) ドロップダウントグルの子 |
ListPageFilter
リストページのフィルターを生成するコンポーネント。
// See implementation for more details on RowFilter and FilterValue types const [staticData, filteredData, onFilterChange] = useListPageFilter( data, rowFilters, staticFilters, ); // ListPageFilter updates filter state based on user interaction and resulting filtered data can be rendered in an independent component. return ( <> <ListPageHeader .../> <ListPagBody> <ListPageFilter data={staticData} onFilterChange={onFilterChange} /> <List data={filteredData} /> </ListPageBody> </> )
パラメーター名 | 説明 |
---|---|
| データポイントの配列 |
| データがロードされたことを示します |
| フィルター更新時のコールバック関数 |
| (オプション) 利用可能なフィルターオプションを定義する RowFilter 要素の配列 |
| (オプション) 名前フィルターのプレースホルダー |
| (オプション) ラベルフィルターのプレースホルダー |
| (オプション) 名前フィルターとラベルフィルターの両方ではなく、名前フィルターのみを表示します。 |
| (オプション) 名前フィルターとラベルフィルターの両方を非表示にします。 |
| (オプション) 列レイアウトオブジェクト |
| (オプション) 列管理を非表示にするフラグ |
useListPageFilter
ListPageFilter コンポーネントのフィルター状態を管理するフック。すべての静的フィルターによってフィルター処理されたデータ、すべての静的フィルターと行フィルターによってフィルター処理されたデータ、および rowFilters を更新するコールバックを含むタプルを返します。
// See implementation for more details on RowFilter and FilterValue types const [staticData, filteredData, onFilterChange] = useListPageFilter( data, rowFilters, staticFilters, ); // ListPageFilter updates filter state based on user interaction and resulting filtered data can be rendered in an independent component. return ( <> <ListPageHeader .../> <ListPagBody> <ListPageFilter data={staticData} onFilterChange={onFilterChange} /> <List data={filteredData} /> </ListPageBody> </> )
パラメーター名 | 説明 |
---|---|
| データポイントの配列 |
| (オプション) 利用可能なフィルターオプションを定義する RowFilter 要素の配列 |
| (オプション) データに静的に適用される FilterValue 要素の配列 |
ResourceLink
アイコンバッジを使用して特定のリソースタイプへのリンクを作成するコンポーネント。
<ResourceLink kind="Pod" name="testPod" title={metadata.uid} />
パラメーター名 | 説明 |
---|---|
| (オプション) リソースの種類、つまり Pod、Deployment、Namespace |
| (オプション) groupd、version、kind を持つオブジェクト |
| (オプション) コンポーネントのクラススタイル |
| (オプション) コンポーネントの表示名。設定されている場合は、リソース名を上書きします。 |
| (オプション) アイコンバッジを作成し、子とインラインで名前を付けるためのフラグ |
| (オプション) Link オブジェクトを作成するためのフラグ - デフォルトは true |
| (オプション) リソースの名前 |
| (オプション) リンク先の種類のリソースの特定の namespace |
| (オプション) アイコンバッジを非表示にするフラグ |
| (オプション) リンクオブジェクトのタイトル (非表示) |
| (オプション) テスト用の識別子 |
| (オプション) コンポーネントがクリックされたときのコールバック関数 |
| (オプション) リンクが長すぎる場合に切り捨てるフラグ |
ResourceIcon
特定のリソースタイプのアイコンバッジを作成するコンポーネント。
<ResourceIcon kind="Pod"/>
パラメーター名 | 説明 |
---|---|
| (オプション) リソースの種類、つまり Pod、Deployment、Namespace |
| (オプション) グループ、バージョン、および種類を含むオブジェクト |
| (オプション) コンポーネントのクラススタイル |
useK8sModel
指定された K8sGroupVersionKind の k8s モデルを redux から取得するフック。最初の項目が k8s モデル、2 番目の項目が inFlight
ステータスの配列を返します。
const Component: React.FC = () => { const [model, inFlight] = useK8sModel({ group: 'app'; version: 'v1'; kind: 'Deployment' }); return ... }
パラメーター名 | 説明 |
---|---|
|
k8s リソースのグループ、バージョン、種類 \{@link K8sGroupVersionKind} が推奨されます。代わりに、非推奨のグループ、バージョン、種類の参照を渡すこともできます。つまり、 |
useK8sModels
redux から現在のすべての k8s モデルを取得するフック。最初の項目が k8s モデルのリストで、2 番目の項目が inFlight
ステータスの配列を返します。
const Component: React.FC = () => { const [models, inFlight] = UseK8sModels(); return ... }
useK8sWatchResource
ロード済みおよびエラーのステータスとともに k8s リソースを取得するフック。最初の項目がリソース、2 番目の項目がロード済みステータス、3 番目の項目がエラー状態 (存在する場合) の配列を返します。
const Component: React.FC = () => { const watchRes = { ... } const [data, loaded, error] = useK8sWatchResource(watchRes) return ... }
パラメーター名 | 説明 |
---|---|
| リソースを監視するために必要なオプション。 |
useK8sWatchResources
ロード済みおよびエラーのそれぞれのステータスとともに k8s リソースを取得するフック。キーが initResouces で提供され、値が data、loaded、error の 3 つのプロパティーを持つマップを返します。
const Component: React.FC = () => { const watchResources = { 'deployment': {...}, 'pod': {...} ... } const {deployment, pod} = useK8sWatchResources(watchResources) return ... }
パラメーター名 | 説明 |
---|---|
| リソースはキーと値のペアとして監視する必要があります。ここで、キーはリソースに固有であり、値はそれぞれのリソースを監視するために必要なオプションです。 |
consoleFetch
コンソール固有のヘッダーを追加し、再試行とタイムアウトを可能にする fetch
のカスタムラッパー。また、応答ステータスコードを検証し、適切なエラーを出力するか、必要に応じてユーザーをログアウトします。レスポンスに解決される promise を返します。
パラメーター名 | 説明 |
---|---|
| 取得する URL |
| フェッチに渡すオプション |
| ミリ秒単位のタイムアウト |
consoleFetchJSON
コンソール固有のヘッダーを追加し、再試行とタイムアウトを可能にする fetch
のカスタムラッパー。また、応答ステータスコードを検証し、適切なエラーを出力するか、必要に応じてユーザーをログアウトします。応答を JSON オブジェクトとして返します。内部で consoleFetch
を使用します。JSON オブジェクトとして応答に解決される promise を返します。
パラメーター名 | 説明 |
---|---|
| 取得する URL |
| 使用する HTTP メソッドデフォルトは GET です。 |
| フェッチに渡すオプション |
| ミリ秒単位のタイムアウト |
| リクエストを行うクラスターの名前。デフォルトは、ユーザーが選択したアクティブなクラスターです |
consoleFetchText
コンソール固有のヘッダーを追加し、再試行とタイムアウトを可能にする fetch
のカスタムラッパー。また、応答ステータスコードを検証し、適切なエラーを出力するか、必要に応じてユーザーをログアウトします。応答をテキストとして返します。内部で consoleFetch
を使用します。テキストとして応答に解決される promise を返します。
パラメーター名 | 説明 |
---|---|
| 取得する URL |
| フェッチに渡すオプション |
| ミリ秒単位のタイムアウト |
| リクエストを行うクラスターの名前。デフォルトは、ユーザーが選択したアクティブなクラスターです |
getConsoleRequestHeaders
現在の redux 状態を使用して、API リクエストの権限借用およびマルチクラスター関連ヘッダーを作成する関数。redux 状態に基づいて、適切な権限借用ヘッダーとクラスター要求ヘッダーを含むオブジェクトを返します。
パラメーター名 | 説明 |
---|---|
| 指定された targetCluster で現在アクティブなクラスターをオーバーライドします |
k8sGetResource
指定されたオプションに基づいて、クラスターからリソースを取得します。名前が指定されている場合は、1 つのリソースが返されます。それ以外の場合は、モデルに一致するすべてのリソースが返されます。名前が指定されている場合、リソースを含む JSON オブジェクトとして応答に解決される promise を返します。それ以外の場合は、モデルに一致するすべてのリソースを返します。失敗した場合、promise は HTTP エラー応答で拒否されます。
パラメーター名 | 説明 |
---|---|
| マップでキーと値のペアとして渡されるもの。 |
`` | options.model - k8s モデル |
`` | options.name - リソースの名前。指定されていない場合は、モデルに一致するすべてのリソースが検索されます。 |
`` | options.ns - 調べる namespace。クラスタースコープのリソースには指定しないでください。 |
`` | options.path - 提供された場合、サブパスとして追加します |
`` | options.queryParams - URL に含まれるクエリーパラメーター。 |
`` | options.requestInit - 使用するフェッチ初期化オブジェクト。これには、リクエストヘッダー、メソッド、リダイレクトなどを含めることができます。詳細 (リンク: https://microsoft.github.io/PowerBI-JavaScript/interfaces/node_modules_typedoc_node_modules_typescript_lib_lib_dom_d.requestinit.html) |
k8sCreateResource
指定されたオプションに基づいて、クラスター内にリソースを作成します。作成されたリソースの応答に解決される promise を返します。失敗した場合、promise は HTTP エラー応答で拒否されます。
パラメーター名 | 説明 |
---|---|
| マップでキーと値のペアとして渡されるもの。 |
`` | options.model - k8s モデル |
`` | options.data - 作成されるリソースのペイロード |
`` | options.path - 提供された場合、サブパスとして追加します |
`` | options.queryParams - URL に含まれるクエリーパラメーター。 |
k8sUpdateResource
指定されたオプションに基づいて、クラスター内のリソース全体を更新します。クライアントが既存のリソースを完全に置き換える必要がある場合、k8sUpdate を使用できます。または、k8sPatch を使用して部分的な更新を実行することもできます。更新されたリソースの応答に解決される promise を返します。失敗した場合、promise は HTTP エラー応答で拒否されます。
パラメーター名 | 説明 |
---|---|
| マップでキーと値のペアとして渡されるもの。 |
`` | options.model - k8s モデル |
`` | options.data - 更新する k8s リソースのペイロード |
`` | options.ns - 調べる namespace。クラスタースコープのリソースには指定しないでください。 |
`` | options.name - 更新するリソース名。 |
`` | options.path - 提供された場合、サブパスとして追加します |
`` | options.queryParams - URL に含まれるクエリーパラメーター。 |
k8sPatchResource
指定されたオプションに基づいて、クラスター内の任意のリソースにパッチを適用します。クライアントが部分的な更新を実行する必要がある場合、k8sPatch を使用できます。または、k8sUpdate を使用して、既存のリソースを完全に置き換えることもできます。詳細については、データトラッカー を参照してください。パッチが適用されたリソースの応答に解決される promise を返します。失敗した場合、promise は HTTP エラー応答で拒否されます。
パラメーター名 | 説明 |
---|---|
| マップでキーと値のペアとして渡されるもの。 |
`` | options.model - k8s モデル |
`` | options.resource - パッチを適用するリソース。 |
`` | options.data - 操作、パス、および値を使用して、既存のリソースにパッチを適用するデータのみ。 |
`` | options.path - 提供された場合、サブパスとして追加します。 |
`` | options.queryParams - URL に含まれるクエリーパラメーター。 |
k8sDeleteResource
指定されたモデル、リソースに基づいて、クラスターからリソースを削除します。ガベージコレクションは 'Foreground'|'Background' に基づいて機能し、提供されたモデルの propagationPolicy プロパティーで設定するか、json で渡すことができます。種類が Status のレスポンスに解決される promise を返します。失敗した場合、promise は HTTP エラー応答で拒否されます。
{ kind: 'DeleteOptions', apiVersion: 'v1', propagationPolicy }
パラメーター名 | 説明 |
---|---|
| マップでキーと値のペアとして渡されるもの。 |
`` | options.model - k8s モデル |
`` | options.resource - 削除するリソース。 |
`` | options.path - 提供された場合、サブパスとして追加します |
`` | options.queryParams - URL に含まれるクエリーパラメーター。 |
`` | options.requestInit - 使用するフェッチ初期化オブジェクト。これには、リクエストヘッダー、メソッド、リダイレクトなどを含めることができます。詳細 \{@link https://microsoft.github.io/PowerBI-JavaScript/interfaces/node_modules_typedoc_node_modules_typescript_lib_lib_dom_d.requestinit.html } |
`` | options.json - リソースのガベージコレクションを明示的に制御できます。それ以外の場合は、モデルの propagationPolicy がデフォルトになります。 |
k8sListResource
指定されたオプションに基づいて、リソースをクラスター内の配列として一覧表示します。レスポンスに解決される promise を返します。
パラメーター名 | 説明 |
---|---|
| マップでキーと値のペアとして渡されるもの。 |
`` | options.model - k8s モデル |
`` | options.queryParams - URL に含まれるクエリーパラメーター。ラベルセレクターとキー labelSelector を渡すことができます。 |
`` | options.requestInit - 使用するフェッチ初期化オブジェクト。これには、リクエストヘッダー、メソッド、リダイレクトなどを含めることができます。詳細 \{@link https://microsoft.github.io/PowerBI-JavaScript/interfaces/node_modules_typedoc_node_modules_typescript_lib_lib_dom_d.requestinit.html } |
k8sListResourceItems
\{@link k8sListResource} と同じインターフェイスですが、サブ項目を返します。モデルの apiVersion、つまり group/version
を返します。
getAPIVersionForModel
k8s モデルの apiVersion を提供します。
パラメーター名 | 説明 |
---|---|
| k8s モデル |
getGroupVersionKindForResource
リソースのグループ、バージョン、および種類を提供します。指定されたリソースのグループ、バージョン、種類を返します。リソースに API グループがない場合、グループ core が返されます。リソースに無効な apiVersion がある場合、エラーが出力されます。
パラメーター名 | 説明 |
---|---|
| k8s リソース |
getGroupVersionKindForModel
k8s モデルのグループ、バージョン、および種類を提供します。これは、提供されたモデルのグループ、バージョン、種類を返します。モデルに apiGroup がない場合、グループ core が返されます。
パラメーター名 | 説明 |
---|---|
| k8s モデル |
StatusPopupSection
ポップアップウィンドウでステータスを表示するコンポーネント。console.dashboards/overview/health/resource
拡張機能を構築するための便利なコンポーネント。
<StatusPopupSection firstColumn={ <> <span>{title}</span> <span className="text-secondary"> My Example Item </span> </> } secondColumn='Status' >
パラメーター名 | 説明 |
---|---|
| ポップアップの最初の列の値 |
| (オプション) ポップアップの 2 列目の値 |
| (オプション) ポップアップの子 |
StatusPopupItem
ステータスポップアップで使用されるステータス要素。StatusPopupSection
で使用されます。
<StatusPopupSection firstColumn='Example' secondColumn='Status' > <StatusPopupItem icon={healthStateMapping[MCGMetrics.state]?.icon}> Complete </StatusPopupItem> <StatusPopupItem icon={healthStateMapping[RGWMetrics.state]?.icon}> Pending </StatusPopupItem> </StatusPopupSection>
パラメーター名 | 説明 |
---|---|
| (オプション) 表示するテキスト値 |
| (オプション) 表示するアイコン |
| 子要素 |
概要
ダッシュボードのラッパーコンポーネントを作成します。
<Overview> <OverviewGrid mainCards={mainCards} leftCards={leftCards} rightCards={rightCards} /> </Overview>
パラメーター名 | 説明 |
---|---|
| (オプション) div のスタイルクラス |
| (オプション) ダッシュボードの要素 |
OverviewGrid
ダッシュボードのカード要素のグリッドを作成します。Overview
内で使用されます。
<Overview> <OverviewGrid mainCards={mainCards} leftCards={leftCards} rightCards={rightCards} /> </Overview>
パラメーター名 | 説明 |
---|---|
| グリッド用カード |
| (オプション) グリッドの左側のカード |
| (オプション) グリッドの右側のカード |
InventoryItem
インベントリーカード項目を作成します。
return ( <InventoryItem> <InventoryItemTitle>{title}</InventoryItemTitle> <InventoryItemBody error={loadError}> {loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />} </InventoryItemBody> </InventoryItem> )
パラメーター名 | 説明 |
---|---|
| 項目内でレンダリングする要素 |
InventoryItemTitle
インベントリーカード項目のタイトルを作成します。InventoryItem
内で使用されます。
return ( <InventoryItem> <InventoryItemTitle>{title}</InventoryItemTitle> <InventoryItemBody error={loadError}> {loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />} </InventoryItemBody> </InventoryItem> )
パラメーター名 | 説明 |
---|---|
| タイトル内にレンダリングする要素 |
InventoryItemBody
インベントリーカードの本文を作成します。InventoryCard
内で使用され、InventoryTitle
と使用できます。
return ( <InventoryItem> <InventoryItemTitle>{title}</InventoryItemTitle> <InventoryItemBody error={loadError}> {loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />} </InventoryItemBody> </InventoryItem> )
パラメーター名 | 説明 |
---|---|
| インベントリーカードまたはタイトル内でレンダリングする要素 |
| div の要素 |
InventoryItemStatus
オプションのリンクアドレスを使用してインベントリーカードのカウントとアイコンを作成します。InventoryItemBody
内で使用されます。
return ( <InventoryItem> <InventoryItemTitle>{title}</InventoryItemTitle> <InventoryItemBody error={loadError}> {loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />} </InventoryItemBody> </InventoryItem> )
パラメーター名 | 説明 |
---|---|
| 表示用カウント |
| 表示用アイコン |
| (オプション) リンクアドレス |
InventoryItemLoading
インベントリーカードのロード時にスケルトンコンテナーを作成します。InventoryItem
および関連コンポーネントで使用されます。
if (loadError) { title = <Link to={workerNodesLink}>{t('Worker Nodes')}</Link>; } else if (!loaded) { title = <><InventoryItemLoading /><Link to={workerNodesLink}>{t('Worker Nodes')}</Link></>; } return ( <InventoryItem> <InventoryItemTitle>{title}</InventoryItemTitle> </InventoryItem> )
useFlag
FLAGS redux 状態から指定された機能フラグを返すフック。要求された機能フラグまたは未定義のブール値を返します。
パラメーター名 | 説明 |
---|---|
| 返す機能フラグ |
YAMLEditor
ホバーヘルプと補完機能を備えた基本的な遅延ロード YAML エディター。
<React.Suspense fallback={<LoadingBox />}> <YAMLEditor value={code} /> </React.Suspense>
パラメーター名 | 説明 |
---|---|
| レンダリングする yaml コードを表す文字列。 |
| Monaco エディターのオプション。詳細については、https://microsoft.github.io/monaco-editor/api/interfaces/monaco.editor.IStandaloneEditorConstructionOptions.html にアクセスしてください。 |
| 有効な CSS の高さの値における最小のエディターの高さ。 |
| エディターの上にショートカットを表示するためのブール値。 |
| エディター上部のツールバーリンクセクションにレンダリングされる ReactNode の配列。 |
| コード変更イベントのコールバック。 |
| コマンド CTRL / CMD + S がトリガーされたときに呼び出されるコールバック。 |
|
|
ResourceYAMLEditor
ホバーヘルプと補完機能を備えた Kubernetes リソース用の遅延ロード YAML エディター。このコンポーネントは YAMLEditor を使用し、その上にリソースの更新処理、アラート、保存、キャンセル、リロードボタン、アクセシビリティなどの機能を追加します。onSave
コールバックが提供されないかぎり、リソースの更新は自動的に処理されます。React.Suspense コンポーネントでラップする必要があります。
<React.Suspense fallback={<LoadingBox />}> <ResourceYAMLEditor initialResource={resource} header="Create resource" onSave={(content) => updateResource(content)} /> </React.Suspense>
パラメーター名 | 説明 |
---|---|
| エディターによって表示されるリソースを表す YAML/オブジェクト。この prop は、最初のレンダリング中にのみ使用されます |
| YAML エディターの上にヘッダーを追加する |
| Save ボタンのコールバック。これを渡すと、エディターによってリソースに対して実行されたデフォルトの更新が上書きされます |
ResourceEventStream
特定のリソースに関連するイベントを表示するコンポーネント。
const [resource, loaded, loadError] = useK8sWatchResource(clusterResource); return <ResourceEventStream resource={resource} />
パラメーター名 | 説明 |
---|---|
| 関連イベントを表示するオブジェクト。 |
usePrometheusPoll
単一のクエリーに対して Prometheus へのポーリングを設定します。クエリー応答、応答が完了したかどうかを示すブール値フラグ、および要求中または要求の後処理中に発生したエラーを含むタプルを返します。
パラメーター名 | 説明 |
---|---|
`` | {PrometheusEndpoint} props.endpoint - PrometheusEndpoint の 1 つ (ラベル、クエリー、範囲、ルール、ターゲット) |
`` | {string} [props.query] - (オプション) Prometheus クエリー文字列。空または未定義の場合、ポーリングは開始されません。 |
`` | {number} [props.delay] - (オプション) ポーリング遅延間隔 (ミリ秒) |
`` | {number} [props.endTime] - (オプション) QUERY_RANGE エンドポイント用、クエリー範囲の終わり |
`` | {number} [props.samples] - (オプション) QUERY_RANGE エンポイント用 |
`` | {number} [options.timespan] - (オプション) QUERY_RANGE エンドポイント用 |
`` | {string} [options.namespace] - (オプション) 追加する検索パラメーター |
`` | {string} [options.timeout] - (オプション) 追加する検索パラメーター |
Timestamp
タイムスタンプをレンダリングするコンポーネント。タイムスタンプは、Timestamp コンポーネントの個々のインスタンス間で同期されます。指定されたタイムスタンプは、ユーザーロケールに従ってフォーマットされます。
パラメーター名 | 説明 |
---|---|
| レンダリングするタイムスタンプ。形式は、ISO 8601 (Kubernetes で使用)、エポックタイムスタンプ、または日付のインスタンスであることが期待されます。 |
| アイコンとツールチップを省略したシンプルなバージョンのコンポーネントをレンダリングします。 |
| 接尾辞を省略して日付をフォーマットします。 |
| コンポーネントの追加のクラス名。 |
useModal
モーダルを起動するためのフック。
const context: AppPage: React.FC = () => {<br/> const [launchModal] = useModal();<br/> const onClick = () => launchModal(ModalComponent);<br/> return (<br/> <Button onClick={onClick}>Launch a Modal</Button><br/> )<br/>}<br/>`
ActionServiceProvider
console.action/provider
拡張タイプの他のプラグインからのコントリビューションを受け取ることを可能にするコンポーネント。
const context: ActionContext = { 'a-context-id': { dataFromDynamicPlugin } }; ... <ActionServiceProvider context={context}> {({ actions, options, loaded }) => loaded && ( <ActionMenu actions={actions} options={options} variant={ActionMenuVariant.DROPDOWN} /> ) } </ActionServiceProvider>
パラメーター名 | 説明 |
---|---|
| contextId とオプションのプラグインデータを含むオブジェクト |
NamespaceBar
namespace のドロップダウンメニューが左端にある水平ツールバーをレンダリングするコンポーネント。追加のコンポーネントを子として渡すことができ、namespace ドロップダウンの右側にレンダリングされます。このコンポーネントは、ページの上部で使用するように設計されています。k8s リソースを含むページなど、ユーザーがアクティブな namespace を変更できる必要があるページで使用する必要があります。
const logNamespaceChange = (namespace) => console.log(`New namespace: ${namespace}`); ... <NamespaceBar onNamespaceChange={logNamespaceChange}> <NamespaceBarApplicationSelector /> </NamespaceBar> <Page> ...
パラメーター名 | 説明 |
---|---|
| (オプション) namespace オプションが選択されたときに実行される関数。唯一の引数として、文字列の形式で新しい namespace を受け入れます。オプションが選択されると、アクティブな namespace が自動的に更新されますが、この関数を介して追加のロジックを適用できます。namespace が変更されると、URL の namespace パラメーターが以前の namespace から新しく選択された namespace に変更されます。 |
| (オプション) true に設定されている場合、namespace のドロップダウンを無効にするブール値フラグ。このオプションは namespace ドロップダウンにのみ適用され、子コンポーネントには影響しません。 |
| (オプション) namespace ドロップダウンの右側にあるツールバー内にレンダリングされる追加の要素。 |
ErrorBoundaryFallbackPage
フルページの ErrorBoundaryFallbackPage コンポーネントを作成して、"Oh no!Something went wrong." というメッセージと、スタックトレースおよびその他の役立つデバッグ情報を表示します。これは、コンポーネントと組み合わせて使用されます。
//in ErrorBoundary component return ( if (this.state.hasError) { return <ErrorBoundaryFallbackPage errorMessage={errorString} componentStack={componentStackString} stack={stackTraceString} title={errorString}/>; } return this.props.children; )
パラメーター名 | 説明 |
---|---|
| エラーメッセージのテキスト説明 |
| 例外のコンポーネントトレース |
| 例外のスタックトレース |
| エラー境界ページのヘッダーとしてレンダリングするタイトル |
PerspectiveContext
@deprecated - 代わりに提供された usePerspectiveContext
を使用して、パースペクティブコンテキストを作成します。
パラメーター名 | 説明 |
---|---|
| アクティブなパースペクティブとセッターを含むオブジェクト |
useAccessReviewAllowed
@deprecated - 代わりに @console/dynamic-plugin-sdk の useAccessReview を使用します。特定のリソースへのユーザーアクセスに関する許可ステータスを提供するフック。isAllowed
ブール値を返します。
パラメーター名 | 説明 |
---|---|
| アクセスレビューのリソース属性 |
| 権限借用の詳細 |
useSafetyFirst
@deprecated - このフックは、コンソール機能とは関係ありません。特定のコンポーネントがアンマウントされる可能性がある場合に備えて、React 状態の安全な非同期設定を保証するフックです。状態値とその set 関数のペアを含む配列を返します。
パラメーター名 | 説明 |
---|---|
| 初期状態値 |
7.5.3. 動的プラグインのトラブルシューティング
プラグインのロードで問題が発生した場合は、このトラブルシューティングのヒントのリストを参照してください。
以下のコマンドを実行して、コンソールの Operator 設定でプラグインが有効になっており、プラグイン名が出力されていることを確認します。
$ oc get console.operator.openshift.io cluster -o jsonpath='{.spec.plugins}'
- Administrator perspective の Overview ページのステータスカードで、有効なプラグインを確認します。プラグインが最近有効になった場合は、ブラウザーを更新する必要があります。
次の方法で、プラグインサービスが正常であることを確認します。
- プラグイン Pod のステータスが実行中であり、コンテナーの準備が整っていることを確認します。
- サービスラベルセレクターが Pod と一致し、ターゲットポートが正しいことを確認します。
-
コンソール Pod またはクラスター上の別の Pod のターミナルで、サービスから
plugin-manifest.json
をカールします。
-
ConsolePlugin
リソース名 (consolePlugin.name
) がpackage.json
で使用されているプラグイン名と一致することを確認します。 -
サービス名、namespace、ポート、およびパスが
ConsolePlugin
リソースで正しく宣言されていることを確認します。 - プラグインサービスが HTTPS とサービス提供証明書を使用していることを確認します。
- コンソール Pod ログで証明書または接続エラーを確認します。
- プラグインが依存する機能フラグが無効になっていないことを確認します。
プラグインの
package.json
に一致しないconsolePlugin.dependencies
がないことを確認します。- これには、コンソールバージョンの依存関係または他のプラグインへの依存関係が含まれる場合があります。ブラウザーで JS コンソールをプラグインの名前でフィルタリングして、ログに記録されたメッセージを表示します。
ナビゲーション拡張パースペクティブまたはセクション ID にタイプミスがないことを確認します。
- プラグインはロードされている可能性がありますが、ID が正しくない場合、ナビゲーション項目が表示されません。URL を編集して、プラグインページに直接移動してみてください。
コンソール Pod からプラグインサービスへのトラフィックをブロックしているネットワークポリシーがないことを確認します。
- 必要に応じて、ネットワークポリシーを調整して、openshift-console namespace のコンソール Pod がサービスにリクエストを送信できるようにします。
開発者ツールブラウザーの Console タブで、ブラウザーにロードされる動的プラグインのリストを確認します。
-
window.SERVER_FLAGS.consolePlugins
を評価して、コンソールフロントエンドの動的プラグインを確認します。
-
関連情報