8.2. JBoss EAP でのユーザーによるレイヤーのプロビジョニング

手順

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

   mvn archetype:generate -DarchetypeGroupId=org.codehaus.mojo.archetypes -DarchetypeArtifactId=pom-root -DgroupId=org.jboss.eap.demo -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 ファイルを更新して、JBoss EAP Galleon 機能パックと MariaDB ドライバーへの依存関係を追加します。

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

   注記
   • <version>A.B.C-redhat-XXXXX</version> A.B.C はリリース番号、XXXXX は JBoss EAP インスタンスのビルド番号です。JBoss EAP リリースのバージョンの詳細は、Red Hat Maven リポジトリーを参照してください。リリース番号とビルド番号は、すべての JBoss EAP リリースで利用できます。https://maven.repository.redhat.com/earlyaccess/all/org/jboss/eap/wildfly-ee-galleon-pack/.

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

   <build>
     <plugins>
       <plugin>
         <groupId>org.wildfly.galleon-plugins</groupId>
         <artifactId>wildfly-galleon-maven-plugin</artifactId>
         <version>6.4.8.Final-redhat-00001</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="java.se"/>
       <module name="jakarta.transaction.api"/>
       <module name="jdk.net"/>
     </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 という名前のデータソースで datasources サブシステム設定を更新します。

   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 データベースを開始します。この例では、MariaDB image mariadb-105-rhel7 を使用します。サポートされている最新バージョンの MariaDB イメージを使用する必要があります。MariaDB images の詳細は、Red Hat Ecosystem Catalog を参照してください。

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

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

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

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

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

手順

1. JBoss EAP 8.0 イメージストリームをインポートします。

   oc import-image jboss-eap-8/eap8-openjdk17-builder-openshift-rhel8:latest --from=registry.redhat.io/jboss-eap-8/eap8-openjdk17-builder-openshift-rhel8:latest
   --confirm