Fuse on OpenShift ガイド

手順

1. 管理者として OpenShift サーバーにログインします。

   oc login -u system:admin

2. イメージストリームをインストールする OpenShift プロジェクトにログインします。Fuse on OpenShift イメージストリームの openshift プロジェクトを使用することが推奨されます。

   oc project openshift

3. Red Hat カスタマーポータルアカウントまたは Red Hat Developer Program アカウントのクレデンシャルを使用して、docker-registry シークレットを作成します。<pull_secret_name> は作成するシークレットの名前に置き換えてください。

   oc create secret docker-registry <pull_secret_name> \
     --docker-server=registry.redhat.io \
     --docker-username=CUSTOMER_PORTAL_USERNAME \
     --docker-password=CUSTOMER_PORTAL_PASSWORD \
     --docker-email=EMAIL_ADDRESS

   注記

   イメージストリームがある新しい namespace すべてと、registry.redhat.io を使用する namespace すべてに docker-registry シークレットを作成する必要があります。

4. Pod のイメージをプルするためにシークレットを使用するには、シークレットをサービスアカウントに追加します。サービスアカウントの名前は、Pod が使用するサービスアカウントの名前と一致する必要があります。以下は、デフォルトのサービスアカウントである default を使用する例になります。

   oc secrets link default <pull_secret_name> --for=pull

5. ビルドイメージをプッシュまたはプルするためにシークレットを使用するには、シークレットを Pod の内部にマウントできる必要があります。シークレットをマウントするには、以下のコマンドを使用します。

   oc secrets link builder <pull_secret_name>

手順

1. OpenShift 4 サーバーを起動します。

2. OpenShift サーバーに管理者としてログインします。

   oc login -u system:admin

3. docker-registry シークレットを作成したプロジェクトを使用することを確認します。

   oc project openshift

4. Samples Operator の現在の設定を表示します。

   oc get configs.samples.operator.openshift.io -n openshift-cluster-samples-operator -o yaml

5. Samples Operator が、追加された Fuse テンプレートおよびイメージストリームを無視するよう設定します。

   oc edit configs.samples.operator.openshift.io -n openshift-cluster-samples-operator

6. Fuse イメージストリームおよびテンプレートをそれぞれ Skipped Imagestreams および Skipped Templates セクションに追加します。

   [...]
   spec:
     architectures:
     - x86_64
     managementState: Managed
     skippedImagestreams:
     - fis-java-openshift
     - fis-karaf-openshift
     - fuse7-console
     - fuse7-eap-openshift
     - fuse7-java-openshift
     - fuse7-karaf-openshift
     - jboss-fuse70-console
     - jboss-fuse70-eap-openshift
     - jboss-fuse70-java-openshift
     - jboss-fuse70-karaf-openshift
     - fuse-apicurito-generator
     - apicurito-ui
     skippedTemplates:
     - s2i-fuse74-eap-camel-amq
     - s2i-fuse74-eap-camel-cdi
     - s2i-fuse74-eap-camel-cxf-jaxrs
     - s2i-fuse74-eap-camel-cxf-jaxws
     - s2i-fuse74-eap-camel-jpa
     - s2i-fuse74-karaf-camel-amq
     - s2i-fuse74-karaf-camel-log
     - s2i-fuse74-karaf-camel-rest-sql
     - s2i-fuse74-karaf-cxf-rest
     - s2i-fuse74-spring-boot-camel
     - s2i-fuse74-spring-boot-camel-amq
     - s2i-fuse74-spring-boot-camel-config
     - s2i-fuse74-spring-boot-camel-drools
     - s2i-fuse74-spring-boot-camel-infinispan
     - s2i-fuse74-spring-boot-camel-rest-sql
     - s2i-fuse74-spring-boot-camel-xa
     - s2i-fuse74-spring-boot-camel-xml
     - s2i-fuse74-spring-boot-cxf-jaxrs

7. Fuse on OpenShift イメージストリームをインストールします。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003
   
   oc create -n openshift -f ${BASEURL}/fis-image-streams.json

8. クイックスタートテンプレートをインストールします。

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    eap-camel-jpa-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json \
    spring-boot-camel-amq-template.json \
    spring-boot-camel-config-template.json \
    spring-boot-camel-drools-template.json \
    spring-boot-camel-infinispan-template.json \
    spring-boot-camel-rest-sql-template.json \
    spring-boot-camel-template.json \
    spring-boot-camel-xa-template.json \
    spring-boot-camel-xml-template.json \
    spring-boot-cxf-jaxrs-template.json \
    spring-boot-cxf-jaxws-template.json ;
    do
    oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/quickstarts/${template}
    done

