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-760024-redhat-00001/archetypes-catalog-2.2.0.fuse-760024-redhat-00001-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=spring-boot-camel-xml-archetype \
     -DarchetypeVersion=2.2.0.fuse-760024-redhat-00001

   Copy to Clipboard Toggle word wrap

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

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse76-spring-boot
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse76-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

   Copy to Clipboard Toggle word wrap

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

2. 前のコマンドが BUILD SUCCESS 状態で終了した場合、fuse76-spring-boot サブディレクトリー内に新しい Fuse on OpenShift プロジェクトが作成されているはずです。fuse76-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

   Copy to Clipboard Toggle word wrap

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

   注記

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

4. 次のように、openshift プロジェクトに切り替えます (まだ openshift プロジェクトにない場合)。

   oc project openshift

   Copy to Clipboard Toggle word wrap

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

   oc get template -n openshift

   Copy to Clipboard Toggle word wrap

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

6. これで、fuse76-spring-boot プロジェクトをビルドおよびデプロイできるようになりました。OpenShift にログインしている状態で、fuse76-spring-boot プロジェクトのディレクトリーに移動し、以下のようにプロジェクトをビルドおよびデプロイします。

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

   Copy to Clipboard Toggle word wrap

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

   ...
   [INFO] OpenShift platform detected
   [INFO] Using project: openshift
   [INFO] Creating a Service from openshift.yml namespace openshift name fuse76-spring-boot
   [INFO] Created Service: target/fabric8/applyJson/openshift/service-fuse76-spring-boot.json
   [INFO] Using project: openshift
   [INFO] Creating a DeploymentConfig from openshift.yml namespace openshift name fuse76-spring-boot
   [INFO] Created DeploymentConfig: target/fabric8/applyJson/openshift/deploymentconfig-fuse76-spring-boot.json
   [INFO] Creating Route openshift:fuse76-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-10-24T12:15:06+05:30
   [INFO] Final Memory: 63M/688M
   [INFO] ------------------------------------------------------------------------

   Copy to Clipboard Toggle word wrap
   注記

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

7. ブラウザーで OpenShift コンソールに移動し、クレデンシャル (例: ユーザー名 developer およびパスワード developer) を使用してコンソールにログインします。
8. 左側のパネルで Home をデプロイメントします。Projects をクリックしてから、プロジェクトダッシュボードに表示する openshift プロジェクトを選択します。

9. fuse76-spring-boot をクリックし、fuse76-spring-boot アプリケーションの概要情報ページを表示します。

   

10. 左側のパネルで Workloads を展開します。
11. Pods をクリックします。openshift プロジェクトで稼働している Pod すべてが表示されます。

12. Pod の Name (この例では fuse76-spring-boot-xxxxx) をクリックし、稼働中の Pod の詳細を表示します。

    

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

    ...
    06:45:54.311 [Camel (MyCamel) thread #1 - timer://foo] INFO simple-route - >>> 130
    06:45:56.265 [Camel (MyCamel) thread #1 - timer://foo] INFO simple-route - >>> 898
    06:45:58.265 [Camel (MyCamel) thread #1 - timer://foo] INFO simple-route - >>> 414
    06:46:00.265 [Camel (MyCamel) thread #1 - timer://foo] INFO simple-route - >>> 486
    06:46:02.265 [Camel (MyCamel) thread #1 - timer://foo] INFO simple-route - >>> 093
    06:46:04.265 [Camel (MyCamel) thread #1 - timer://foo] INFO simple-route - >>> 080

    Copy to Clipboard Toggle word wrap

14. 稼働中の Pod を終了するには以下を行います。

    1. openshift プロジェクトの Project Status ページで、Workloads タブをクリックしてから、fuse76-spring-boot アプリケーションをクリックします。
    2. Overview タブをクリックし、アプリケーションの概要情報ページを表示します。
    3. Pod アイコンの隣にある下矢印 をクリックし、値をゼロにして Pod を停止します。

手順

1. 次のように、OpenShift サーバーにログインします。

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

   Copy to Clipboard Toggle word wrap

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

   注記

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

2. 次のように、openshift プロジェクトに切り替えます (まだ openshift プロジェクトにない場合)。

   oc project openshift

   Copy to Clipboard Toggle word wrap

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

   oc get template -n openshift

   Copy to Clipboard Toggle word wrap

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

4. 以下のコマンドを入力し、Red Hat Fuse 7.6 Camel XML DSL with Spring Boot クイックスタートテンプレートの実行に必要なリソースを作成します。これにより、クイックスタートのデプロイメント設定およびビルド設定が作成されます。クイックスタートのデフォルトパラメーターや作成されたリソースの情報はターミナルに表示されます。

   oc new-app s2i-fuse76-spring-boot-camel-xml
   
   --> Deploying template "openshift/s2i-fuse76-spring-boot-camel-xml" to project openshift
   ...
   --> Creating resources ...
       imagestream.image.openshift.io "s2i-fuse76-spring-boot-camel-xml" created
       buildconfig.build.openshift.io "s2i-fuse76-spring-boot-camel-xml" created
       deploymentconfig.apps.openshift.io "s2i-fuse76-spring-boot-camel-xml" created
   --> Success
       Build scheduled, use 'oc logs -f bc/s2i-fuse76-spring-boot-camel-xml' to track its progress.
       Run 'oc status' to view your app.

   Copy to Clipboard Toggle word wrap
5. ブラウザーで https://OPENSHIFT_IP_ADDR の OpenShift Web コンソールに移動します (OPENSHIFT_IP_ADDR はクラスターの IP アドレスに置き換えます)。クレデンシャル (例: ユーザー名 developer、パスワード developer) を使用して、コンソールにログインします。
6. 左側のパネルで Home をデプロイメントします。Projects をクリックしてから、プロジェクトダッシュボードに表示する openshift プロジェクトを選択します。
7. Workloads タブをクリックします。選択された namespace (例: openshift) の既存のアプリケーションがすべて表示されます。

8. s2i-fuse76-spring-boot-camel-xml をクリックし、クイックスタートの Overview 情報ページを表示します。

   

9. Resources タブをクリックした後に View logs をクリックし、アプリケーションのビルドログを表示します。

   

10. 左側のパネルで Workloads を展開します。

11. Pods をクリックした後、s2i-fuse76-spring-boot-camel-xml-xxxx をクリックします。アプリケーションの Pod の詳細が表示されます。

    

12. 稼働中の Pod を終了するには以下を行います。

    1. openshift プロジェクトの Project Details ページで、Workloads タブをクリックしてから s2i-fuse76-spring-boot-camel-xml-xxxx アプリケーションをクリックします。
    2. Overview タブをクリックし、アプリケーションの概要情報ページを表示します。
    3. Pod アイコンの隣にある下矢印 をクリックし、値をゼロにして Pod を停止します。
    4. 下矢印を使用して値をゼロにし、Pod を停止します。