最初に、実行中の Pod に対してリモートシェルセッションを開きます。

$ oc rsh <pod_name>

次に、リモートシェルセッションから以下を実行し、JBoss EAP 管理 CLI を起動します。

$ /opt/eap/bin/jboss-cli.sh

Realtime Decision Server for OpenShift デプロイメントに使用されるサービスアカウントを作成します。

$ oc create serviceaccount <service-account-name>

表示 (view) ロールをサービスアカウントに追加します。これにより、サービスアカウントを使い、OpenShift のアプリケーションの名前空間にあるすべてのリソースを表示することができます。これは、クラスターの管理に必要となります。

$ oc policy add-role-to-user view system:serviceaccount:<project-name>:<service-account-name>

プロジェクト用に作成されたシークレットをサービスアカウントに追加します。

$ oc secret add sa/<service-account-name> secret/<secret-name>

pom.xml はリモートリポジトリーを使用するよう設定し、OpenShift がこれにアクセスできるようする必要があります。

...
<distributionManagement>
  <repository>
    <id>deployment</id>
    <name>OpenShift Maven repo</name>
    <url>http://maven.example/deployment/filepath/</url>
  </repository>

  <snapshotRepository>
    <id>deployment</id>
    <name>OpenShift Maven repo</name>
    <url>http://maven.example/snapshots/filepath/</url>
  </snapshotRepository>
</distributionManagement>
...

詳細は、『Red Hat JBoss BRMS Administration and Configuration Guide』を参照してください。

configuration/settings.xml ファイルではリモートリポジトリーを定義し、OpenShift がアプリケーションのアーティファクトをダウンロードできるようにする必要があります。

...
<profiles>
  <profile>
    <id>openshift-mirror-repositories</id>
    <repositories>
      <repository>
        <id>openshift-mirror</id>
        <url>http://maven.example/public/filepath/</url>
      </repository>
    </repositories>

    <pluginRepositories>
      <pluginRepository>
        <id>openshift-mirror</id>
        <url>http://maven.example/public/filepath/</url>
      </pluginRepository>
    </pluginRepositories>
  </profile>
</profiles>
...

詳細は、『Red Hat JBoss BRMS Installation Guide』を参照してください。

非表示の .s2i/environment ファイルは、使用する KIE jar を含む KIE コンテナーのデプロイメントと、それらを取得する場所を定義します。OpenShift がビルドされたイメージをデプロイする際に、Pod 名はこのファイルで定義されるデプロイメントのエイリアスから派生した名前になります。

KIE_CONTAINER_DEPLOYMENT=<alias>=<group_id>:<artifact_id>:<version>

例:

KIE_CONTAINER_DEPLOYMENT=RulesTest=com.example.openshift:example_workflow:1.0

ソースリポジトリーに pom.xml ファイルがある場合、Maven ビルドが $MAVEN_ARGS 環境変数の内容でトリガーされます。

正常な Maven ビルドの結果はローカル Maven リポジトリー /home/jboss/.m2/repository/ に、オフライン使用のためのすべての依存関係と共にインストールされます。Realtime Decision Server for OpenShift はこのローカルリポジトリーから作成済みの kjar を読み込みます。

configuration ソースリポジトリーにあるすべてのファイルは EAP_HOME/standalone/configuration にコピーされます。

アプリケーションアーカイブの取得またはアプリケーションのローカルビルド

以下の例では、hellorules と hellorules-client のクイックスタートを使用しています。

ローカルファイルシステムでのディレクトリー構造の作成

メインのバイナリービルドディレクトリーの deployments/ サブディレクトリーにあるアプリケーションアーカイブは、OpenShift にビルドされるイメージの 標準デプロイメントフォルダー に直接コピーされます。デプロイするアプリケーションについては、web アプリケーションデータを含むディレクトリー階層を適切に構成する必要があります。

ローカルファイルシステムにバイナリービルドのメインディレクトリーとその中に入る deployments/ サブディレクトリーを作成します。事前にビルドされた hellorules クイックスタートの JAR アーカイブと hellorules-client クイックスタート の WAR アーカイブの両方を deployments/ サブディレクトリーにコピーします。

decisionserver]$ ls
hellorules  hellorules-client  pom.xml

$ mkdir -p ocp/deployments

$ cp hellorules/target/decisionserver-hellorules-1.4.0.Final.jar ocp/deployments/

$ cp hellorules-client/target/decisionserver-hellorules-client-1.4.0.Final.war ocp/deployments/

OpenShift インスタンスにログインします。

$ oc login

新規プロジェクトを作成します。

$ oc new-project ds-bin-demo

(オプション) 特定イメージのイメージストリームを識別します。

$ oc get is -n openshift | grep ^jboss-decisionserver | cut -f1 -d ' '
jboss-decisionserver62-openshift
jboss-decisionserver63-openshift

イメージストリームおよびアプリケーション名を指定して、新規のバイナリービルドを作成します。