9. Fuse Console のテンプレートをインストールします。

   oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/fis-console-cluster-template.json
   oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/fis-console-namespace-template.json

   注記

   Fuse Console のデプロイに関する詳細は、「OpenShift 4.x での Fuse Console の設定」を参照してください。

10. (任意手順): インストールされた Fuse on OpenShift イメージおよびテンプレートを表示します。

    oc get template -n openshift

手順

1. OpenShift 4.x サーバーを起動します。
2. ブラウザーで OpenShift コンソールに移動します。ご自分のクレデンシャルでコンソールにログインします。
3. Catalog をクリックした後、OperatorHub をクリックします。
4. 検索フィールドウインドウに Apicurito と入力し、Enter キーを押します。右側のパネルに Apicurito Operator が表示されます。
5. Apicurito Operator をクリックします。Apicurito Operator インストールウインドウが表示されます。

6. Install をクリックします。Create Operator Subscription フォームが表示されます。このフォームには以下のオプションがあります。

   • Installation mode (インストールモード)
   • Update Channel (更新チャネル)

   • Approval Strategy (承認ストラテジー)

     デフォルト値をそのまま使用するか、希望の値を選択します。

7. Subscribe をクリックします。Apicurito Operator が選択した namespace にインストールされます。
8. 確認するには、Catalog をクリックした後、Installed Operator をクリックします。リストに Apicurito Operator が表示されます。

9. Name 列の Apicurito Operator をクリックします。Provided APIs 以下の Create New をクリックします。新しい CRD (Custom Resource Definition) がデフォルト値で作成されます。以下のフィールドは CR の一部としてサポートされます。

   • size: Apicurito Operator が持つ Pod の数。
   • image: Apicurito イメージ。既存のインストールでこのイメージを変更すると、Operator のアップグレードがトリガーされます。
10. Create をクリックします。これにより新しい apicurito-service が作成されます。

手順

1. OpenShift サーバーを起動します。

2. OpenShift サーバーに管理者としてログインします。

   oc login -u system:admin

3. docker-registry シークレットを作成したプロジェクトを使用することを確認します。

   oc project openshift

4. Fuse on OpenShift イメージストリームをインストールします。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003
   
   oc create -n openshift -f ${BASEURL}/fis-image-streams.json

5. クイックスタートテンプレートをインストールします。

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    eap-camel-jpa-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json \
    spring-boot-camel-amq-template.json \
    spring-boot-camel-config-template.json \
    spring-boot-camel-drools-template.json \
    spring-boot-camel-infinispan-template.json \
    spring-boot-camel-rest-sql-template.json \
    spring-boot-camel-template.json \
    spring-boot-camel-xa-template.json \
    spring-boot-camel-xml-template.json \
    spring-boot-cxf-jaxrs-template.json \
    spring-boot-cxf-jaxws-template.json ;
    do
    oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/quickstarts/${template}
    done

6. Fuse Console のテンプレートをインストールします。

   oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/fis-console-cluster-template.json
   oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/fis-console-namespace-template.json

   注記

   Fuse Console のデプロイに関する詳細は、「OpenShift 4.x での Fuse Console の設定」を参照してください。

7. Apicurito テンプレートをインストールします。

   oc create -n openshift -f ${BASEURL}/fuse-apicurito.yml

8. (任意手順): インストールされた Fuse on OpenShift イメージおよびテンプレートを表示します。

   oc get template -n openshift

手順

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

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

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

   注記

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

2. test という名前のプロジェクト namespace を新規作成します。

   oc new-project test

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

   oc project test

3. Fuse on OpenShift イメージストリームをインストールします。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003
   
   oc create -n test -f ${BASEURL}/fis-image-streams.json

   コマンド出力に、Fuse on OpenShift プロジェクトで使用できるようになった Fuse イメージストリームが表示されます。

4. クイックスタートテンプレートをインストールします。

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    eap-camel-jpa-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json \
    spring-boot-camel-amq-template.json \
    spring-boot-camel-config-template.json \
    spring-boot-camel-drools-template.json \
    spring-boot-camel-infinispan-template.json \
    spring-boot-camel-rest-sql-template.json \
    spring-boot-camel-template.json \
    spring-boot-camel-xa-template.json \
    spring-boot-camel-xml-template.json \
    spring-boot-cxf-jaxrs-template.json \
    spring-boot-cxf-jaxws-template.json ;
    do
    oc create -n test -f \
    ${BASEURL}/quickstarts/${template}
    done

