Fuse on OpenShift の管理

1. Web ブラウザーで、cluster admin 権限を持つユーザーとして OpenShift コンソールにログインします。
2. Operators をクリックした後、OperatorHub をクリックします。
3. 検索フィールドウインドウに Fuse Console と入力し、Operator のリストを絞り込みます。
4. Fuse Console Operator をクリックします。

5. Fuse Console Operator インストールウィンドウで Install をクリックします。

   Create Operator Subscription フォームが表示されます。

   • Update Channel には 7.10.x を選択します。

   • Installation Mode では、デフォルト (クラスターの特定の namespace) を受け入れます。

     operator のインストール後に Fuse Console をデプロイする場合、クラスター上のすべての namespace でアプリケーションを監視するか、Fuse Console operator がインストールされた namespace のみでアプリケーションを監視するかを選択できる点に注意してください。

   • Installed Namespace には、Fuse Console Operator をインストールする namespace を選択します。

   • Update Approval では、Automatic または Manual を選択し、Fuse Console の更新が OpenShift によってどのように対処されるかを設定します。

     • Automatic (自動) 更新を選択した場合、新しいバージョンの Fuse Console Operator が使用できるようになると、人的な介入なしで OpenShift Operator Lifecycle Manager (OLM) によって、Fuse Console の稼働中のインスタンスが自動的にアップグレードされます。
     • Manual (手動) 更新を選択した場合、Operator の新しいバージョンが使用できるようになると、OLM によって更新リクエストが作成されます。クラスター管理者は、更新リクエストを手動で承認して、Fuse Console Operator を新しいバージョンに更新する必要があります。

6. Install をクリックします。

   OpenShift によって、Fuse Console Operator が現在の namespace にインストールされます。

7. インストールを確認するには、Operators をクリックした後、Installed Operators をクリックします。Operator のリストに Fuse Console が表示されます。

8. OpenShift Web コンソールで Fuse Console をデプロイするには、以下を行います。

   1. Installed Operators のリストで、Name 列の Fuse Console をクリックします。

   2. Provided APIs の Operator Details ページで、Create Instance をクリックします。

      設定のデフォルト値を使用するか、任意でデフォルト値を編集します。

      Fuse Console のパフォーマンスを向上する必要がある場合 (高可用性環境など)、Replicas で Fuse Console に割り当てられた Pod 数を増やすことができます。

      Rbac (ロールベースアクセス制御) では、デフォルトの RBAC 動作をカスタマイズする場合や、Fuse Console Operator をインストールした namespace に ConfigMap ファイルがすでに存在する場合にのみ、config Map フィールドに値を指定します。RBAC の詳細は、Role-based access control for the Fuse Console on OpenShift 4.x を参照してください。

      Nginxについては、Performance tuning for Fuse Console Operator installation を参照してください。

   3. Create をクリックします。

      Fuse Console Operator Details ページが開き、デプロイメントの状態が表示されます。

9. Fuse Console を開くには以下を行います。

   1. namespace デプロイメントの場合: OpenShift Web コンソールで、Fuse Console の operator をインストールしたプロジェクトを開き、Overview を選択します。Project Overview ページで Launcher セクションまで下方向にスクロールし、Fuse Console のリンクをクリックします。

      cluster デプロイメントでは、OpenShift Web コンソールのタイトルバーで、グリッドアイコン ( ) をクリックします。ポップアップメニューの Red Hat アプリケーション の下にある、Fuse Console の URL リンクをクリックします。

   2. Fuse Console にログインします。

      ブラウザーに Authorize Access ページが表示され、必要なパーミッションが表示されます。

   3. Allow selected permissions をクリックします。

      Fuse Console がブラウザーで開き、アクセス権限のある Fuse アプリケーション Pod が表示されます。

10. 表示するアプリケーションの Connect をクリックします。

    新しいブラウザーウィンドウが開かれ、Fuse Console にアプリケーションが表示されます。

手順

1. 以下のコマンドを実行してすべてのテンプレートのリストを取得し、Fuse Console イメージストリームがインストールされていることを確認します。

   oc get template -n openshift

2. 任意で、すでにインストールされているイメージストリームを新しいリリースタグで更新する場合は、以下のコマンドを使用して openshift namespace に Fuse Console イメージをインポートします。

   oc import-image fuse7/fuse-console-rhel8:1.10 --from=registry.redhat.io/fuse7/fuse-console-rhel8:1.10 --confirm -n openshift