$ oc new-build --binary=true \
--name=ds-hr-app \
--image-stream=jboss-decisionserver63-openshift \
-e KIE_SERVER_USER=kieserveruser \
-e KIE_SERVER_PASSWORD=kieserverPwd1!
--> Found image 4a6c0ce (5 weeks old) in image stream "jboss-decisionserver63-openshift" in project "openshift" under tag "latest" for "jboss-decisionserver63-openshift"

    JBoss BRMS Realtime Decision Server 6.3
    ---------------------------------------
    Platform for executing business rules on JBoss BRMS Realtime Decision Server 6.3.

    Tags: builder, decisionserver, decisionserver6

    * A source build using binary input will be created
      * The resulting image will be pushed to image stream "ds-hr-app:latest"
      * Use 'start-build --from-dir=DIR|--from-repo=DIR|--from-file=FILE' to trigger a new build
      * WARNING: a binary build was created, you must specify one of --from-dir|--from-file|--from-repo when starting builds

--> Creating resources with label build=ds-hr-app ...
    imagestream "ds-hr-app" created
    buildconfig "ds-hr-app" created
--> Success

バイナリービルドを開始します。oc 実行可能プログラムに対し、前述の手順 で作成したバイナリービルドのメインディレクトリーを、OpenShift ビルドのバイナリー入力を含むバイナリーとして使用するように指示します。

$ oc start-build ds-hr-app --from-dir=./ocp/ --follow
Uploading directory "ocp" as binary input for the build ...
build "ds-hr-app-1" started
Receiving source from STDIN as archive ...

Copying all war artifacts from /home/jboss/source/. directory into /opt/eap/standalone/deployments for later deployment...
Copying all ear artifacts from /home/jboss/source/. directory into /opt/eap/standalone/deployments for later deployment...
Copying all rar artifacts from /home/jboss/source/. directory into /opt/eap/standalone/deployments for later deployment...
Copying all jar artifacts from /home/jboss/source/. directory into /opt/eap/standalone/deployments for later deployment...
Copying all war artifacts from /home/jboss/source/deployments directory into /opt/eap/standalone/deployments for later deployment...
'/home/jboss/source/deployments/decisionserver-hellorules-client-1.4.0.Final.war' -> '/opt/eap/standalone/deployments/decisionserver-hellorules-client-1.4.0.Final.war'
Copying all ear artifacts from /home/jboss/source/deployments directory into /opt/eap/standalone/deployments for later deployment...
Copying all rar artifacts from /home/jboss/source/deployments directory into /opt/eap/standalone/deployments for later deployment...
Copying all jar artifacts from /home/jboss/source/deployments directory into /opt/eap/standalone/deployments for later deployment...
'/home/jboss/source/deployments/decisionserver-hellorules-1.4.0.Final.jar' -> '/opt/eap/standalone/deployments/decisionserver-hellorules-1.4.0.Final.jar'
/opt/eap/standalone/deployments/decisionserver-hellorules-1.4.0.Final.jar is a kjar
...
INFO: org.openshift.quickstarts:decisionserver-hellorules:1.4.0.Final verified.


Pushing image 172.30.202.111:5000/ds-bin-demo/ds-hr-app:latest ...
Pushed 6/9 layers, 67% complete
Pushed 7/9 layers, 78% complete
Pushed 8/9 layers, 89% complete
Pushed 9/9 layers, 100% complete
Push successful

ビルドをベースにして新規の OpenShift アプリケーションを作成します。

$ oc new-app ds-hr-app
--> Found image c2c182e (48 seconds old) in image stream ds-hr-app under tag "latest" for "ds-hr-app"

    ds-bin-demo/ds-hr-app-2:ea504dd7
    --------------------------------
    Platform for executing business rules on JBoss BRMS Realtime Decision Server 6.3.

    Tags: builder, decisionserver, decisionserver6

    * This image will be deployed in deployment config "ds-hr-app"
    * Ports 8080/tcp, 8443/tcp, 8778/tcp will be load balanced by service "ds-hr-app"
      * Other containers can access this service through the hostname "ds-hr-app"

--> Creating resources with label app=ds-hr-app ...
    deploymentconfig "ds-hr-app" created
    service "ds-hr-app" created
--> Success
    Run 'oc status' to view your app.

サービスをルートとして公開します。

$ oc get svc -o name
service/ds-hr-app

$ oc expose svc/ds-hr-app
route "ds-hr-app" exposed

アプリケーションにアクセスします。

URL の http://ds-hr-app-ds-bin-demo.openshift.example.com/hellorules/ にアクセスして、hellorules アプリケーションの利用可能なクエリー文字列の引数一覧を取得できます。

URL の http://ds-hr-app-ds-bin-demo.openshift.example.com/hellorules?command=runLocal を使用して hellorules-client サーブレットを実行します。

新規プロジェクトを作成します。

$ oc new-project rds-app-demo

Decision Server アプリケーションのデプロイメントに使用されるサービスアカウントを作成します。

