5.3. JBoss EAP でのユーザー開発レイヤーのプロビジョニング

手順

1. 新しい Maven プロジェクトを作成するには、次のコマンドを実行します。

   mvn archetype:generate -DarchetypeGroupId=org.codehaus.mojo.archetypes -DarchetypeArtifactId=pom-root -DgroupId=org.example.mariadb -DartifactId=mariadb-galleon-pack -DinteractiveMode=false

2. ディレクトリー mariadb-galleon-pack で、pom.xml ファイルを更新して Red Hat Maven リポジトリーを含めます。

   <repositories>
     <repository>
       <id>redhat-ga</id>
       <name>Redhat GA</name>
       <url>https://maven.repository.redhat.com/ga/</url>
     </repository>
   </repositories>

3. pom.xml ファイルを更新して、EAP Galleon 機能パックと MariaDB ドライバーへの依存関係を追加します。

   <dependencies>
     <dependency>
       <groupId>org.jboss.eap</groupId>
       <artifactId>wildfly-ee-galleon-pack</artifactId>
       <version>7.4.4.GA-redhat-00011</version>
       <type>zip</type>
     </dependency>
     <dependency>
        <groupId>org.mariadb.jdbc</groupId>
        <artifactId>mariadb-java-client</artifactId>
        <version>3.0.5</version>
     </dependency>
   </dependencies>

4. pom.xml ファイルを更新して、Galeon 機能パックのビルドに使用される Maven プラグインを含めます。

   <build>            
       <plugins>
            <plugin>
                <groupId>org.wildfly.galleon-plugins</groupId>
                <artifactId>wildfly-galleon-maven-plugin</artifactId>
                <version>5.2.11.Final</version>
                <executions>
                    <execution>
                        <id>mariadb-galleon-pack-build</id>
                        <goals>
                            <goal>build-user-feature-pack</goal>
                        </goals>
                        <phase>compile</phase>
                    </execution>
                </executions>
            </plugin>
       </plugins>
   </build>

手順

1. カスタム機能パック Maven プロジェクト内に src/main/resources ディレクトリーを作成します。Maven プロジェクトの準備 を参照してください。このディレクトリーは、機能パックのコンテンツを含むルートディレクトリーです。
2. ディレクトリー src/main/resources/modules/org/mariadb/jdbc/main を 作成します。

3. main ディレクトリーに、次の内容の module.xml という名前のファイルを作成します。

   <?xml version="1.0" encoding="UTF-8"?>
   <module name="org.mariadb.jdbc" xmlns="urn:jboss:module:1.8">
      <resources>
          <artifact name="${org.mariadb.jdbc:mariadb-java-client}"/> 1
      </resources>
      <dependencies> 2
          <module name="javax.api"/>
          <module name="javax.transaction.api"/>
      </dependencies>
   </module>

   1

   MariaDB ドライバーの groupId と artifactId。プロビジョニング時に、実際のドライバー JAR ファイルがインストールされます。ドライバーのバージョンは、pom.xml ファイルから参照されます。

   2

   MariaDB ドライバーの JBoss Modules モジュールの依存関係。

4. ディレクトリー src/main/resources/layers/standalone/を 作成します。これは、ガレオン機能パックが定義しているすべてのレイヤーのルートディレクトリーです。
5. ディレクトリー src/main/resources/layers/standalone/mariadb-driver を 作成します。

6. mariadb-driver ディレクトリーで、次の内容で layer-spec.xml ファイルを作成します。

   <?xml version="1.0" ?>
   <layer-spec xmlns="urn:jboss:galleon:layer-spec:1.0" name="mariadb-driver">
    <feature spec="subsystem.datasources"> 1
          <feature spec="subsystem.datasources.jdbc-driver">
                <param name="driver-name" value="mariadb"/>
                <param name="jdbc-driver" value="mariadb"/>
                <param name="driver-xa-datasource-class-name" value="org.mariadb.jdbc.MariaDbDataSource"/>
                <param name="driver-module-name" value="org.mariadb.jdbc"/>
          </feature>
    </feature>
    <packages> 2
          <package name="org.mariadb.jdbc"/>
    </packages>
   </layer-spec>

   1

   モジュール org.mariadb.jdbc によって実装された MariaDB という名前の JDBC ドライバーを使用して、datasources サブシステムの設定を更新します。

   2

   レイヤーのプロビジョニング時にインストールされるドライバークラスを含む JBoss Modules モジュール。

   mariadb-driver レイヤーは、JBoss Modules モジュールによって実装された JDBC ドライバーの設定で datasources サブシステムを更新します。

7. ディレクトリー src/main/resources/layers/standalone/mariadb-datasource を作成します。

