4.2. Fuse on OpenShift でのアプリケーションの作成およびデプロイ

手順

1. Maven の archetype を使用して、新しい Fuse on OpenShift プロジェクトを作成します。この例では、サンプル Spring Boot Camel プロジェクトを作成する archetype を使用します。新しいシェルプロンプトを開き、以下の Maven コマンドを入力します。

   mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \
     -DarchetypeCatalog=https://maven.repository.redhat.com/ga/io/fabric8/archetypes/archetypes-catalog/2.2.0.fuse-740017-redhat-00003/archetypes-catalog-2.2.0.fuse-740017-redhat-00003-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=spring-boot-camel-xml-archetype \
     -DarchetypeVersion=2.2.0.fuse-740017-redhat-00003

   archetype プラグインが対話モードに切り替わり、残りのフィールドの入力を要求されます。

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse74-spring-boot
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   [INFO] Using property: spring-boot-version = 1.5.17.RELEASE
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse74-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
   spring-boot-version: 1.5.17.RELEASE
    Y: :

   プロンプトが表示されたら、groupId 値に org.example.fis を入力し、artifactId 値に fuse74-Spring-boot を 入力します。残りのフィールドにはデフォルト値を使用します。

2. 前のコマンドが BUILD SUCCESS ステータスで終了した場合、fuse74-Spring-boot サブディレクトリーの下に新しい Fuse on OpenShift プロジェクトが作成されているはずです。fuse74-Spring-boot/src/main/resources/spring/camel-context.xml ファイル内の XML DSL コードを検査できます。デモンストレーションコードは、乱数が含まれるメッセージを継続的にログに送信する、シンプルな Camel ルートを定義します。

3. Fuse on OpenShift プロジェクトのビルドおよびデプロイを準備するため、以下のように OpenShift サーバーにログインします。

   oc login -u developer -p developer https://OPENSHIFT_IP_ADDR:8443

   IP アドレスは常に同じではないため、OPENSHIFT_IP_ADDR は OpenShift サーバーの IP アドレスのプレースホルダーになります。この値を実際の IP アドレスに置き換えます。

   注記

   developer パスワードを持つ developer ユーザーは、CDK による仮想 OpenShift サーバーで自動作成される標準のアカウントです。リモートサーバーにアクセスする場合は、OpenShift 管理者が提供する URL とクレデンシャルを使用します。

4. 以下のコマンドを実行し、Fuse on OpenShift イメージおよびテンプレートがすでにインストールされ、アクセス可能であることを確認します。

   oc get template -n openshift

   イメージおよびテンプレートが事前にインストールされていない場合や、提供されたバージョンが古い場合は、Fuse on OpenShift イメージおよびテンプレートを手作業でインストール (または更新) します。Fuse on OpenShift イメージのインストール方法に関する詳細は、2章管理者向けの基本情報 を参照してください。

5. 次のように、test という新しいプロジェクト名前空間を作成します (まだ存在していないと仮定します)。

   oc new-project test

   テスト プロジェクトの名前空間がすでに存在する場合は、次のコマンドを使用して切り替えることができます。

   oc project test

6. これで、fuse74-Spring-boot プロジェクトをビルドしてデプロイする準備が整いました。OpenShift にまだログインしていると仮定して、fuse74-Spring-boot プロジェクトのディレクトリーに変更し、次のようにプロジェクトをビルドしてデプロイします。

   cd fuse74-spring-boot
   mvn fabric8:deploy -Popenshift

   ビルドに成功すると、以下のような出力が表示されます。

   ...
   [INFO] OpenShift platform detected
   [INFO] Using project: test
   [INFO] Creating a Service from openshift.yml namespace test name fuse74-spring-boot
   [INFO] Created Service: target/fabric8/applyJson/test/service-fuse74-spring-boot.json
   [INFO] Using project: test
   [INFO] Creating a DeploymentConfig from openshift.yml namespace test name fuse74-spring-boot
   [INFO] Created DeploymentConfig: target/fabric8/applyJson/test/deploymentconfig-fuse74-spring-boot.json
   [INFO] Creating Route test:fuse74-spring-boot host: null
   [INFO] F8: HINT: Use the command `oc get pods -w` to watch your pods start up
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time: 05:38 min
   [INFO] Finished at: 2019-02-22T12:08:11+01:00
   [INFO] Final Memory: 63M/272M
   [INFO] ------------------------------------------------------------------------

   注記

   このコマンドを初めて実行する場合、Maven は多くの依存関係をダウンロードする必要があるため、数分かかることがあります。2 回目からはビルドが速くなります。

7. ブラウザーで OpenShift コンソールに移動し、クレデンシャル (例: ユーザー名 developer およびパスワード developer) を使用してコンソールにログインします。
8. OpenShift コンソールで下方向にスクロールし、test プロジェクト namespace を見つけます。test プロジェクトをクリックして、test プロジェクト namespace を開きます。test プロジェクトの Overview タブが開き、fuse74-spring-boot アプリケーションが表示されます。

