1. Docker Login タブを選択し、コマンドをコピーします。
2. registry.redhat.io からプルする各ホストで docker login コマンドを実行します。

3. Docker 設定を確認します。

   $ cat ~/.docker/config.json
   ...
   "registry.redhat.io": {
   			"auth": "MTEwMDkx..."
   		}

1. OpenShift クラスターにログインします。

2. 以下のように、作業プロジェクトを選択します。

   $ oc project rhdg-helloworld

3. Docker 設定で汎用のプルシークレットを作成します。

   $ oc create secret generic ${SECRET_NAME} \
     --from-file=.dockerconfigjson=path/to/.docker/config.json \
     --type=kubernetes.io/dockerconfigjson

4. プルシークレットをサービスアカウントにリンクします。

   $ oc secrets link default ${SECRET_NAME} --for=pull

5. シークレットをマウントします。

   $ oc secrets link builder ${SECRET_NAME}

手順

1. Data Grid Pod から service-ca.crt を取得します。

   $ oc rsync ${pod_name}:/var/run/secrets/kubernetes.io/serviceaccount/..data/service-ca.crt .

2. REST の呼び出し時に service-ca.crt を渡します。

   curl -X PUT \
     -u ${USERNAME}:${PASSWORD} \
     --cacert service-ca.crt \
     -H 'Content-type: text/plain' \
     -d 'world' \
     https://${HOSTNAME_FOR_HTTPS_ROUTE}/rest/default/hello

1. openshift.DNS_PING を JGROUPS_PING_PROTOCOL 環境変数の値として設定します。

   JGROUPS_PING_PROTOCOL=openshift.DNS_PING

2. クラスターの ping サービスの名前を OPENSHIFT_DNS_PING_SERVICE_NAME 環境変数の値として指定します。

   OPENSHIFT_DNS_PING_SERVICE_NAME=${PING_SERVICE_NAME}

3. ping サービスを OPENSHIFT_DNS_PING_SERVICE_PORT 環境変数の値として公開するポート番号を指定します。デフォルト値は 8888 です。

   OPENSHIFT_DNS_PING_SERVICE_PORT=${PING_SERVICE_NAME}

4. 以下の例のように、ping ポートを公開する ping サービスを定義します。

   apiVersion: v1
   kind: Service
   spec:
     clusterIP: None
     ports:
       - name: ping
         port: 8888
         protocol: TCP
         targetPort: 8888
     selector: deploymentConfig=datagrid-service
   metadata:
     annotations:
       description: The JGroups ping port for clustering.
       service.alpha.kubernetes.io/tolerate-unready-endpoints: 'true'

   重要

   clusterIP: None を設定して、サービスがヘッドレスになるようにする必要があります。同様に、ping ポートの名前を指定して、service.alpha.kubernetes.io/tolerate-unready-endpoints: 'true' アノテーションを追加する必要があります。

1. openshift.KUBE_PING を JGROUPS_PING_PROTOCOL 環境変数の値として設定します。

   JGROUPS_PING_PROTOCOL=openshift.KUBE_PING

2. OpenShift プロジェクト名を OPENSHIFT_KUBE_PING_NAMESPACE 環境変数の値として指定します。この変数を設定しない場合には、サーバーは単一ノードのクラスターのように動作します。

   OPENSHIFT_KUBE_PING_NAMESPACE=${PING_NAMESPACE}

3. OPENSHIFT_KUBE_PING_LABELS 環境変数でクラスターラベルを指定します。この変数を設定しない場合には、アプリケーションの外部ではあるが、同じ namespace 内にある Pod が参加使用とします。

   OPENSHIFT_KUBE_PING_LABELS=labelKey=labelValue

4. Kubernetes REST API にアクセスできるように、Pod が実行されているサービスアカウントに認可を付与します。たとえば、以下のように datagrid-service-account に認可を付与します。

   oc policy add-role-to-user view \
     system:serviceaccount:$(oc project -q):datagrid-service-account \
     -n $(oc project -q)

5. ポート 8888 が Pod コンテナーの ping ポートとして定義されていることを確認します。

   ports:
       - containerPort: 8888
         name: ping
         protocol: TCP

1. トラフィックを暗号化する認証情報を含めて JGroups キーストア(.jceks)を作成します。

   Java keytool を使用して JGroups キーストアを生成できます。

