Web コンソール

Red Hat Advanced Cluster Management for Kubernetes 2.2

詳細は、コンソールコンポーネントの使用方法を参照してください。

概要

詳細は、コンソールコンポーネントの使用方法を参照してください。

第1章 Web コンソール

Red Hat Advanced Cluster Management コンソールにアクセスする方法とコンソールのコンポーネントの使用方法を説明します。

1.1. コンソールへのアクセス

Red Hat OpenShift Container Platform の Web コンソールから Red Hat Advanced Cluster Management for Kubernetes のコンソールにアクセスできます。コンソールには、インストール後にターミナルからもアクセスできます。以下で、コンソールへのアクセス方法すべてを確認してください。

1.1.1. OpenShift Container Platform Web コンソールからのアクセス

  • ヘッダーで アプリケーションランチャー をクリックし、Red Hat Advanced Cluster Management for Kubernetes オプションを選択します。
  • 左側のナビゲーションからコンソールにアクセスすることもできます。

    • Networking > Routes をクリックします。
    • Project メニューから、Red Hat Advanced Cluster Management for Kubernetes がインストールされている namespace を選択します。
    • multicloud-console を検索して、Location コラムから URL をクリックします。

1.1.2. Red Hat OpenShift CLI からのアクセス

  1. Red Hat OpenShift Container Platform にログインし、Red Hat Advanced Cluster Management for Kubernetes をインストールしたら、以下のコマンドを実行してルートを検索します。ここでは、<namespace-from-install> は当製品をインストールした namespace に置き換えます。
  oc get routes -n <namespace-from-install>
  1. multicloud-console 名と Host/Port コラムを探し出して、URL を取得します。

Red Hat Advanced Cluster Management for Kubernetes コンソールの詳細は、「Web コンソール」を参照してください

1.2. コンソールの可観測性

コンソールの表示、管理、またはカスタマイズに使用可能なコンソールのコンポーネントについて説明します。

以下で Red Hat Advanced Cluster Management for Kubernetes コンソールの ナビゲーション の画像を参照してください。このコンソールについては、後続の各セクションで詳細を説明します。ナビゲーションに、主要な実稼働機能があることが分かります。

Navigation

1.2.1. コンソールのコンポーネント

検索の詳細は、「 コンソールでの検索」を参照してください。

1.2.2. コンソールへのアクセス

  • Red Hat OpenShift Container Platform コンソールからのアクセス:

    1. 左側のナビゲーションから、Networking > Routes をクリックします。
    2. Project メニューから、Red Hat Advanced Cluster Management for Kubernetes がインストールされている namespace を選択します。
    3. multicloud-console を検索して、Location コラムから URL をクリックします。
  • Red Hat OpenShift CLI からのコンソールへのアクセス:

    1. OpenShift にログインし、以下のコマンドを実行してルートを検索します。<namespace-from-install> は Red Hat Advanced Cluster Management for Kubernetes をインストールしたした namespace に置き換えます。
    oc get routes -n <namespace-from-install>
    1. multicloud-console 名と Host/Port コラムを探し出して、URL を取得します。

1.2.3. Welcome ページ

Red Hat Advanced Cluster Management for Kubernetes の Welcome ページからは、製品の詳細情報を取得できます。また、アプリケーション メニュー、検索リソースの作成Visual Web ターミナル情報 などのヘッダー機能にもアクセスできます。

アプリケーション メニューを選択すると、異なるマネージドクラスターに移動できます。Search アイコンを選択してクエリーし、Search ページからクラスターリソースを確認します。また、検索機能は、ヘッダーの Visual Web ターミナル から使用することも使用できます。Visual Web ターミナルを使用すると、クラスター全体でコマンドを実行できます。詳細は、「 Visual Web ターミナル 」を参照してください。

Create resource を選択すると、デプロイメントの YAML ファイルまたは JSON ファイルを作成できます。ヘッダー から Info (?) アイコンをクリックして About ページやドキュメントを表示できます。User メニューから Configure Client ページにアクセスできます。