9. fuse74-spring-boot デプロイメントの左にある矢印をクリックし、このデプロイメントの詳細をデプロイメントおよび表示します。

   

10. Pod アイコン (青い円) の中心をクリックし、fuse74-spring-boot の Pod のリストを表示します。

    

11. 実行中の Pod の詳細を表示するには、Pod 名 (この例では fuse74-Spring-boot-1-kxdjm) をクリックします。

    

12. Logs タブをクリックしてアプリケーションログを表示し、ログを下方向にスクロールして、Camel アプリケーションによって生成された乱数のログメッセージを見つけます。

    ...
    07:30:32.406 [Camel (camel) thread #0 - timer://foo] INFO  simple-route - >>> 985
    07:30:34.405 [Camel (camel) thread #0 - timer://foo] INFO  simple-route - >>> 741
    07:30:36.409 [Camel (camel) thread #0 - timer://foo] INFO  simple-route - >>> 796
    07:30:38.409 [Camel (camel) thread #0 - timer://foo] INFO  simple-route - >>> 211
    07:30:40.411 [Camel (camel) thread #0 - timer://foo] INFO  simple-route - >>> 511
    07:30:42.411 [Camel (camel) thread #0 - timer://foo] INFO simple-route - >>> 942

13. 左側のナビゲーションバーにある Overview をクリックし、test namespace のアプリケーション概要に戻ります。実行中の Pod をシャットダウンするには、Pod アイコンの横にある下矢印 をクリックします。Scale down deployment fuse74-spring-boot-1? というダイアログが表示されたら、Scale Down をクリックします。

14. (任意): CDK を使用している場合は、シェルプロンプトに戻り、以下のコマンドを入力すると、仮想 OpenShift サーバーを完全にシャットダウンすることができます。

    minishift stop

手順

1. ブラウザーで https://OPENSHIFT_IP_ADDR:8443 の OpenShift コンソール (OPENSHIFT_IP_ADDR は CDK の場合に表示された IP アドレスに置き換えます) に移動し、クレデンシャル (たとえば、ユーザー名 developer とパスワード developer) を使用してコンソールにログインします。

2. カタログ検索フィールドに、検索文字列として Red Hat Fuse 7.4 Camel XML と入力し、Red Hat Fuse 7.4 Camel XML DSL with Spring Boot テンプレートを選択します。

   

3. テンプレートウィザードの Information ステップが開きます。Next をクリックします。

4. 以下のように、テンプレートウィザードの Configuration ステップが開きます。Add to Project ドロップダウンメニューで My Project を選択します。

   注記

   この例で新しいプロジェクトを作成したい場合は、上記の手順の代わりに Add to Project ドロップダウンメニューで Create Project を選択します。新規プロジェクトの名前を入力する Project Name フィールドが表示されます。

5. Configuration ステップの残りの設定では、デフォルトの値を使用します。Create をクリックします。

   

   注記

   クイックスタートをそのまま実行せずに、アプリケーションコードを変更する場合は、元のクイックスタート Git リポジトリーをフォークし、Git Repository URL および Git Reference フィールドに適切な値を入力する必要があります。

6. テンプレートウィザードの Results ステップが開きます。Close をクリックします。
7. 右側の My Projects ペインで My Project をクリックします。My Project プロジェクトの Overview タブが開き、s2i-fuse74-spring-boot-camel-xml アプリケーションが表示されます。

8. s2i-fuse74-spring-boot-camel-xml デプロイメントの左にある矢印をクリックし、以下のようにこのデプロイメントの詳細をデプロイメントおよび表示します。

   

9. このビューにビルドログが表示されます。何らかの理由でビルドに失敗した場合は、ビルドログを参照して問題を診断します。

   注記

   リモートの Maven リポジトリーから多くの依存関係をダウンロードする必要があるため、ビルドが完了するまで数分かかることがあります。ビルド時間を短縮するには、ローカルネットワークに Nexus サーバーをデプロイすることが推奨されます。

10. ビルドが正常に完了したら、Pod アイコンは 1 つの Pod が実行している青い円で表示されます。Pod アイコン (青い円) の中心をクリックし、s2i-fuse74-spring-boot-camel-xml の Pod のリストを表示します。

    注記

    複数の Pod が実行されている場合、この時点では実行中の Pod のリストが表示されます。1 つの Pod のみが実行されている場合は、実行中の Pod の詳細ビューが表示されます。

11. Pod 詳細ビューが開きます。Logs タブをクリックしてアプリケーションログを表示し、ログを下方向にスクロールして、Camel アプリケーションによって生成されたログメッセージを見つけます。

    

12. 左側のナビゲーションバーにある Overview をクリックし、My Project namespace のアプリケーション概要に戻ります。実行中の Pod をシャットダウンするには、Pod アイコンの横にある下矢印 をクリックします。Scale down deployment s2i-fuse74-spring-boot-camel-xml-1? というダイアログが表示されたら、Scale Down をクリックします。

13. (任意): CDK を使用している場合は、シェルプロンプトに戻り、以下のコマンドを入力すると、仮想 OpenShift サーバーを完全にシャットダウンすることができます。

    minishift stop