第2章 Red Hat build of Cryostat Operator を使用した Red Hat OpenShift への Cryostat のインストール
Operator Lifecycle Manager (OLM) を使用して、Red Hat build of Cryostat Operator を Red Hat OpenShift クラスターのプロジェクトにインストールできます。Red Hat build of Cryostat Operator を使用すると、シングル namespace またはマルチ namespace の Cryostat インスタンスを作成できます。これらのインスタンスは、Red Hat OpenShift Web コンソールからアクセスできる GUI を使用して制御できます。
Red Hat build of Cryostat Operator のサブスクリプションを Cryostat 2.0 から Cryostat 2.4 に更新する場合は、更新チャネルを stable-2.0 から stable に変更する必要があります。
前提条件
- OpenShift Container Platform 4.11 以降のクラスターを作成している。
- Red Hat build of Cryostat Operator をプロジェクトにインストールする権限を持つ Red Hat OpenShift ユーザーアカウントを作成している。
- クラスターに Operator Lifecycle Manager (OLM) がインストールされている。
Red Hat OpenShift の cert-manager Operator を使用して cert-manager をインストールしている。
- OpenShift Container Platform 4.11 以降を使用している場合は、Red Hat OpenShift の cert-manager Operator をインストールできます。詳細は、Red Hat OpenShift の cert-manager Operator を参照してください。
- Red Hat OpenShift Web コンソールを使用して Red Hat OpenShift にログインしている。
手順
- ブラウザーで、Web コンソールを使用して Home > Projects に移動します。
- Red Hat build of Cryostat をインストールするプロジェクトの名前を選択します。
Red Hat build of Cryostat Operator をインストールします。
- Web コンソールのナビゲーションメニューで、Operators > OperatorHub に移動します。
- リストから Red Hat build of Cryostat Operator を選択します。画面上部の検索ボックスを使用すると、Red Hat build of Cryostat Operator を検索できます。
Install をクリックし、プロジェクトに Red Hat build of Cryostat Operator をインストールします。
Red Hat OpenShift Web コンソールで、Cryostat カスタムリソース (CR) を作成するように求められます。
注記複数の namespace に対して有効な Cryostat インスタンスをインストールする場合は、Installation mode エリアで All namespaces on the cluster (default) ラジオボタンをクリックします。
CR は手動または自動で作成できます。CR を手動で作成する場合は、ステップ 4 を参照してください。CR を自動的に作成する場合は、ステップ 5 を参照してください。
CR を手動で作成する場合は、以下の手順を実行します。
Web コンソールを使用して Operators > Installed Operators に移動し、インストール済み Operator のリストから Red Hat build of Cryostat Operator を選択します。
図2.1 インストール済み Operator のリストでの Red Hat build of Cryostat Operator の表示
- Details タブをクリックします。
シングル namespace の Cryostat インスタンスを作成するには、Provided APIs セクションに移動します。次に、Cryostat で Create instance をクリックします。
注記複数の namespace に対して有効な Cryostat インスタンスを作成する場合は、Provided APIs セクションで Cluster Cryostat を選択し、Create instance をクリックします。Cluster Cryostat API には、Cryostat アプリケーションとその関連コンポーネントのデプロイメントを制御する設定オプションがあります。詳細は、複数の namespace での Cryostat の作成 を参照してください。
図2.2 Red Hat build of Cryostat Operator によって提供される Cryostat API の選択
- Form view または YAML view のラジオボタンをクリックします。YAML 設定ファイルに情報を入力する場合は、YAML view をクリックします。
- 作成する Cryostat のインスタンスの名前を指定します。
オプション: ラベルフィールドで、デプロイするオペランドワークロードのラベルまたはアノテーションを指定します。
デプロイメントに追加するその他の設定オプションも指定できます。
図2.3 Web コンソールでのフォームを使用した Cryostat インスタンスの作成
あるいは、フォームを使用する代わりに、YAML テンプレートを使用してインスタンスを作成し、追加の設定オプションを指定することもできます。
図2.4 Web コンソールでの YAML テンプレートを使用した Cryostat インスタンスの作成
自動プロンプトオプションを使用して CR を作成する場合は、プロンプトの指示に従い、次の手順を実行します。
- Form view または YAML view のラジオボタンをクリックします。YAML 設定ファイルに情報を入力する場合は、YAML view をクリックします。
- 作成する Cryostat のインスタンスの名前を指定します。
オプション: ラベルフィールドで、デプロイするオペランドワークロードのラベルまたはアノテーションを指定します。
デプロイメントに追加するその他の設定オプションも指定できます。
図2.5 Web コンソールでのフォームを使用した Cryostat インスタンスの作成
あるいは、フォームを使用する代わりに、YAML テンプレートを使用してインスタンスを作成し、追加の設定オプションを指定することもできます。
図2.6 Web コンソールでの YAML テンプレートを使用した Cryostat インスタンスの作成
Create をクリックして、Cryostat インスタンスの作成プロセスを開始します。
Cryostat インスタンスのすべてのリソースの準備が完了しなければアクセスできません。
検証
- Web コンソールのナビゲーションメニューで、Operators をクリックし、Installed Operators をクリックします。
- インストール済み Operator のテーブルから、Red Hat build of Cryostat Operator を選択します。
Cryostat タブを選択します。
Cryostat インスタンスが、インスタンスのテーブルで開き、次の条件が一覧表示されます。
-
TLSSetupCompleteはtrueに設定されている。 -
MainDeploymentAvailableはtrueに設定されている。 オプション: レポートジェネレーターサービスを有効にした場合、
ReportsDeploymentAvailableが表示され、trueに設定されている。図2.7 OpenShift の Cryostat インスタンスの Status 列で True に設定された条件の例
-
オプション: Cryostat テーブルから Cryostat インスタンスを選択します。Cryostat Conditions テーブルに移動すると、各条件の詳細情報を確認できます。
図2.8 各条件とその基準をリストした Cryostat Conditions 表の例
2.1. 複数の namespace での Cryostat の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat build of Cryostat Operator は、複数の namespace で機能する Cryostat インスタンスを作成できる Cluster Cryostat API を提供します。
前提条件
- OpenShift Container Platform 4.11 以降のクラスターを作成している。
- Red Hat build of Cryostat Operator をプロジェクトにインストールする権限を持つ Red Hat OpenShift ユーザーアカウントを作成している。
- クラスターに Operator Lifecycle Manager (OLM) がインストールされている。
Red Hat OpenShift の cert-manager Operator を使用して cert-manager をインストールしている。
- OpenShift Container Platform 4.11 以降を使用している場合は、Red Hat OpenShift の cert-manager Operator をインストールできます。詳細は、Red Hat OpenShift (OpenShift Container Platform) の cert-manager Operator を参照してください。
- Red Hat OpenShift Web コンソールを使用して Red Hat OpenShift にログインしている。
手順
- ブラウザーで、Web コンソールを使用して Home > Projects に移動します。
- Red Hat build of Cryostat Operator をインストールするプロジェクトの名前を選択します。
Red Hat build of Cryostat Operator をインストールします。
Red Hat OpenShift Web コンソールで、Cryostat カスタムリソース (CR) を作成するように求められます。
CR を作成するには、以下の手順を実行します。
Web コンソールを使用して Operators > Installed Operators に移動し、インストール済み Operator のリストから Red Hat build of Cryostat Operator を選択します。
図2.9 インストール済み Operator のリストでの Red Hat build of Cryostat Operator を表示
- Details タブをクリックします。
Cryostat のマルチ namespace インスタンスを作成するには、Provided APIs セクションに移動します。次に、Cluster Cryostat で Create instance をクリックします。
図2.10 Red Hat build of Cryostat Operator によって提供される Cluster Cryostat API の選択
- Form view または YAML view のラジオボタンをクリックします。YAML 設定ファイルに情報を入力する場合は、YAML view をクリックします。
作成する Cluster Cryostat インスタンスの一意の名前を指定します。
注記Cluster Cryostat インスタンスに指定する名前が一意であり、Cluster Cryostat インスタンスのインストール namespace またはターゲット namespace ですでに作成されているシングル namespace の Cryostat インスタンスの名前と競合しないことを確認してください。
オプション: ラベルフィールドで、デプロイするオペランドワークロードのラベルまたはアノテーションを指定します。
デプロイメントに追加するその他の設定オプションも指定できます。
図2.11 Web コンソールでのフォームを使用した Cluster Cryostat インスタンスの作成
Install Namespace フィールドで、Cryostat のこのインスタンスをインストールする namespace を選択します。
ヒントRed Hat build of Cryostat Operator は、Cryostat アプリケーションと比較してより多くの権限セットを使用します。また、Cryostat にはターゲットワークロードよりも多くの権限がある場合があります。したがって、セキュリティーを最適化するために、Red Hat build of Cryostat Operator がインストールされている場所およびターゲットワークロードが配置されている場所とは異なる namespace に Cryostat インスタンスをインストールしてください。
Target Namespaces フィールドで、Cryostat のこのインスタンスにアクセスして操作することを許可するワークロードの namespace を選択します。必要に応じて、Cryostat をインストールしたのと同じ namespace を選択することも、別の namespace を選択することもできます。さらに namespace を追加するには、+Add Target Namespace をクリックします。
重要Cryostat インスタンスにアクセスできるユーザーは、その Cryostat インスタンスに認識される namespace 内のすべてのターゲットアプリケーションにアクセスできます。したがって、マルチ namespace の Cryostat インスタンスをデプロイする場合は、監視対象にどの namespace を選択するか、Cryostat をどの namespace にインストールするか、およびどのユーザーにアクセスを許可するかを考慮する必要があります。
あるいは、フォームを使用する代わりに、YAML テンプレートを使用してインスタンスを作成し、追加の設定オプションを指定することもできます。
図2.12 Web コンソールでの YAML テンプレートを使用した Cluster Cryostat インスタンスの作成
Create をクリックして、Cryostat のマルチ namespace インスタンスの作成プロセスを開始します。
インスタンスにアクセスするには、Cluster Cryostat インスタンスのすべてのリソースの準備が完了するまで待つ必要があります。
検証
- Web コンソールのナビゲーションメニューで、Operators > OperatorHub に移動します。
- インストール済み Operator のテーブルから、Red Hat build of Cryostat Operator を選択します。
Cluster Cryostat タブをクリックします。
Cryostat インスタンスが、インスタンスのテーブルで開き、次の条件が一覧表示されます。
-
TLSSetupCompleteはtrueに設定されている。 -
MainDeploymentAvailableはtrueに設定されている。 オプション: レポートジェネレーターサービスを有効にした場合、
ReportsDeploymentAvailableが表示され、trueに設定されている。図2.13 OpenShift の Cluster Cryostat インスタンスの Status 列で True に設定された条件の例
-
オプション: Cluster Cryostat テーブルから、Cryostat インスタンスを選択します。Conditions テーブルに移動して、各条件の詳細情報を確認します。
図2.14 各条件とその基準をリストした Cryostat Conditions 表の例
関連情報
- さまざまなクラスター設定で Cryostat をセットアップするためのベストプラクティス (Red Hat ナレッジベース)
- Web コンソールを使用して Cryostat にアクセスする