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 feature-pack 和 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 文件，使其包含用于构建 Galleon feature-pack 的 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. 在自定义 feature-pack Maven 项目中创建目录 src/main/resources，例如，请参阅 准备 Maven 项目。此目录是包含 feature-pack 内容的根目录。
2. 创建 src/main/resources/modules/org/mariadb/jdbc/main 目录。

3. 在 主目录中，使用以下内容创建一个名为 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 模块模块依赖项。

4. 创建 src/main/resources/layers/standalone/ 目录。这是 Galleon feature-pack 定义的所有层的根目录。
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

   使用名为 MariaDB 的 JDBC 驱动程序更新 datasources 子系统配置，由模块 org.mariadb.jdbc 来实施。

   2

   包含置备层时安装的驱动程序类的 JBoss 模块模块。

   mariadb-driver 层使用通过 JBoss 模块模块 实施的 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. 运行以下命令来构建 Galleon 功能包：

   mvn clean install

   文件 target/mariadb-galleon-pack-1.0-SNAPSHOT.zip 被创建。

流程

1. 运行以下命令来启动 MariaDB 数据库。本例使用 MariaDB 镜像 mariadb-105-rhel7。您必须使用最新支持的 MariaDB 镜像版本。请参阅 红帽生态系统目录 以获取有关 MariaDB 镜像 的更多信息。

   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. 通过自定义 feature-pack Maven 构建生成的 feature-pack Maven 构建，在 Maven 项目目录 mariadb-galleon-pack 中运行以下命令来创建一个 secret：

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

   secret mariadb-galleon-pack 已创建。在启动 S2I 构建时，此机密用于在 pod 中挂载 feature-pack .zip 文件，使文件在服务器调配阶段可用。

流程

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