3. 以下のコマンドを実行して、Fuse Console の APP_NAME の値を取得します。

   oc process --parameters -f TEMPLATE-FILENAME

   ここで、TEMPLATE-FILENAME は以下のテンプレートのいずれかになります。

   • クラスターテンプレート:

     https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-console-cluster-os4.json

   • 設定可能な RBAC のあるクラスターテンプレート:

     https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-console-cluster-rbac.yml

   • namespace テンプレート:

     https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-console-namespace-os4.json

   • 設定可能な RBAC のある namespace テンプレート:

     https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-console-namespace-rbac.yml

     たとえば、設定可能な RBAC のあるクラスターテンプレートの場合は、以下のコマンドを実行します。

     oc process --parameters -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fuse-console-cluster-rbac.yml

4. 以下のコマンドを使用して、Securing the Fuse Console on OpenShift 4.x で生成した証明書からシークレットを作成し、Fuse Console にマウントします。コマンドの APP_NAME は、Fuse Console アプリケーションの名前に置き換えます。

   oc create secret tls APP_NAME-tls-proxying --cert server.crt --key server.key

5. 以下のコマンドを実行して、ローカルにコピーされた Fuse Console テンプレートをベースとした新しいアプリケーションを作成します。コマンドの myproject は OpenShift プロジェクトの名前、mytemp は Fuse Console テンプレートが含まれるローカルディレクトリーへのパス、myhost は Fuse Console にアクセスするホストの名前に置き換えます。

   • クラスターテンプレートの場合:

     oc new-app -n myproject -f {templates-base-url}/fuse-console-cluster-os4.json  -p ROUTE_HOSTNAME=myhost”

   • RBAC テンプレートのあるクラスターの場合:

     oc new-app -n myproject -f {templates-base-url}/fuse-console-cluster-rbac.yml -p ROUTE_HOSTNAME=myhost”

   • namespace テンプレートの場合:

     {templates-base-url}/fuse-console-namespace-os4.json

   • RBAC テンプレートのある namespace の場合:

     oc new-app -n myproject -f {templates-base-url}/fuse-console-namespace-rbac.yml

6. OpenShift Web コンソールを開くように Fuse Console を設定するには、以下のコマンドを実行して OPENSHIFT_WEB_CONSOLE_URL 環境変数を設定します。

   oc set env dc/${APP_NAME} OPENSHIFT_WEB_CONSOLE_URL=`oc get -n openshift-config-managed cm console-public -o jsonpath={.data.consoleURL}`

7. 以下のコマンドを実行して、Fuse Console デプロイメントの状態と URL を取得します。

   oc status

