11.9. 在 JBoss EAP OpenShift 平台上使用可引导 JAR

流程

1. 在 pom.xml 文件的 <build > 元素中添加以下内容。例如：

   <plugins>
   	<plugin>
   		<groupId>org.wildfly.plugins</groupId>
   		<artifactId>wildfly-jar-maven-plugin</artifactId>
   		<version>${bootable.jar.maven.plugin.version}</version>
   		<configuration>
   			<channels>
   				<channel>
   					<manifest>
   						<groupId>org.jboss.eap.channels</groupId>
   						<artifactId>eap-8.0</artifactId>
   					</manifest>
   				</channel>
   				<channel>
   					<manifest>
   						<groupId>org.jboss.eap.channels</groupId>
   						<artifactId>eap-xp-5.0</artifactId>
   					</manifest>
   				</channel>
   			</channels>
   			<feature-pack-location>org.jboss.eap.xp:wildfly-galleon-pack</feature-pack-location>
   			<layers>
   				<layer>jaxrs-server</layer>
   				<layer>microprofile-platform</layer>
   			</layers>
   			<cloud/>
   		</configuration>
   		<executions>
   			<execution>
   				<goals>
   					<goal>package</goal>
   				</goals>
   			</execution>
   		</executions>
   	</plugin>
   </plugins>

   注意

   您必须在插件配置的 < configuration> 元素中包含 <cloud /> 元素，因此 JBoss EAP Maven JAR 插件可以识别您选择的 OpenShift 平台。

2. 打包应用程序：

   $ mvn package

3. 使用 oc login 命令登录到您的 OpenShift 实例。

4. 在 OpenShift 中创建一个新项目。例如：

   $ oc new-project bootable-jar-project

5. 输入以下 oc 命令来创建应用程序镜像：

   $ mkdir target/openshift && cp target/microprofile-config-bootable.jar target/openshift  

   1

   
   
   $ oc import-image ubi8/openjdk-17 --from=registry.redhat.io/ubi8/openjdk-17 --confirm 

   2

   
   
   $ oc new-build --strategy source --binary --image-stream openjdk-17 --name microprofile-config-app 

   3

   
   
   $ oc start-build microprofile-config-app --from-dir target/openshift 

   4

   1

   在目标目录中创建 openshift 子目录。打包的应用程序被复制到创建的子目录中。

   2

   将最新的 OpenJDK 17 镜像流标签和镜像信息导入到 OpenShift 项目中。

   3

   根据 microprofile-config-app 目录和 OpenJDK 17 镜像流创建构建配置。

   4

   使用 target/openshift 子目录作为二进制输入来构建应用程序。

   注意

   OpenShift 将一组 CLI 脚本命令应用到可引导 JAR 配置文件，将其调整为云环境。您可以通过在 Maven 项目 / target 目录中 打开 bootable-jar-build-artifacts/generated-cli-script.txt 文件来访问此脚本。

6. 验证：

   运行以下命令，查看可用的 OpenShift pod 列表并检查 pod 构建状态：

   $ oc get pods

   验证构建的应用程序镜像：

   $ oc get is microprofile-config-app

   输出显示了构建的应用镜像详细信息，如名称和镜像存储库、标签等。对于此流程中的示例，镜像流名称和标签输出显示 microprofile-config-app:latest。

7. 部署应用程序：

   $ oc new-app microprofile-config-app
   
   $ oc expose svc/microprofile-config-app

   重要

   要为可引导 JAR 提供系统属性，您必须使用 JAVA_OPTS_APPEND 环境变量。以下示例演示了使用 JAVA_OPTS_APPEND 环境变量：

   $ oc new-app <_IMAGESTREAM_> -e JAVA_OPTS_APPEND="-Xlog:gc*:file=/tmp/gc.log:time -Dwildfly.statistics-enabled=true"

   新建应用已创建并启动。应用程序配置作为新服务公开。

8. 验证 ：在终端中运行以下命令来测试应用程序的行为：

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

   预期输出：

   {"result":"Hello jim"}