5. Fuse Console のテンプレートをインストールします。

   oc create -n test -f ${BASEURL}/fis-console-cluster-template.json
   oc create -n test -f ${BASEURL}/fis-console-namespace-template.json

   注記

   Fuse Console のデプロイに関する詳細は、「OpenShift 4.x での Fuse Console の設定」を参照してください。

6. (任意手順): インストールされた Fuse on OpenShift イメージおよびテンプレートを表示します。

   oc get template -n test

7. ブラウザーで OpenShift コンソールに移動します。

   1. https://OPENSHIFT_IP_ADDR:8443 を使用します。OPENSHIFT_IP_ADDR は OpenShift サーバーの実際の IP アドレスに置き換えます。
   2. クレデンシャル (例: ユーザー名 developer とパスワード developer) を使用して OpenShift コンソールにログインします。

手順

1. システムの適切なディレクトリーに移動します。

2. シェルプロンプトで以下の mvn コマンドを入力し、Spring Boot プロジェクトを作成します。

   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 を入力します。残りのフィールドにはデフォルト値を使用します。

3. サンプルのビルドおよびデプロイ方法については、クイックスタートの手順にしたがいます。

手順

1. これは、application.properties ファイルの例です。Kubernetes yaml 記述子の以下のオプションを置き換えます。

   # Cluster
   cluster.nodename=1
   cluster.base-dir=./target/tx
   
   # Transaction Data
   spring.jta.transaction-manager-id=${cluster.nodename}
   spring.jta.log-dir=${cluster.base-dir}/store/${cluster.nodename}
   
   # Narayana recovery settings
   snowdrop.narayana.openshift.recovery.enabled=true
   snowdrop.narayana.openshift.recovery.current-pod-name=${cluster.nodename}
   # You must enable resource filtering in order to inject the Maven artifactId
   snowdrop.narayana.openshift.recovery.statefulset=${project.artifactId}
   snowdrop.narayana.openshift.recovery.status-dir=${cluster.base-dir}/status

2. 共有ボリュームに、終了に関連するトランザクションと情報の両方を格納する必要があります。以下のように StatefulSet yaml 記述子にマウントすることができます。

   apiVersion: apps/v1beta1
   kind: StatefulSet
   #...
   spec:
   #...
     template:
   #...
       spec:
         containers:
         - env:
           - name: CLUSTER_BASE_DIR
             value: /var/transaction/data
             # Override CLUSTER_NODENAME with Kubernetes Downward API (to use `pod-0`, `pod-1` etc. as tx manager id)
           - name: CLUSTER_NODENAME
             valueFrom:
               fieldRef:
                 apiVersion: v1
                 fieldPath: metadata.name
   #...
           volumeMounts:
           - mountPath: /var/transaction/data
             name: the-name-of-the-shared-volume
   #...

手順

1. Camel Spring Boot XA プロジェクトをダウンロードします。

   git clone https://github.com/jboss-fuse/spring-boot-camel-xa

2. spring-boot-camel-xa ディレクトリーに移動し、以下のコマンドを実行します。

   mvn clean install

3. OpenShift サーバーにログインします。

   oc login -u developer -p developer

4. test という名前のプロジェクト namespace を作成します (存在しない場合)。

   oc new-project test

   test プロジェクト namespace がすでに存在する場合は、それに切り替えます。

   oc project test

5. 依存関係をインストールします。

   • ユーザー名 postgresql とパスワード theuser を使用して、OpenShift カタログから Thepassword1! をインストールします。
   • ユーザー名 theuser とパスワード Thepassword1! を使用して、OpenShift カタログから A-MQ ブローカーをインストールします。

6. 準備済みステートメントを許可するよう、Postgresql データベースを変更します。

   oc env dc/postgresql POSTGRESQL_MAX_PREPARED_TRANSACTIONS=100

7. トランザクションログの永続ボリュームクレームを作成します。

   oc create -f persistent-volume-claim.yml

8. クイックスタートをビルドおよびでデプロイします。

   mvn fabric8:deploy -P openshift