1.2.4. 環境 の概要ページ の確認

以下のようなクラスター情報を 概要 ダッシュボードで表示できます。

  • マネージドクラスターからのメトリクスデータ (Grafana リンクを選択)
  • 全クラスターおよびプロバイダー別のクラスター、ノード、Pod 数
  • クラスターのステータス
  • クラスターのコンプライアンス
  • Pod のステータス

また、ダッシュボードにはクリック可能な要素が含まれており、この要素から関連のリソースの検索を表示できます。プロバイダーカードをクリックすると、単一プロバイダーからクラスターの情報が表示されます。

1.2.5. 環境の詳細確認

Grafana ダッシュボードからクラスターおよび Pod の情報を表示して理解を深めることで、マネージドクラスターを最適化できます。詳細は、「環境の確認」を参照してください。

1.2.6. インフラストラクチャーの自動化

クラスターを作成するか、または既存クラスターをインポートします。必要に応じてクラスターをスケールアップまたはスケールダウンし、削除します。詳細は、「Red Hat Advanced Cluster Management for Kubernetes でのクラスターの管理」を参照してください。

1.2.7. アプリケーションの管理

New application をクリックして .yaml ファイルを編集し、アプリケーションを作成します。Overview および Advanced configuration をクリックして、各アプリケーションの情報を表示します。アプリケーションリソースの詳細は、『アプリケーションの管理』を参照してください。

1.2.7.1. Pod の正常性表示

全クラスターの Pod の正常性を表示するには、Heat マップを展開します。

Show details をクリックしてマップを表示します。色分けされたボックスのサイズでは、クラスター上のノード数を表します。カーソルをボックスにかざすと、クラスターの応答時間が表示されます。

1.2.8. ガバナンスおよびリスクダッシュボード

ガバナンスおよびリスクダッシュボードで、ポリシーとポリシーコントローラーを作成して管理します。詳細は「ガバナンスおよびリスク」を参照してください。

1.3. コンソールでの検索

Red Hat Advanced Cluster Management for Kubernetes では、検索機能でクラスター全体のリソースを視認できるようにします。検索では Redisgraph (インメモリーデータベース) を使用して、Kubernetes リソースおよびリソース関係を保存します。ストレージクラスおよびストレージサイズを変更する必要がある場合は、searchcustomization カスタムリソース (CR) を作成して、検索永続性のストレージ設定を定義できます。

1.3.1. 検索カスタマイズ

Red Hat Advanced Cluster Management をインストールすると、インメモリーデータをファイルシステムに永続化するように製品が設定されます。StatefulSet search-redisgraph は Redisgraph Pod をデプロイし、これは persist という名前の永続ボリュームをマウントします。クラスターにデフォルトのストレージクラスが定義されている場合、検索コンポーネントはデフォルトのストレージクラスに 10Gi の Persistent Volume Claim (永続ボリューム要求、PVC) を作成します。デフォルトのストレージクラスがクラスターに存在しない場合は、検索によりインデックスが空のディレクトリー (emptyDir) に保存されます。

searchcustomization CR を作成して、検索用のストレージ設定をカスタマイズできます。検索カスタマイズは namespace にスコープ指定され、検索がハブクラスターにインストールされている場所にあります。検索カスタマイズ CR の以下の例を確認してください。

apiVersion: search.open-cluster-management.io/v1alpha1
kind: SearchCustomization
metadata:
  name: searchcustomization
  namespace: open-cluster-management
spec:
  persistence: true
  storageClass: gp2
  storageSize: 12Gi

以下のコマンドを実行して、検索カスタマイズ CRD を表示します。

oc get crd searchcustomizations.search.open-cluster-management.io -o yaml

