第1章 OpenShift における Red Hat Fuse アプリケーションの監視および管理

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

   

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

   

   注記

   Pod ビューで Fuse Console へのリンクを表示するよう OpenShift を設定するには、Fuse on OpenShift イメージを実行している Pod が jolokia に設定された name 属性内で TCP ポートを宣言する必要があります。

   {
     "kind": "Pod",
     [...]
     "spec": {
       "containers": [
         {
           [...]
           "ports": [
             {
               "name": "jolokia",
               "containerPort": 8778,
               "protocol": "TCP"
             }

手順

1. OpenShift コンソールで既存のプロジェクトを開くか、新しいプロジェクトを作成します。

2. Fuse Console を OpenShift プロジェクトに追加します。

   1. Add to Project Browse Catalog と選択します。

      Select an item to add to the current project ページが開きます。

   2. Search フィールドで Fuse Console を入力します。

      Red Hat Fuse 7.x Console および Red Hat Fuse 7.x Console (cluster) アイテムが検索結果として表示されるはずです。

1. Red Hat Fuse Console アイテムの 1 つをクリックします。

   • Red Hat Fuse 7.x Console - このバージョンの Fuse Console は、現在の OpenShift プロジェクトにデプロイされた Fuse アプリケーションを検出し、接続します。
   • Red Hat Fuse 7.x Console (cluster) - このバージョンの Fuse Console は、OpenShift クラスターの複数のプロジェクトにデプロイされた Fuse アプリケーションを検出し、接続します。

2. Red Hat Fuse Console ウィザードで Next をクリックします。ウィザードの Configuration ページが開きます。

   任意で、設定パラメーターのデフォルト値を変更できます。

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

      ウィザードの Results ページに Red Hat Fuse Console が作成されたことが表示されます。

   2. Continue to the project overview をクリックし、Fuse Console アプリケーションがプロジェクトに追加されたことを確認します。

   3. Fuse Console を開き、提供された URL をクリックした後にログインします。

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

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

      ブラウザーで Fuse Console が開かれ、プロジェクトで実行されている Fuse の Pod が表示されます。

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

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

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.fuse-740025-redhat-00003/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.fuse-740025-redhat-00003/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. Fuse Console の右上隅にあるユーザーアイコンをクリックして、Preferences をクリックします。

   

2. Maximum collection size オプションの値を大きくします (デフォルトは 50,000)。
3. Close をクリックします。

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 をクリックします。すべてのブレークポイントが消去されます。