9. レプリカの数を必要に合わせてスケールアップします。

   oc scale statefulset spring-boot-camel-xa --replicas 3

   注記： Pod 名はトランザクションマネージャー ID として使用されます (spring.jta.transaction-manager-id プロパティー)。また、現在の実装によってトランザクションマネージャー ID の長さも制限されます。よって、以下の点に注意してください。

   • StatefulSet の名前はトランザクションシステムの識別子であるため、変更しないでください。
   • Pod の名前が 23 文字以下になるように StatefulSet の名前を付ける必要があります。Pod 名は、<statefulset-name>-0, <statefulset-name>-1 のような慣例を使用して、OpenShift によって作成されます。Narayana はできる限り、同じ ID を持つリカバリーマネージャーが複数存在しないようにするため、Pod 名が制限よりも長い場合は、最後の 23 バイトがトランザクション ID として適用されます (「ｰ」などの一部の文字の削除後)。

10. クイックスタートが実行されたら、以下のコマンドを使用してベースサービス URL を取得します。

    NARAYANA_HOST=$(oc get route spring-boot-camel-xa -o jsonpath={.spec.host})

手順

1. audit_log テーブルのメッセージのリストを取得します。

   curl -w "\n" http://$NARAYANA_HOST/api/

2. 当初、このリストは空の状態です。最初の要素を追加します。

   curl -w "\n" -X POST http://$NARAYANA_HOST/api/?entry=hello

   しばらく待ってから、新しいリストを取得します。

   curl -w "\n" http://$NARAYANA_HOST/api/

3. 新しいリストには、hello と hello-ok の 2 つのメッセージが含まれます。hello-ok は、メッセージが送信キューに送られ、ログに記録されたことを確認します。複数のメッセージを追加してログを確認することができます。

手順

1. fail という名前のメッセージを送信します。

   curl -w "\n" -X POST http://$NARAYANA_HOST/api/?entry=fail

2. しばらく待ってから、新しいリストを取得します。

   curl -w "\n" http://$NARAYANA_HOST/api/

3. このメッセージは、ルートの最後で例外を発生するため、トランザクションは常にロールバックされます。audit_log テーブルにはメッセージのトレースが記録されないはずです。

手順

1. クイックスタートをビルドおよびデプロイするために準備します。

   1. OpenShift に開発者としてログインします。

      oc login -u developer -p developer

   2. 新しいプロジェクト amq-quickstart を作成します。

      oc new-project amq-quickstart

   3. インストールした AｰMQ 6 イメージおよびテンプレートのバージョンを確認します。

      $ oc get template -n openshift

      amqXX-basic という名前のテンプレートが見つかるはずです。XX は、OpenShift にインストールされた AｰMQ のバージョンになります。

2. A-MQ 6 イメージを amq-quickstart namespace にデプロイします。XX は、前のステップで確認した AｰMQ の実際のバージョンに置き換えます。

   $ oc process openshift//amqXX-basic -p APPLICATION_NAME=broker -p MQ_USERNAME=admin -p MQ_PASSWORD=admin -p MQ_QUEUES=test -p MQ_PROTOCOL=amqp -n amq-quickstart | oc create -f -

   注記

   古いバージョンの oc を使用すると、oc コマンドが失敗することがあります。この構文は、oc のバージョン 3.5.x (Kubernetes 1.5.x がベース) で動作します。

3. メッシュエンドポイントの検出に必要なユーザーロールを追加します (Kubernetes REST API 経由)。

   $ oc policy add-role-to-user view system:serviceaccount:amq-quickstart:default

4. 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-amq-archetype \
   -DarchetypeVersion=2.2.0.fuse-740017-redhat-00003

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

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse74-spring-boot-camel-amq
   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-camel-amq
   version: 1.0-SNAPSHOT
   package: org.example.fis
   spring-boot-version: 1.5.17.RELEASE
    Y: :

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

6. クイックスタートディレクトリー fuse74-spring-boot-camel-amq に移動します。

   $ cd fuse74-spring-boot-camel-amq

7. ACTIVEMQ_BROKER_USERNAME および ACTIVEMQ_BROKER_PASSWORD 環境変数を設定して、ブローカーにログインするためのクライアントクレデンシャルをカスタマイズします。fuse74-spring-boot-camel-amq プロジェクトで、以下のように src/main/fabric8/deployment.yml ファイルを編集します。

   spec:
     template:
       spec:
         containers:
           -
             resources:
               requests:
                 cpu: "0.2"
   #              memory: 256Mi
               limits:
                 cpu: "1.0"
   #              memory: 256Mi
             env:
             - name: AMQP_HOST
               value: broker-amq-amqp
             - name: SPRING_APPLICATION_JSON
               value: '{"server":{"undertow":{"io-threads":1, "worker-threads":2 }}}'
             - name: AMQP_USERNAME
               value: admin
             - name: AMQP_PASSWORD
               value: admin