8. mariadb-datasource ディレクトリーで、次の内容で layer-spec.xml ファイルを作成します。

   <?xml version="1.0" ?>
   <layer-spec xmlns="urn:jboss:galleon:layer-spec:1.0" name="mariadb-datasource">
   <dependencies>
        <layer name="mariadb-driver"/> 1
   </dependencies>
       
   <feature spec="subsystem.datasources.data-source"> 2
          <param name="data-source" value="MariaDBDS"/>
          <param name="jndi-name" value="java:jboss/datasources/${env.MARIADB_DATASOURCE:MariaDBDS}"/>
          <param name="connection-url" value="jdbc:mariadb://${env.MARIADB_HOST:localhost}:${env.MARIADB_PORT:3306}/${env.MARIADB_DATABASE}"/> 3
          <param name="driver-name" value="mariadb"/>
          <param name="user-name" value="${env.MARIADB_USER}"/>4
          <param name="password" value="${env.MARIADB_PASSWORD}"/>
   </feature>
   </layer-spec>

   1

   この依存関係により、データソースがプロビジョニングされるときに MariaDB ドライバーのプロビジョニングが強制されます。レイヤーが依存するすべてのレイヤーは、そのレイヤーがプロビジョニングされるときに自動的にプロビジョニングされます。

   2

   MariaDBDS という名前のデータソースを使用してデータソースサブシステム設定を更新します。

   3

   データソースの名前、ホスト、ポート、およびデータベースの値は、サーバーの起動時に設定される環境変数 MARIADB_DATASOURCE、MARIADB_HOST、MARIADB_PORT、および MARIADB_DATABASE から解決されます。

   4

   ユーザー名とパスワードの値は、環境変数 MARIADB_USER および MARIADB_PASSWORD から解決されます。

9. 次のコマンドを実行して、Galeon 機能パックをビルドします。

   mvn clean install

   ファイル target/mariadb-galleon-pack-1.0-SNAPSHOT.zip が作成されます。

手順

1. 次のコマンドを実行して、MariaDB データベースを開始します。

   oc new-app -e MYSQL_USER=admin -e MYSQL_PASSWORD=admin -e MYSQL_DATABASE=mariadb registry.redhat.io/rhscl/mariadb-101-rhel7

   OpenShift サービス mariadb-101-rhel7 が作成され、開始されます。

2. Maven プロジェクトディレクトリー mariadb-galleon-pack 内で次のコマンドを実行して、カスタム機能パック Maven ビルドによって生成された機能パック ZIP アーカイブからシークレットを作成します。

   oc create secret generic mariadb-galleon-pack --from-file=target/mariadb-galleon-pack-1.0-SNAPSHOT.zip

   秘密の mariadb-galleon-pack が作成されます。S2I ビルドを開始するときに、このシークレットを使用してフィーチャーパックの .zip ファイルを Pod にマウントし、サーバーのプロビジョニングフェーズでファイルを使用できるようにします。

3. 新しい OpenShift ビルドを作成して、Galleon でトリミングされたサーバー内で実行される todo-backend クイックスタートデプロイメントを含むアプリケーションイメージをビルドするには、次のコマンドを実行します。

   oc new-build jboss-eap74-openjdk11-openshift:latest~https://github.com/jboss-developer/jboss-eap-quickstarts#EAP_7.4.0.GA \
   --context-dir=todo-backend \
   --env=GALLEON_PROVISION_FEATURE_PACKS="org.example.mariadb:mariadb-galleon-pack:1.0-SNAPSHOT" \ 1
   --env=GALLEON_PROVISION_LAYERS="jaxrs-server,mariadb-datasource" \ 2
   --env=GALLEON_CUSTOM_FEATURE_PACKS_MAVEN_REPO="/tmp/repo" \ 3
   --env=MAVEN_ARGS_APPEND="-Dcom.redhat.xpaas.repo.jbossorg" \
   --build-secret=mariadb-galleon-pack:/tmp/repo/org/example/mariadb/mariadb-galleon-pack/1.0-SNAPSHOT \ 4
   --name=todos-app-build

   1

   機能パックの Maven 座標のコンマ区切りリストを含むカスタム機能パック環境変数 (groupId:artifactId:version など)。

   2

   サーバーのプロビジョニングに使用される Galleon レイヤーのセット。jaxrs-server は基本サーバー層で、mariadb-datasource は MariaDB ドライバーと新しいデータソースをサーバーインストールにもたらすカスタム層です。

   3

   MariaDB 機能パックを含むイメージ内のローカル Maven リポジトリーの場所。このリポジトリーは、イメージ内にシークレットをマウントするときに設定されます。

   4

   mariadb-galleon-pack シークレットは、/tmp/repo/org/example/mariadb/mariadb-galleon-pack/1.0-SNAPSHOT ディレクトリーにマウントされます。

4. 作成した OpenShift ビルドから新しいビルドを開始するには、次のコマンドを実行します。

   oc start-build todos-app-build

   コマンドが正常に実行されると、イメージ todos-app-build が作成されます。

5. 新しいデプロイメントを作成するには、次のコマンドを実行して、実行中の MariaDB データベースにデータソースをバインドするために必要な環境変数を指定します。

   oc new-app --name=todos-app todos-app-build \
   --env=MARIADB_PORT=3306 \
   --env=MARIADB_USER=admin \
   --env=MARIADB_PASSWORD=admin \
   --env=MARIADB_HOST=mariadb-101-rhel7 \
   --env=MARIADB_DATABASE=mariadb  \
   --env=MARIADB_DATASOURCE=ToDos 1

   1

   クイックスタートでは、データソースの名前が ToDos であることを想定しています。

   注記

   カスタム Galleon 機能パック環境変数の詳細は、カスタム Galleon 機能パック環境変数 を参照してください。

6. todos-app アプリケーションを公開するには、次のコマンドを実行します。

   oc expose svc/todos-app

7. 新しいタスクを作成するには、次のコマンドを実行します。

   curl -X POST http://$(oc get route todos-app --template='{{ .spec.host }}') \
      -H 'Content-Type: application/json' \
      -d '{"title":"todo1"}'

8. タスクのリストにアクセスするには、次のコマンドを実行します。

   curl http://$(oc get route todos-app --template='{{ .spec.host }}')

   追加されたタスクがブラウザーに表示されます。