Red Hat build of Cryostat Operator を使用した Cryostat の設定

手順

1. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。
   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

2. Create Cryostat パネルで、enableCertManager プロパティーを設定するには、次のいずれかのオプションを選択します。

   1. Form ビューを使用する場合は、以下を実行します。

      1. Form view ラジオボタンをクリックします。

      2. Enable cert-manager Integration を有効にするスイッチを false に設定し、Name フィールドに値を入力します。

         図1.1 Enable cert-manager Integration スイッチを false に切り替える

         

   2. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. YAML ファイルの spec: キーセットで、enableCertManager プロパティーを false に変更します。

         YAML ファイルへの spec: キーセット設定例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           enableCertManager: false
         --

         Copy to Clipboard

3. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
4. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。

検証

1. Operator details ページの Cryostat タブから Cryostat インスタンスを選択します。
2. Cryostat Conditions テーブルに移動します。

3. TLSSetupComplete 条件が true に設定されていること、およびこの条件の Reason 列が CertManagerDisabled に設定されていることを確認します。これは、enableCertManager プロパティーを false に設定したことを示します。

   図1.2 TLSSetupComplete 条件が true に設定されていることを示す例

   

手順

1. デフォルトのイベントテンプレートをダウンロードするには、Cryostat Web コンソールに移動し、Events メニューから Downloads をクリックします。

   注記

   イベントテンプレートは XML 形式で、ファイル名拡張子は .jfc です。

2. オプション: カスタムイベントテンプレートが必要な場合は、テキストエディターまたは XML エディターを使用して、ダウンロードしたデフォルトのイベントテンプレートを編集し、ニーズに合わせてテンプレートを設定します。
3. CLI で oc login コマンドを入力して、Red Hat OpenShift Web コンソールにログインします。

4. CLI で次のコマンドを入力して、イベントテンプレートから ConfigMap リソースを作成します。Cryostat アプリケーションをデプロイするパスでコマンドを実行する必要があります。このリソースを使用して、Cryostat インスタンスを実行するクラスター内にあるイベントテンプレートファイルを保存できます。

   CLI を使用して ConfigMap リソースを作成する例

   $ oc create configmap <template_name> --from-file=<path_to_custom_event_template>

   Copy to Clipboard

5. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。
   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

6. Create Cryostat パネルで、XML 形式のイベントテンプレートをリソースにアップロードするには、次のいずれかのオプションを選択します。

   1. Form ビューを使用する場合は、以下を実行します。

      1. Form view ラジオボタンをクリックします。
      2. Cryostat インスタンスの Event Templates セクションに移動します。
      3. Event Templates メニューから、Add Event Template をクリックします。Red Hat OpenShift コンソールで Event Templates セクションが開きます。

      4. Config Map Name ドロップダウンリストから、イベントテンプレートを含む ConfigMap リソースを選択します。

         図1.3 Cryostat インスタンスのイベントテンプレートオプション

         
      5. Filename フィールドに、ConfigMap に含まれている .jfc ファイルの名前を入力します。

   2. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. eventTemplates プロパティーにカスタムイベントテンプレートを指定します。このプロパティーは、Cryostat Operator が ConfigMap を指すようにして、Cryostat Operator がイベントテンプレートを読み取れるようにします。

         eventTemplates プロパティーにカスタムイベントテンプレートを指定する例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           eventTemplates:
           - configMapName: custom-template1
             filename: my-template1.jfc
           - configMapName: custom-template2
             filename: my-template2.jfc
         --

         Copy to Clipboard

         重要

         configMapName ドロップダウンリストから、Cryostat または Cluster Cryostat インスタンスに関連付けられている ConfigMap の名前を選択する必要があります。さらに、filename フィールドに ConfigMap に関連付けられたキーを指定する必要があります。

7. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
8. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。

検証

1. Cryostat Web コンソールで、メニューから Events をクリックします。Web コンソールで Authentication Required ウィンドウが開いた場合は、認証情報を入力して Save をクリックします。

2. Event Templates タブで、使用可能なイベントテンプレートのリストにカスタムイベントテンプレートが表示されるかどうかを確認します。

   図1.4 Event Templates タブにリストされているカスタムイベントテンプレートの例

   

手順

1. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。
   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

2. Create Cryostat パネルで、TLS 証明書を設定するには、次のいずれかのオプションを選択します。

   1. Form ビューを使用する場合は、以下を実行します。

      1. Form view ラジオボタンをクリックします。
      2. Name フィールドに、作成する Cryostat のインスタンスの名前を指定します。

      3. Trusted TLS Certificates オプションをデプロイメントし、Add Trusted TLS Certificate をクリックします。オプションのリストが Red Hat OpenShift Web コンソールに表示されます。

         図1.5 信頼できる TLS 証明書オプション

         

      4. Secret Name リストから TLS シークレットを選択します。Certificate Key フィールドはオプションです。

         注記

         Remove Trusted TLS Certificate をクリックすると、TLS 証明書を削除できます。

   2. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. trustedCertSecrets 配列の secretName プロパティーで、Cryostat アプリケーションと同じ namespace にあるシークレットを指定します。

         trustedCertSecrets 配列でシークレットを指定する例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           trustedCertSecrets:
           - secretName: my-tls-secret
         --

         Copy to Clipboard

      3. オプション: certificateKey プロパティー値をアプリケーションの X.509 証明書ファイル名に変更します。値を変更しない場合、certificateKey プロパティーはデフォルトで tls.crt になります。

         certificateKey プロパティーの値を変更する例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           trustedCertSecrets:
           - secretName: my-tls-secret
             certificateKey: ca.crt
         --

         Copy to Clipboard

3. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
4. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。

検証

1. CLI で次のコマンドを実行して、すべてのアプリケーション Pod が Cryostat Pod と同じ OpenShift クラスター namespace に存在することを確認します。

   $ oc get pods

   Copy to Clipboard
2. Cryostat インスタンスの Web コンソールにログインします。
3. Cryostat インスタンスの Dashboard メニューで、Target リストから target JVM を選択します。

4. Cryostat Web コンソールのナビゲーションメニューで、Recordings を選択します。Authentication Required dialog ウィンドウで、シークレットの認証情報を入力し、Save を選択して、ターゲット JVM に認証情報を提供します。

   注記

   選択したターゲットで JMX 接続のパスワード認証が有効になっている場合は、接続のプロンプトが表示されたら、ターゲット JVM の JMX クレデンシャルを指定する必要があります。

   Cryostat は、認証された JMX 接続を介してアプリケーションに接続します。これで、Recordings 機能および Events 機能を使用して、アプリケーションの JFR データを監視できます。

手順

1. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。
   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

2. Create Cryostat パネルで、Cryostat アプリケーションのストレージ設定を変更するには、次のいずれかのオプションを選択します。

   1. Form ビューを使用する場合は、以下を実行します。

      1. Form view ラジオボタンをクリックします。
      2. Storage Options セクションに移動し、Name フィールドに値を入力します。
      3. Storage Options をデプロイメントし、Empty Dir をクリックします。オプションの拡張された選択肢が Red Hat OpenShift Web コンソールで開きます。

      4. Enabled スイッチを true に設定します。

         図1.6 Empty Dir スイッチを true に設定した例

         

   2. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. YAML ファイルの spec: キーセットで、storageOptions 定義を追加し、emptyDir プロパティーを true に設定します。

         emptyDir プロパティーが true として設定されていることを示す例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           storageOptions:
             emptyDir:
               enabled: true
               medium: "Memory"
               sizeLimit: 1Gi
         --

         Copy to Clipboard

      3. オプション:medium プロパティーと sizeLimit プロパティーの値を設定します。
3. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
4. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。

手順

1. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。
   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

2. Create Cryostat パネルで、disableNetworkPolicyCreation プロパティーを設定するには、次のいずれかのオプションを選択します。

   1. Form ビューを使用する場合は、以下を実行します。

      1. Form view ラジオボタンをクリックします。
      2. Network Policies セクションを展開し、coreConfig を展開します。

      3. Disable Network Policy creation スイッチを true に設定します。

         図1.8 Disable Network Policy creation スイッチを true に切り替える

         

   2. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. YAML ファイルの spec: キーセットの networkPolicies:coreConfig の下で、disableNetworkPolicyCreation プロパティーを true に変更します。

         YAML ファイルへの spec: キーセット設定例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           networkPolicies:
             coreConfig:
               disableNetworkPolicyCreation: true
         --

         Copy to Clipboard

3. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
4. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。

手順

1. Cryostat インスタンスの作成を開始する場合は、次の手順を実行します。

   1. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
   2. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。
   3. Operator details ページで、Details タブをクリックします。

   4. Provided APIs セクションで Cryostat を選択し、Create instance をクリックします。

      注記

      Cryostat Operator は、Report サイドカー Pod のサービスアカウントを作成しません。代わりに、これらの Pod は独自の namespace でデフォルトのサービスアカウントを使用します。

2. Create Cryostat パネルで、セキュリティーコンテキストを設定するには、次のいずれかのオプションを選択します。

   1. YAML ビューを使用する場合は、以下を実行します。

      1. YAML view のラジオボタンをクリックします。

      2. spec: 要素から、セキュリティー要件に一致するように securityOptions プロパティーおよび reportOptions プロパティーを編集します。

         セキュリティーコンテキストの設定例

         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           securityOptions:
             podSecurityContext:
               runAsNonRoot: true
               seccompProfile:
                 type: RuntimeDefault
             coreSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
               runAsUser: 1001
             dataSourceSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
             grafanaSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
           reportOptions:
             replicas: 1
             podSecurityContext:
               runAsNonRoot: true
               seccompProfile:
                 type: RuntimeDefault
             reportsSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
               runAsUser: 1001

         Copy to Clipboard

   2. Form ビューを使用する場合は、以下を実行します。

      1. *Form view" ラジオボタンをクリックします。

      2. Advanced Configurations を展開して、Red Hat OpenShift Web コンソールで追加のオプションを開きます。

         図2.1 詳細設定メニューオプション

         
      3. Core Security Context を展開します。使用可能なオプションのリストから、セキュリティーコンテキストの設定を定義します。

      4. 次の各セキュリティーコンテキストを順番に展開し、必要に応じて設定を定義します。

         • Auth プロキシーセキュリティーコンテキスト
         • データソースセキュリティーコンテキスト
         • データベースセキュリティーコンテキスト
         • Grafana セキュリティーコンテキスト
         • Pod セキュリティーコンテキスト
         • ストレージセキュリティーコンテキスト

      5. オプション: Report Generator サービスを使用している場合は、このサービスのセキュリティーコンテキストを設定することもできます。この場合、Report Options > Advanced Configuration > Security Options を展開します。次に、必要に応じて Reports Security Context および Pod Security Context 設定を展開して定義します。

         図2.2 レポートジェネレーターセキュリティーコンテキスト

         
3. この Cryostat インスタンスのカスタムリソース (CR) で他のプロパティーを設定する場合は、これらのプロパティーの詳細は、このドキュメントの他のセクションを参照してください。
4. この Cryostat インスタンスの作成を終了する場合は、Create をクリックします。