2. JGroups キーストアをシークレットとして OpenShift にデプロイします。

   1. OpenShift クラスターにログインします。

   2. JGroups キーストアのシークレットを作成します。たとえば、名前が jgroups.jceks のキーストアから jgroups-secret という名前のシークレットを作成するには、以下を実行します。

      $ oc create secret generic jgroups-secret \
        --from-file=jgroups.jceks

   3. シークレットをデフォルトのサービスアカウントにリンクします。

      $ oc secrets link default jgroups-secret

   4. シークレットをコンテナーにマウントします。

      $ oc set volumes dc/datagrid \
        --add -t secret \
        --secret-name='jgroups-secret' \
        --mount-path='/keystores/jgroups'

3. クラスター内のノードごとに、JGROUPS_ENCRYPT_PROTOCOL 環境変数の値を SYM_ENCRYPT に設定します。

4. 以下の環境変数と JGroups キーストアを使用するように、クラスターの各ノードを設定します。

   JGROUPS_ENCRYPT_KEYSTORE

   クラスタートラフィックを暗号化するために JGroups キーストアを指定します。

   JGROUPS_ENCRYPT_KEYSTORE_DIR

   JGroups キーストアが存在するディレクトリーを指定します。

   JGROUPS_ENCRYPT_SECRET

   キーストアの OpenShift シークレットと同じものを指定します。

   JGROUPS_ENCRYPT_NAME

   キーストアのユーザー名と同じものを指定します。

   JGROUPS_ENCRYPT_PASSWORD

   キーストアのパスワードと同じものを指定します。

5. 必要な場合は、JGROUPS_CLUSTER_PASSWORD 環境変数でクラスターへの参加時に使用するノードのパスワードを設定します。

1. JGROUPS_CLUSTER_PASSWORD 環境変数で認証を設定します。
2. クラスター内のノードごとに、JGROUPS_ENCRYPT_PROTOCOL 環境変数を ASYM_ENCRYPT に設定します。

1. Data Grid for OpenShift イメージが利用可能かどうかを確認します。

   $ oc get images | grep jboss-datagrid73-openshift

2. イメージが利用できない場合は、イメージストリームを作成してインポートします。

   $ oc create -f https://raw.githubusercontent.com/jboss-container-images/jboss-datagrid-7-openshift-image/7.3-v1.9/templates/datagrid73-image-stream.json
   
   $ oc import-image jboss-datagrid73-openshift --from='registry.redhat.io/jboss-datagrid-7/datagrid73-openshift:1.9'

1. Data Grid for OpenShift イメージを使用して、新しいバイナリービルドを作成します。

   $ oc new-build jboss-datagrid73-openshift:1.9 --binary=true --name=custom-datagrid

2. --from-dir="." を指定できるように、s2i ディレクトリーに移動します。S2I プロセスがカスタム設定を検出できるように、configuration ディレクトリーを追加する必要があります。

   設定例を使用するには、以下を行います。

   $ cd jboss-datagrid-7-openshift-image/docs/examples/s2i/

3. カスタム設定で Data Grid for OpenShift イメージをビルドします。

   $ oc start-build custom-datagrid --from-dir="." --follow
   
   Uploading directory "." as binary input for the build ...
   
   ...
   Push successful

4. イメージが利用可能であることを確認します。

   $ oc get images | grep custom-datagrid

1. ビルド Pod が実行されていることを確認します。

   $ oc get pods
   
   NAME                      READY     STATUS      RESTARTS   AGE
   custom-datagrid-1-build   0/1       Completed   0          38s

2. カスタム設定で Data Grid アプリケーションを作成します。

   $ oc new-app custom-datagrid \
     -p APPLICATION_USER=${USERNAME} \
     -p APPLICATION_PASSWORD=${PASSWORD}

3. カスタムの Data Grid アプリケーションが実行を開始するまで待機します。

   $ oc get pods -w
   
   NAME                      READY     STATUS         RESTARTS   AGE
   custom-datagrid-1-build   0/1       Completed      0          8m
   custom-datagrid-1-<id>   1/1       Running        0          11s

4. カスタム Data Grid Pod の bash シェルにリモートでアクセスします。

   $ oc exec -it ${pod-name} -- /bin/bash