8. mvn コマンドを実行し、クイックスタートを OpenShift サーバーにデプロイします。

   mvn fabric8:deploy -Popenshift

9. クイックスタートが正常に実行されていることを確認するには、以下を行います。

   1. OpenShift コンソールに移動します。
   2. プロジェクト amq-quickstart を選択します。
   3. Applications をクリックします。
   4. Pods を選択します。
   5. fis-spring-boot-camel-am-1-xxxxx をクリックします。

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

      出力にはメッセージが正常に送信されたことが表示されます。

      10:17:59.825 [Camel (camel) thread #10 - timer://order] INFO  generate-order-route - Generating order order1379.xml
      10:17:59.829 [Camel (camel) thread #8 - JmsConsumer[incomingOrders]] INFO  jms-cbr-route - Sending order order1379.xml to the UK
      10:17:59.829 [Camel (camel) thread #8 - JmsConsumer[incomingOrders]] INFO  jms-cbr-route - Done processing order1379.xml
      10:18:02.825 [Camel (camel) thread #10 - timer://order] INFO  generate-order-route - Generating order order1380.xml
      10:18:02.829 [Camel (camel) thread #7 - JmsConsumer[incomingOrders]] INFO  jms-cbr-route - Sending order order1380.xml to another country
      10:18:02.829 [Camel (camel) thread #7 - JmsConsumer[incomingOrders]] INFO jms-cbr-route - Done processing order1380.xml

10. Web インターフェースでルートを表示するには、Open Java Console をクリックし、A-MQ キューのメッセージをチェックします。

1. Secret マウントからの再帰的な読み取り
2. アプリケーションにちなんだ名前の付与 (spring.application.name を参照)
3. 一部のラベルとの一致

手順

1. システムの適切なディレクトリーに移動します。

2. Maven コマンドを起動して、Karaf プロジェクトを作成します。

   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=karaf-camel-log-archetype \
     -DarchetypeVersion=2.2.0.fuse-740017-redhat-00003

3. archetype プラグインは対話モードに切り替わり、残りのフィールドを追加するよう要求します。

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse74-karaf-camel-log
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse74-karaf-camel-log
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: :

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

4. サンプルのビルドおよびデプロイ方法については、クイックスタートの手順にしたがいます。

手順

1. プロジェクトの pom.xml を開き、fabric8-karaf-checks 機能を startupFeatures セクションに追加します。

   pom.xml

   <startupFeatures>
     ...
     <feature>fabric8-karaf-checks</feature>
     ...
   </startupFeatures>

   fabric8-maven-plugin:resources ゴールは fabric8-karaf-checks 機能が使用されているかを検出し、readiness および liveness probe について Kubernetes をコンテナーの設定に追加します。

手順

1. view ロールをデフォルトのサービスアカウントに追加して、クラスタリングを有効にします。これにより、view サービスアカウントへの default アクセス権限がユーザーに付与されます。サービスアカウントは、ビルド、デプロイメント、およびその他の Pod を実行するために各プロジェクトで必要になります。シェルプロンプトに以下の oc クライアントコマンドを入力します。

   oc login -u developer -p developer
   oc policy add-role-to-user view -z default

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

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

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

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

   注記

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

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

   注記

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

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

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

   

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

    

    注記

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

11. ビルドが正常に完了したら、Pod アイコンは 1 つの Pod が実行している青い円で表示されます。

    

12. アプリケーションを開くには、アプリケーションの詳細の上に表示される、http://s2i-fuse74-eap-camel-cdi-myproject.IP_ADDRESS.nip.io/ 形式のリンクをクリックします。これにより、ブラウザーで以下のようなメッセージが表示されます。

    Hello world from 172.17.0.3

    URL の name パラメーターを使用して名前を指定することもできます。たとえば、ブラウザーに URL http://s2i-fuse74-eap-camel-cdi-myproject.IP_ADDRESS.nip.io/?name=jdoe を入力すると、以下のような応答が表示されます。

    Hello jdoe from 172.17.0.3

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

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

    minishift stop

手順

1. 以下の設定例を使用して pv.yaml という名前の設定ファイルを作成します。これは、ホストマシン上のパスを pv001 という名前の PersistentVolume としてプロビジョニングします。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: pv0001
   spec:
     accessModes:
       - ReadWriteOnce
     capacity:
       storage: 2Mi
     hostPath:
       path: /data/pv0001/

   この例では、ホストパスは /data/pv0001 で、ストレージの容量が 2MB に制限されます。たとえば、OpenShift CDK を使用する場合は、OpenShift クラスターをホストする仮想マシンから /data/pv0001 ディレクトリーをプロビジョニングします。

2. PersistentVolume を作成します。

   oc create -f pv.yaml

3. PersistentVolume の作成を検証します。これは、OpenShift クラスターに設定されたすべての PersistentVolumes をリストします。

   oc get pv

手順

1. 以下のように、ファイルシステムで PersistentVolumeClaim pvc0001 を /usr/share/data にマウントするコンテナー設定の例を作成します。

   spec:
     template:
       spec:
         containers:
           - volumeMounts:
             - name: vol0001
               mountPath: /usr/share/data
         volumes:
           - name: vol0001
             persistentVolumeClaim:
               claimName: pvc0001

   アプリケーションによって /usr/share/data ディレクトリーに書き込まれたすべてのデータがコンテナーの再起動後も保持されるようになりました。

2. この設定を Fuse on OpenShift アプリケーションの src/main/fabric8/deployment.yml ファイルに追加し、以下のコマンドを使用して OpenShift リソースを作成します。

   mvn fabric8:resource-apply

3. 作成した DeploymentConfiguration にボリュームマウントとボリュームがあることを確認します。

   oc describe deploymentconfig <application-dc-name>

   Fuse on OpenShift クイックスタートでは、<application-dc-name> を Maven プロジェクト名 (例: spring-boot-camel) に置き換えます。

手順

1. 通常、Fuse on OpenShift イメージストリームは、OpenShift サーバーの openshift プロジェクトにインストールされます。OpenShift の Fuse on OpenShift イメージの状態をチェックするには、管理者として OpenShift にログインし、以下のコマンドを入力します。

   $ oc get is -n openshift
   NAME                             DOCKER REPO                                              TAGS                           UPDATED
   fuse7-console                    172.30.1.1:5000/openshift/fuse7-console                  1.0,1.1,1.2,1.3,1.4            About an hour ago
   fuse7-eap-openshift              172.30.1.1:5000/openshift/fuse7-eap-openshift            1.0,1.1,1.2,,1.3,1.4           About an hour ago
   fuse7-java-openshift             172.30.1.1:5000/openshift/fuse7-java-openshift           1.0,1.1,1.2,1.3,1.4            About an hour ago
   fuse7-karaf-openshift            172.30.1.1:5000/openshift/fuse7-karaf-openshift          1.0,1.1,1.2,1.3,1.4            About an hour ago...
   fuse-apicurito-generator         172.30.1.1:5000/openshift/fuse-apicurito-generator       1.2,1.3,1.4                    About an hour ago...
   apicurito-ui                     172.30.1.1:5000/openshift/apicurito-ui                   1.2,1.3,1.4                    About an hour ago...

2. 各イメージストリームを 1 つずつ更新できるようになりました。

   oc import-image -n openshift fuse7-java-openshift:1.4
   oc import-image -n openshift fuse7-karaf-openshift:1.4
   oc import-image -n openshift fuse7-eap-openshift:1.4
   oc import-image -n openshift fuse7-console:1.4
   oc import-image -n openshift apicurito-ui:1.4
   oc import-image -n openshift fuse-apicurito-generator:1.4

手順

1. Fuse on OpenShift テンプレートの更新には管理者権限が必要です。以下のように、OpenShift サーバーに管理者としてログインします。

   oc login URL -u ADMIN_USER -p ADMIN_PASS

   ここで、URL は OpenShift サーバーの URL に置き換え、ADMIN_USER および ADMIN_PASS には OpenShift サーバーの管理者アカウントのクレデンシャルを使用します。

2. パッチが適用された Fuse on OpenShift テンプレートをインストールします。コマンドプロンプトに以下のコマンドを入力します。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-amq-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-cdi-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-cxf-jaxrs-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-cxf-jaxws-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-jpa-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-camel-amq-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-camel-log-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-camel-rest-sql-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-cxf-rest-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-amq-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-config-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-drools-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-infinispan-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-xml-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-cxf-jaxrs-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-cxf-jaxws-template.json

   注記

   BASEURL は、クイックスタートテンプレートを格納する Git リポジトリーの GA ブランチを示し、常に最新のテンプレートが HEAD にあります。そのため、これらのコマンドを実行するたびに最新バージョンのテンプレートが取得されます。