8. ブラウザーから Fuse Console にアクセスするには、手順 7. で返される URL (例: https://fuse-console.192.168.64.12.nip.io) を使用します。

1. ターミナルウィンドウで、以下のコマンドを使用してアプリケーションカスタムリソース定義の .spec.version フィールドを変更します。

   oc patch -n <project-name> <custom-resource-name> --type='merge' -p '{"spec":{"version":"1.7.1"}}'

   以下に例を示します。

   oc patch -n myproject hawtio/example-fuseconsole --type='merge' -p '{"spec":{"version":"1.7.1"}}'

2. アプリケーションの状態が更新されたことを確認します。

    oc get -n myproject hawtio/example-fuseconsole

   応答には、バージョン番号などのアプリケーションに関する情報が表示されます。

   NAME                  AGE   URL                                        IMAGE
   example-fuseconsole   1m    https://fuseconsole.192.168.64.38.nip.io   docker.io/fuseconsole/online:1.7.1

   .spec.version フィールドの値を変更すると、OpenShift によってアプリケーションが自動的に再デプロイされます。

3. バージョンの変更によってトリガーされた再デプロイの状態をチェックするには、以下を実行します。

   oc rollout status deployment.v1.apps/example-fuseconsole

   正常にデプロイされた場合は以下の応答が表示されます。

   deployment "example-fuseconsole" successfully rolled out

1. 以下のコマンドの 1 つを実行して、Fuse Console テンプレートをベースとした新しいアプリケーションを作成します。コマンドの myproject はプロジェクトの名前に置き換えます。

   • Fuse Console の cluster テンプレートの場合は、以下のようになります。myhost は Fuse Console にアクセスするホストの名前になります。

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fis-console-cluster-template.json -p ROUTE_HOSTNAME=myhost

   • Fuse Console の namespace テンプレートの場合は以下のようになります。

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_10_0-00015-redhat-00001/fis-console-namespace-template.json

     注記

     namespace テンプレートの route_hostname パラメーターは OpenShift によって自動的に生成されるため、省略することが可能です。

2. 以下のコマンドを実行して、Fuse Console デプロイメントの状態と URL を取得します。

   oc status

3. ブラウザーから Fuse Console にアクセスするには、提供される URL (例: https://fuse-console.192.168.64.12.nip.io) を使用します。

手順

1. OpenShift プロジェクトの Applications → Pods ビューで、Pod 名をクリックし、実行している Fuse Pod の詳細を表示します。このページの右側に、コンテナーテンプレートの概要が表示されます。

   

2. このビューの Open Java Console リンクをクリックし、Fuse Console を開きます。

   

1. Camel タブのツリービューで、Camel Contexts をクリックします。
2. リストのコンテキストの横にあるボックスにチェックマークを入れます。
3. Start または Suspend をクリックします。

4. コンテキストを削除するには以下を行います。

   1. コンテキストを停止します。
   2. 楕円のアイコンをクリックし、ドロップダウンメニューで Delete を選択します。

1. Camel タブのツリービューで、Camel アプリケーションをクリックします。
2. アプリケーションの属性と値のリストを表示するには、Attributes をクリックします。
3. アプリケーション属性をグラフィカルに表示するには、Chart をクリックした後、Edit をクリックし、チャートに表示する属性を選択します。
4. inflight exchange および blocked exchange を表示するには、Exchanges をクリックします。
5. アプリケーションエンドポイントを表示するには、Endpoints をクリックします。リストは URL、Route ID、および direction で絞り込むことができます。
6. メッセージ本文とメッセージヘッダーを別のタイプに変換するために使用される Camel 組み込みタイプ変換メカニズムに関連する統計を表示、有効化、および無効化するには、Type Converters をクリックします。
7. JMX 操作 (XML からのルートの追加または更新、クラスパスで利用できる Camel コンポーネントの検索など) を表示および実行するには、Operations をクリックします。

1. ルートのリストを表示するには、以下を行います。

   1. Camel タブをクリックします。

   2. ツリービューでアプリケーションの routes フォルダーをクリックします。

      

2. 1 つまたは複数のルートを起動、停止、または削除するには、以下を行います。

   1. リストのルートの横にあるボックスにチェックマークを入れます。
   2. Start または Stop をクリックします。

   3. 最初にルートを停止してから削除する必要があります。停止したら楕円のアイコンをクリックし、ドロップダウンメニューで Delete を選択します。

      

      注記
      • ルートを削除する場合、デプロイされたアプリケーションから削除します。
      • ツリービューで特定のルートを選択し、右上のメニューをクリックして起動、停止、または削除することもできます。
3. ルートのグラフィカルな図を表示するには、Route Diagram をクリックします。
4. inflight exchange および blocked exchange を表示するには、Exchanges をクリックします。
5. エンドポイントを表示するには、Endpoints をクリックします。URL、Route ID、および方向でリストを絞り込むことができます。
6. Type Converters をクリックし、Camel の組み込みタイプ変換メカニズムに関連する統計を表示、有効化、および無効化します。このメカニズムはメッセージ本文とメッセージヘッダーを別のタイプに変換するために使用されます。

7. 特定のルートと対話するには、以下を行います。

   1. Camel タブのツリービューで、ルートを選択します。
   2. ルート属性と値のリストを表示するには、Attributes をクリックします。
   3. ルート属性をグラフィカルに表示するには、Chart をクリックします。Edit をクリックすると、チャートに表示する属性を選択できます。
   4. inflight exchange および blocked exchange を表示するには、Exchanges をクリックします。
   5. Operations をクリックして JMX 操作 (ルートを XML としてダンプ、ルートの Camel ID 値の取得など) を表示および実行できます。

8. ルートを介してメッセージをトレースするには、以下を実行します。

   1. Camel タブのツリービューで、ルートを選択します。
   2. Trace を選択し、Start tracing をクリックします。

9. メッセージをルートに送信するには、以下を行います。

   1. Camel タブのツリービューでコンテキストのエンドポイントフォルダーを開き、エンドポイントを選択します。
   2. Send サブタブをクリックします。
   3. JSON または XML 形式のメッセージを設定します。
   4. Send をクリックします。
   5. ルートの Trace タブに戻り、ルートを介したメッセージのフローを確認します。

1. Camel タブのツリービューで、ルートを選択します。
2. Debug を選択し、Start debugging をクリックします。

3. ブレークポイントを追加するには、図のノードを選択し、Add breakpoint をクリックします。ノードに赤い点が表示されます。

   

   ノードがブレークポイントのリストに追加されます。

   

4. 下矢印をクリックして次のノードに移動するか、Play ボタンをクリックしてルートの実行を再開します。
5. Pause ボタンをクリックして、ルートのすべてのスレッドを一時停止します。
6. 終了したら Stop debugging をクリックします。すべてのブレークポイントが消去されます。