1.4. イベントテンプレートのカスタマイズ

手順

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>

5. Red Hat OpenShift Web コンソールで、Operators > Installed Operators の順にクリックします。
6. 使用可能な Operator のリストから、Red Hat build of Cryostat を選択します。

7. Operator details ページの Details タブで、Cryostat または Cluster Cryostat インスタンスを作成します。

   1. Provided APIs セクションで、Cryostat および Cluster Cryostat カスタムリソース (CR) が利用可能です。以下のオプションのいずれかを選択します。

      • 単一 namespace の Cryostat インスタンスを作成するには、Cryostat を選択してから Create instance をクリックします。
      • 複数 namespace の Cryostat インスタンスを作成するには、Cluster Cryostat を選択してから Create instance をクリックします。

8. 次のいずれかのオプションを選択して、XML 形式のイベントテンプレートをリソースにアップロードします。

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

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

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

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

         
      4. Filename フィールドに、ConfigMap に含まれている .jfc ファイルの名前を入力します。
      5. カスタムイベントテンプレートを使用して Cryostat または Cluster Cryostat インスタンスを生成するには、Create をクリックします。

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

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

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

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

         重要

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

         Red Hat build of Cryostat Operator は、カスタムイベントテンプレートを XML ファイルとして Cryostat アプリケーションに提供できるようになりました。Cryostat Web コンソールで、カスタムイベントテンプレートがデフォルトイベントテンプレートと一緒に開きます。

検証

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

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

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