カスタマイズ CR の persistence フラグを false に更新し、永続性を無効にすると、検索インデックスのファイルシステムへの保存がオフになります。永続性のステータスは、検索 Operator (searchoperator) CR から取得されます。以下のコマンドを実行して検索 Operator CR を表示します (oc get searchoperator searchoperator -o yaml)。

1.3.2. コンソールでのクエリー

検索ボックス にテキスト値を入力すると、名前や namespace などのプロパティーからのその値が含まれる結果が表示されます。空白のスペースを含む値の検索はできません。

検索結果をさらに絞り込むには、検索にプロパティーセレクターを追加します。プロパティーに関連する値を組み合わせて、検索範囲をより正確に指定できます。たとえば、cluster:dev red と検索すると、dev クラスター内で "red" の文字列と一致する結果が返されます。

以下の手順に従って、検索でクエリーを実行します。

  1. ナビゲーションメニューの 検索 をクリックします。
  2. Search box に単語を入力すると、検索機能で、対象の値が含まれたリソースを見つけ出します。

    • リソースを検索すると、元の検索結果に関連する他のリソースが表示されるので、リソースがシステム内にある他のリソースとどのように対話するのかを視覚的に確認できます。
    • 検索すると、各クラスターと、検索したリソースが返され、一覧表示されます。ハブ クラスターのリソースの場合には、クラスター名は local-cluster として表示されます。
    • 検索結果は、kind でグループ化され、リソースの kind ごとに表でグループ化されます。
    • 検索オプションはクラスターオブジェクトにより異なります。特定のラベルで結果を絞り込むことができます。ラベルのクエリー時の検索は、大文字と小文字が区別されます。以下の 名前、namespace、ステータス、その他のリソースフィールドの例を参照してください。自動補完では、補完候補を表示して検索を絞り込むことができます。以下の例を参照してください。

      • kind:pod など、フィールド 1 つを検索すると、Pod リソースすべてが返されます。
      • kind:pod namespace:default など、複数のフィールドを検索すると、デフォルトの namespace にある Pod が返されます。

    注記:

    • >, >=, <, <=, != などの文字を使用して、条件を指定した検索も可能です。
    • 複数の値を含む複数のプロパティーセレクターを検索すると、クエリーされた値のいずれかを返します。以下の例を参照してください。

      • kind:pod name:a と検索すると、a という名前の Pod が返されます。
      • kind:pod name:a,b と検索すると、a または b という名前の Pod が返されます。
      • kind:pod status:!Running を検索すると、ステータスが Running ではない Pod リソースすべてが返されます。
      • kind:pod restarts:>1 を検索すると、最低でも 2 回再起動した全 Pod が返されます。
  3. 検索を保存する場合は、Save search アイコンをクリックします。

Red Hat Advanced Cluster Management for Kubernetes コンソールの詳細は、「Web コンソール」を参照してください

1.4. Visual Web ターミナル

Red Hat Advanced Cluster Management for Kubernetes Visual Web ターミナルは、テクノロジープレビュー 機能です。Visual Web ターミナルを使用すると、クラスター全体で多くのコマンドを実行できます。コンソールを完全に終了せずにコマンドを実行して、出力を取得します。標準のターミナルでできる操作と同様に、複数のコマンドを実行できます。

Visual Web ターミナルでは、クラスターのリソースデータを返すコマンドは、標準のターミナルで表示されるプレーンテキストではなく、インタラクティブな表形式で視覚的に表示されます。データが表示され、行をクリックすると、そのリソースの詳細が表示されます。

デフォルトでは、Visual Web ターミナルには、ハブクラスター向けの Red Hat Advanced Cluster Management でサポートされる最新の OpenShift Container Platform バージョンと同等の ockubectl、および helm CLI バイナリーのバージョンが含まれます。

以下のコマンドを実行してバージョンを確認できます。

  • oc version
  • kubectl version
  • helm version

注記:

Visual Web ターミナルに表示される情報は、ユーザーのパーミッションにより限定されます。コマンドを実行すると、表示権限を持つアイテムのみが表示されます。