5. 以下のように clustered-openshift.xml を表示して、設定を確認します。

   $ cat /opt/datagrid/configuration/clustered-openshift.xml

   clustered-openshift.xml にカスタム設定が含まれる場合は、Data Grid Pod はそれを使用します。必要に応じて、以下のように、Data Grid コマンドラインインターフェースを使用して、設定を確認できます。

   $ /opt/datagrid/bin/cli.sh -c

6. 設定を確認してから、リモートセッションを終了します。

   $ exit

1. カスタムの Data Grid アプリケーションが実行を開始するまで待機します。

   $ oc get pods -w
   
   NAME                READY     STATUS    RESTARTS   AGE
   user-config-0   0/1       Running   7          17m

2. コンテナーログを確認します。

   $ oc logs ${pod-name} | grep standalone.xml
   
   INFO Running jboss-datagrid-7/datagrid73-openshift image, version 1.9 with user standalone.xml

1. イメージテンプレート JSON で CUSTOM_INSTALL_DIRECTORIES 環境変数を指定します。この変数は、以下の例のように S2I アーティファクトの場所を定義します。

   {
       "name": "CUSTOM_INSTALL_DIRECTORIES",
       "value": "extensions/*"
   }

2. そのディレクトリーに install.sh スクリプトを作成します。このスクリプトは、イメージに外部データソースのモジュールおよびドライバーをインストールします。

   以下は、install.sh スクリプトの例になります。

   #!/bin/bash
   
   # Import the common functions for
   # installing modules and configuring drivers
   source /usr/local/s2i/install-common.sh
   
   # Directory where this script is located
   injected_dir=$1
   
   # Install the modules for the datasource
   install_modules ${injected_dir}/modules
   
   # Configure the drivers for the datasource
   configure_drivers ${injected_dir}/drivers.properties

3. データソースの module.xml ファイルとドライバーが含まれる modules サブディレクトリーを含めます。作成されたイメージはモジュールを使用してクラスを読み込み、依存関係を定義します。

   たとえば、外部データソースとして Derby を使用する計画を立てます。derby-10.12.1.1.jar などのドライバーを取得して、そのドライバーを modules/org/apache/derby/main/ ディレクトリーに配置する必要があります。

   同じディレクトリーで、リソースとしてドライバーを定義し、依存関係を宣言する module.xml ファイルも作成する必要があります。

   以下は module.xml ファイルの例になります。

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.3" name="org.apache.derby">
    <resources>
      <resource-root path="derby-10.12.1.1.jar"/>
      <resource-root path="derbyclient-10.12.1.1.jar"/>
    </resources>
   
    <dependencies>
      <module name="javax.api"/>
      <module name="javax.transaction.api"/>
    </dependencies>
   </module>

4. drivers.property 環境変数ファイルで、ドライバー設定プロパティーを定義します。

   以下は、drivers.property ファイルの例です。

   #DRIVERS
   DRIVERS=DERBY
   
   DERBY_DRIVER_NAME=derby
   DERBY_DRIVER_MODULE=org.apache.derby
   DERBY_DRIVER_CLASS=org.apache.derby.jdbc.EmbeddedDriver
   DERBY_XA_DATASOURCE_CLASS=org.apache.derby.jdbc.EmbeddedXADataSource

5. イメージのビルドおよびデプロイ後に、データソースの環境変数を指定します。

   次は、DATASOURCES 環境変数でのデータソースの定義例を示しています。

   # Set a unique prefix for the datasource
   DATASOURCES=ACCOUNTS_DERBY
   # Specify other environment variables using the prefix
   ACCOUNTS_DERBY_DATABASE=accounts
   ACCOUNTS_DERBY_JNDI=java:/accounts-ds
   ACCOUNTS_DERBY_DRIVER=derby
   ACCOUNTS_DERBY_JTA=true
   ACCOUNTS_DERBY_NONXA=false
   ACCOUNTS_DERBY_USERNAME=${USERNAME}
   ACCOUNTS_DERBY_PASSWORD=${PASSWORD}
   ACCOUNTS_DERBY_XA_CONNECTION_PROPERTY_DatabaseName=/opt/eap/standalone/data/databases/derby/accounts
   # _HOST and _PORT are required but not used
   ACCOUNTS_ORACLE_HOST=dummy
   ACCOUNTS_ORACLE_PORT=1527