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 文件，使其包含用于构建 Galleon feature-pack 的 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 项目。该目录是包含 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="javax.api"/>
          <module name="javax.transaction.api"/>
      </dependencies>
   </module>

   1

   MariaDB 驱动程序 groupId 和 artifactId。在调配时，将安装实际的驱动程序 jar 文件。驱动程序的版本从 pom.xml 文件引用。

   2

   MariaDB 驱动程序的 JBoss 模块模块依赖项。

4. 创建 src/main/resources/layers/standalone/ 目录。这是 Galleon 功能包定义的所有层的根目录。
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-driver 更新 datasources 子sytem 配置，由模块 org.mariadb.jdbc 实施。

   2

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

   mariadb-driver 层使用由 JBoss 模块模块 实施的 JDBC 驱动程序配置更新数据源子系统。

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. 运行以下命令构建 Galleon 功能包：

   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 service mariadb-rhcsrhel7 已创建并启动。

2. 在 Maven 项目目录 mariadb-galleon-pack 中运行以下命令来从 feature-pack ZIP 归档创建 secret，由自定义 feature-pack Maven 构建生成：

   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 文件，以便在服务器置备阶段提供该文件。

3. 要创建新的 OpenShift 构建来构建包含通过 Galleon 修剪的服务器内的 todo-backend quickstart 部署的应用程序镜像，请运行以下命令：

   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 协调列表的自定义 feature-pack 环境变量，如 groupId:artifactId:version。

   2

   用于置备服务器的 Galleon 层集合。jaxrs-server 是一个基本的服务器层，mariadb-datasource 是自定义层，它会将 MariaDB 驱动程序和新的数据源引入到服务器安装。

   3

   包含 MariaDB 功能包的镜像中本地 Maven 存储库的位置。在镜像中挂载 secret 时，此软件仓库会被填充。

   4

   mariadb-galleon-pack secret 挂载到 /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

   Quickstart 期望数据源命名为 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 }}')

   添加的任务显示在浏览器中。