同時に実行するセッションが 10 個以上ある場合に、コマンドの実行時に応答時間が遅くなる可能性があります。

Visual Web ターミナルは、ハブクラスターコンソールでログイン済みのクラウドに接続されます。

1.4.1. セッションの開始

Visual Web ターミナルにアクセスするには、以下の手順を実行します。

  1. コンソールにログインします。
  2. コンソールの ヘッダー から Visual Web ターミナル アイコンを選択します。
  3. 新しいタブで開くか、現在のタブで開くか選択します。
  4. 入力フィールドでコマンドの実行を開始します。たとえば、oc または kubectl コマンドの実行を開始すると、視覚的な出力が返されます。
  5. オプション: getting started コマンドを選択して、About ページなどを表示するか、入力フィールドにコマンドを打ち込みます。
  6. オプション: デフォルトの namespace を変更できます。ページの一番下のステータスバーにある @default をクリックして、namespace を表示するコマンドを実行します。出力を確認し、表の中から 1 行クリックして、別の namespace を設定します。
  7. サポート対象のコマンド一覧 を使用して、kubectl または oc を使用して実行可能なコマンドについて確認します。

1.4.2. サポート対象のコマンド一覧

以下の表は、Visual Web ターミナルがサポートするコマンドタイプの情報と例を示しています。

コマンド説明

!!

1 つ前のコマンドを再度実行します。

!!

bash コマンド

以下の基本的な bash コマンドを実行します (base64, basename, cat, cksum, cp, cut, date, dirname, echo, grep, head, ls, mkdir, mv, printf, readlink, rm, sed, tail, touch, uname, vi, and vim)

mkdir new_directory

cd

ローカルファイルシステムの現在の作業ディレクトリーに移動します。

cd dir_name

clear

以前のコマンドと出力の画面をクリアします。

clear

export

コマンドの出力を外部ファイルにエクスポートします。

export search search_criteria

helm

サポートされる helm コマンドを実行します。ヒント: Helm コマンドの情報は、Helm ドキュメントの helm commands トピックを参照してください。

helm list --chart-name

help (getting started のエイリアス)

サイドパネルの Visual Web ターミナルでサポートされているコマンドの追加情報を表示します。

help

history

現行セッションで実行された、以前のコマンドを 25 個表示します。ヒント: コマンドの最後に検索基準を追加して、検索内容を絞り込むことができます。たとえば、history help は、文字列 help が含まれる、直前のコマンド 25 個を表示します。

history

kubectl または k

サポート対象の kubectl (または略式 k) コマンドを実行します。ヒント: kubectl コマンドに関する詳細は、Kubernetes CLI reference を参照してください。

kubectl get pods

oc

Red Hat OpenShift oc コマンドを実行します。ヒント: oc コマンドの詳細は、Red Hat OpenShift CLI Operations を参照してください。

oc get svc

search

指定した検索フィルターとパラメーターに一致する Kubernetes リソースを検索します。

search pod

savedsearches

Search ページで作成して保存した検索内容を表示します。

savedsearches ヒント: savedsearches コマンドの後ろに文字列を指定して、返されるデータを絞り込むことができます。たとえば、savedsearches projectA では、projectA の文字列を含む、保存済みの検索が表示されます。

sleep

セッション中にアクティビティーを一時停止します。注記: 一時停止する期間 (秒数) を指定する sleepTime パラメーターが必要です。

sleep 20

themes

インターフェースのコントラストテーマオプションを表示します。light または dark のどちらかを設定できます。

themes

1.4.3. Visual Web ターミナルでの検索

Visual Web ターミナルの検索機能は、すべてのクラスター上にあるリソースを可視化します。