$ oc create serviceaccount rds-service-account

表示 (view) ロールをサービスアカウントに追加します。これにより、サービスアカウントを使って、rds-app-demo 名前空間にあるすべてのリソースを表示できます。これは、クラスターの管理に必要です。

$ oc policy add-role-to-user view system:serviceaccount:rds-app-demo:rds-service-account

Decision Server テンプレートには SSL キーストアおよび JGroups キーストアが必要です。
これらのキーストアは、アプリケーションが https を使用しない場合にも使用されることが予想されます。
この例では、Java Development Kit に含まれるパッケージ「keytool」を使用して、これらのキーストアの自己署名型の証明書を生成します。以下のコマンドはパスワードを求めるプロンプトを出します。

SSL および JGroup キーストアファイルを使用してプロジェクトのシークレットを作成します。

$ oc create secret generic rds-app-secret --from-file=jgroups.jceks --from-file=keystore.jks

シークレットを先に作成したサービスアカウントに追加します。

$ oc secret add sa/rds-service-account secret/rds-app-secret

リポジトリーをフォーク します。

新規のフォークにリダイレクトされます。

Clone をクリックします。

クローンが作成されると、リポジトリーはコミット履歴を表示します。

コマンドラインから、先にフォークしたプロジェクトの /.niogit ディレクトリーに移動します。

$ cd EAPHOME/bin/.niogit/decision-services.git

上記のパスはデフォルトであり、これはデータの保存先として設定したワークベンチの場所によって異なる場合があります。この場所は、org.uberfire.nio.git.dir システムプロパティーを使用して設定されます。

このプロジェクトにリモート URL を設定します。

$ git remote set-url origin git@github.com:/decisionserver

フックのディレクトリーに移動します。

$ cd hooks

単純な post-commit ファイルを作成します。

$ touch post-commit

ファイルを編集し、以下を入力します。

#!/bin/sh

git push origin master

ファイルのパーミッションを変更し、Red Hat JBoss BRMS に必要なアクセスを付与します。

$ chmod 777 post-commit

フックの設定が行われました。この Red Hat JBoss BRMS プロジェクトのファイルへの変更により、フォークした decisionserver GitHub リポジトリーが自動的に更新されることになります。

DRL の下で、クリックして HelloRules.drl ファイルを読み込みます。

package org.openshift.quickstarts.decisionserver.hellorules

query "get greeting"()
    greeting : Greeting()
end

rule "greet master"
    when
        person : Person( name == "john")
    then
        String salutation = "Hello " + person.getName() + "! What can I help you with today?";
        insert(new Greeting(salutation));
end
rule "greet strangers"
    when
        person : Person(name != "john")
    then
        String salutation = "Hey there " + person.getName() + ". I don't think I know you yet!";
        insert(new Greeting (salutation));
end

Save をクリックし、コメントにチェックして Save を再度クリックします。

先に作成したフックにより、フォークした GitHub リポジトリーが保存した変更で自動的に更新されます。

Create をクリックします。

web コンソールの welcome 画面が読み込まれます。

SOURCE_REPOSITORY_URL を、フォークされたリポジトリーの Git ソース URI に変更します。以下が例になります。

https://github.com/<your_github_username>/decisionserver.git

MAVEN_MIRROR_URL 環境変数を、KIE_CONTAINER_DEPLOYMENT 変数の下に追加します。

strategy
 sourceStrategy:
  env:
   -
    name: KIE_CONTAINER_DEPLOYMENT
    value: 'HelloRulesContainer=org.openshift.quickstarts:decisionserver-hellorules:1.2.0.Final'
   -
    name: MAVEN_MIRROR_URL
    value: 'http://nexus-ci.cloudapps.bos.openshift3roadshow.com/content/groups/public/'

MAVEN_MIRROR_URL の値は、リポジトリーを表示し、公開リポジトリーグループのパスをコピーして Maven で確認できます。

新規ビルドがローカルへのダウンロードに新規の Maven プロキシーを使用していることを確認します。これは、Downloading を参照するログの行を見つけて確認できます。たとえば、以下のようになります。

I0130 12:32:25.664594     1 sti.go:492] Downloading: http://nexus-ci.cloudapps.openshift.com/content/groups/public/org/kie/kie-maven-plugin/6.3.0.Final-redhat-5/kie-maven-plugin-6.3.0.Final-redhat-5.pom

HelloRules.drl ファイルを読み込みます。

package org.openshift.quickstarts.decisionserver.hellorules

query "get greeting"()
    greeting : Greeting()
end

rule "greet master"
    when
        person : Person( name == "john")
    then
        String salutation = "Hello " + person.getName() + "! What can I help you with today?";
        insert(new Greeting(salutation));
end
rule "greet strangers"
    when
        person : Person(name != "john")
    then
        String salutation = "Hey there " + person.getName() + ". I don't think I know you yet!";
        insert(new Greeting (salutation));
end