第4章 開発者向けの基本情報

1. Fuse on OpenShift では、バージョン 3.9 の CDK をインストールすることが推奨されます。CDK 3.9 をインストールおよび使用するための詳細手順は『Red Hat CDK 3.9 Getting Started Guide』を参照してください。
2. 「Red Hat コンテナーレジストリーの認証設定」の手順にしたがって、OpenShift クレデンシャルを設定し、Red Hat コンテナーレジストリーにアクセスできるようにします。

3. 2章管理者向けの基本情報 の説明にしたがって、Fuse on OpenShift イメージおよびテンプレートを手作業でインストールします。

   注記

   CDK のバージョンには Fuse on OpenShift イメージおよびテンプレートが事前にインストールされている可能性があります。ただし、OpenShift クレデンシャルの設定後に、Fuse on OpenShift イメージおよびテンプレートをインストール (または更新) する必要があります。

4. 本章の例を参照する前に、『Red Hat CDK 3.9 Getting Started Guide』の内容を読み、理解するようにしてください。

手順

1. Maven settings.xml ファイルを開きます。通常、このファイルは Linux または macOS の場合は ~/.m2/settings.xml、Windows の場合は Documents and Settings\<USER_NAME>\.m2\settings.xml に配置されます。

2. 以下の Maven リポジトリーを追加します。

   • Maven central: https://repo1.maven.org/maven2
   • Red Hat GA リポジトリー: https://maven.repository.redhat.com/ga

   • Red Hat EA リポジトリー: https://maven.repository.redhat.com/earlyaccess/all

     上記のリポジトリーは、settings.xml ファイルの依存関係リポジトリーセクションと、プラグインリポジトリーセクションの両方に追加する必要があります。

手順

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 プロジェクトが作成されているはずです。XML DSL コードは fuse74-spring-boot/src/main/resources/spring/camel-context.xml ファイルで確認できます。デモンストレーションコードは、乱数が含まれるメッセージを継続的にログに送信する、シンプルな 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 という名前のプロジェクト namespace を作成します。

   oc new-project test

   test プロジェクト namespace がすでに存在する場合、以下のコマンドを使用して切り替えます。

   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 の Name (この例では fuse74-spring-boot-1-kxdjm) をクリックし、稼働中の Pod の詳細を表示します。

    

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