ロールベースのアクセス制御レベルの割り当てをもとにしたリソースのみが検索されます。検索クエリーを保存して他のユーザーと共有する場合には、返される結果は、対象のユーザーのアクセスレベルにより異なります。

  1. Visual Web ターミナルセッションを開始します。
  2. Visual Web ターミナルのコマンドエントリーフィールドに、search と入力します。search コマンドを実行すると、Visual Web ターミナルにより、検索機能が利用可能かどうかが確認されます。検索機能を利用できない場合には、メッセージで、この機能がインストールされていないか、単に利用できないかが示されます。インストールされていても利用できない場合は、ネットワークの問題の可能性があります。
  3. search コマンドの後ろにスペースを追加します。検索に使用できるフィルターのリストが表示されます。フィルターの一覧は、お使いの環境やロールパーミッションで利用可能なリソースにより異なるので、空白の場合があります。
  4. 一覧からフィルターを 1 つを選択します。選択したフィルターがコマンドラインの検索条件に追加され、選択内容の次のレベルのフィルターが表示されます。ヒント: 一覧からフィルターを選択するのではなく、search コマンドの後に文字列を入力することも可能です。
  5. オプション: 必要なフィルターがコマンドにすべて含まれるまで、各フィルターエントリーの後に空白を 1 つ入力して、フィルターを追加していきます。
  6. 検索条件を追加し終えたら、Enter を押して検索を実行します。

結果を特定のフィールドで絞り込むことができます。以下の例を参照してください。

  • kind:pod など、フィールド 1 つを検索すると、Pod リソースすべてが返されます。
  • kind:pod namespace:default など、複数のフィールドを検索すると、デフォルトの namespace にある Pod が返されます。

また、(>, >=, <, <=,!=) などの文字を使用して、条件を指定した検索も可能です。

以下の例を参照してください。

  • kind:pod status:!Running を検索すると、ステータスが Running ではない Pod リソースすべてが返されます。
  • kind:pod restarts:>1 を検索すると、最低でも 2回再起動した全 Pod が返されます。

検索では、検索要求の条件に合致するリソースと、関連のリソースを表示するリンクが返されます。全リソースを表示すると、リソースが、システム内の他のリソースとどのように対話しているかが視覚的に確認できます。

検索結果は、kind でグループ化され、リソースの kind ごとに表でグループ化されます。行と列のヘディングを選択して、表の中のデータを整理できます。

コンソールで保存した検索は、savedsearches コマンドを入力して、実行する検索を選択すると、使用できます。

1.5. クラスターラベルの管理

クラスターにラベルを追加してグループリソースを選択します。詳細は、「Labels and Selectors」を参照してください。

クラスターの新規ラベルの追加、既存ラベルの削除、既存ラベルの編集が可能です。ラベルを管理するには、以下の手順を実行します。

  1. ナビゲーションメニューから Automate infrastructure > Clusters をクリックします。
  2. Clusters テーブルでクラスターを探します。
  3. 他のオプションを表示するには、Actions アイコンをクリックします。
  4. Edit labels をクリックします。
  5. Edit labels ダイアログボックスで、ラベルを入力します。入力内容は Key=Value` のようになります。
  6. Enter または space を押して別のラベルを追加します。
  7. Add をクリックします。Add ボタンをクリックすると、ラベルは保存されます。
  8. 完了したら、Done をクリックしてラベルの編集ダイアログを閉じます。

    • 既存のラベルを削除するには、リストのラベルの横にある Remove アイコンをクリックします。
    • Remove アクションを元に戻す場合は、Remove をクリックした後に表示される Deleted アイコンをクリックします。
    • 既存のラベルを更新する場合は、同じキーに別の値を使用して、新規ラベルを追加すると、新しい値にキーを再割り当てすることができます。

注記: クラスターの詳細ページからクラスターラベルを編集することもできます。ナビゲーションメニューから Automate infrastructure > Clusters をクリックします。Clusters ビューで、クラスターの名前をクリックしてから、Actions > Edit labels の順にクリックし、クラスターの詳細ページにアクセスします。

Red Hat Advanced Cluster Management for Kubernetes コンソールの詳細は、「Web コンソール」を参照してください