使用 JBoss EAP XP 5.0

流程

1. 打开终端模拟器，再导航到 jboss-eap-installation-manager 目录。

2. 从 jboss-eap-installation-manager 目录运行以下命令来安装 JBoss EAP XP：

   ./bin/jboss-eap-installation-manager.sh install --profile eap-xp-5.0 --dir eap-xp-5

   Copy to Clipboard Toggle word wrap

流程

1. 打开终端模拟器，再导航到 jboss-eap-installation-manager 目录。

2. 从 jboss-eap-installation-manager 目录运行此脚本，通过执行以下命令将服务器订阅到 JBoss EAP XP 频道：

   ./bin/jboss-eap-installation-manager.sh channel add \
    --channel-name eap-xp-5.0 \
    --repositories=mrrc-ga::https://maven.repository.redhat.com/ga \
    --manifest org.jboss.eap.channels:eap-xp-5.0 \
    --dir eap-xp-5.0

   Copy to Clipboard Toggle word wrap

3. 通过执行以下操作安装 JBoss EAP XP 扩展：

   ./bin/jboss-eap-installation-manager.sh feature-pack add \
    --fpl org.jboss.eap.xp:wildfly-galleon-pack \
    --dir eap-xp-5.0

   Copy to Clipboard Toggle word wrap

流程

1. 打开终端模拟器，再导航到 jboss-eap-installation-manager 目录。
2. 从 jboss-eap-installation-manager 目录运行此脚本，通过执行以下命令将服务器订阅到 JBoss EAP XP 频道：

1. 安装 JBoss EAP XP 并使用-- repositories 参数指定 离线存储库：

流程

1. 提取您下载的 jboss-eap-installation-manager。
2. 打开终端模拟器，再前往您提取的 jboss-eap-installation-manager 目录。

3. 从 jboss-eap-installation-manager 目录运行此脚本，以检查可用的更新：

   ./bin/jboss-eap-installation-manager.sh update list --dir eap-xp-5.0

   Copy to Clipboard Toggle word wrap

4. 运行以下命令来更新 JBoss EAP：

   语法

   ./bin/jboss-eap-installation-manager.sh update perform --dir eap-xp-5.0

   Copy to Clipboard Toggle word wrap

   Example

   ./bin/jboss-eap-installation-manager.sh update perform --dir eap-xp-5.0
   Updates found:
     org.wildfly.galleon-plugins:wildfly-galleon-plugins    6.3.1.Final-redhat-00001 ==>  6.3.2.Final-redhat-00001
     org.wildfly.wildfly-http-client:wildfly-http-transaction-client    2.0.1.Final-redhat-00001 ==>  2.0.2.Final-redhat-00001

   Copy to Clipboard Toggle word wrap

流程

1. 停止 JBoss EAP 服务器。
2. 打开终端模拟器，再导航到 jboss-eap-installation-manager 目录。

3. 从 jboss-eap-installation-manager 目录运行此脚本，以更新服务器组件：

   ./bin/jboss-eap-installation-manager.sh update perform \
    --dir eap-xp-5.0  \
    --repositories <JBOSS_EAP_XP_OFFLINE_REPO_PATH>,<FEATURE_PACK_OFFLINE_REPO>,<JBOSS_EAP_8.0_OFFLINE_REPO_PATH>

   Copy to Clipboard Toggle word wrap

流程

1. 打开终端模拟器，再导航到 jboss-eap-installation-manager 目录。

2. 从 jboss-eap-installation-manager 目录运行此脚本，以调查添加到 JBoss EAP XP 服务器的所有功能包的历史记录：

   ./bin/jboss-eap-installation-manager.sh history --dir eap-xp-5.0

   Copy to Clipboard Toggle word wrap
3. 停止 JBoss EAP XP 服务器。

4. 在添加 JBoss EAP XP 扩展前将您恢复到一个版本：

   ./bin/jboss-eap-installation-manager.sh revert perform \
    --revision <REVISION_HASH> \
    --dir eap-xp-5.0

   Copy to Clipboard Toggle word wrap

流程

1. 使用 mvn 命令设置 Maven 项目。该命令创建项目的目录结构以及 pom.xml 配置文件。

   $ mvn archetype:generate                       \
   -DgroupId=<group_id>                           \

   1

   
   -DartifactId=<artifact_id>                     \

   2

   
   -DarchetypeGroupId=org.apache.maven.archetypes \

   3

   
   -DarchetypeArtifactId=maven-archetype-webapp   \

   4

   
   -DinteractiveMode=false                         

   5

   Copy to Clipboard Toggle word wrap

   1

   GroupId 唯一标识项目。

   2

   artifactId 是生成的 jar 归档的名称。

   3

   archetypeGroupID 是 maven-archetype-webapp 的唯一 ID。

   4

   archetypeArtifactId 是 maven-archetype-webapp 的工件 ID。

   5

   InteractiveMode 指示 Maven 使用提供的参数，而不是以交互模式启动。

2. 进入生成的目录。
3. 在文本编辑器中打开生成的 pom.xml 配置文件。

4. 在 <name& gt; helloworld Maven Webapp</name> 行后，删除 pom.xml 配置文件的 <project > 部分的内容。

   确保该文件类似如下：

   <?xml version="1.0" encoding="UTF-8"?>
   
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>${group_id}</groupId>
       <artifactId>${artifact_id}</artifactId>
       <version>1.0-SNAPSHOT</version>
       <packaging>war</packaging>
       <name>${artifact_id} Maven Webapp</name>
   
   </project>

   Copy to Clipboard Toggle word wrap

   删除内容，因为应用程序不需要它。

流程

1. 定义 artifacts 存储库。

   <project>
       ...
       <repositories>
           <repository>                                                                

   1

   
               <id>jboss-public-maven-repository</id>
               <name>JBoss Public Maven Repository</name>
               <url>https://repository.jboss.org/nexus/content/groups/public/</url>
               <releases>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </snapshots>
               <layout>default</layout>
           </repository>
           <repository>                                                                

   2

   
               <id>redhat-ga-maven-repository</id>
               <name>Red Hat GA Maven Repository</name>
               <url>https://maven.repository.redhat.com/ga/</url>
               <releases>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </snapshots>
               <layout>default</layout>
           </repository>
       </repositories>
   </project>

   Copy to Clipboard Toggle word wrap

   1

   Red Hat GA Maven 存储库提供所有产品化 JBoss EAP 和其他红帽工件。

   2

   JBoss Public Maven Repository 提供工件，如 WildFly Maven 插件

2. 定义插件存储库。

   <project>
       ...
       <pluginRepositories>
           <pluginRepository>
               <id>jboss-public-maven-repository</id>
               <name>JBoss Public Maven Repository</name>
               <url>https://repository.jboss.org/nexus/content/groups/public/</url>
               <releases>
                  <enabled>true</enabled>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
               </snapshots>
           </pluginRepository>
           <pluginRepository>
               <id>redhat-ga-maven-repository</id>
               <name>Red Hat GA Maven Repository</name>
               <url>https://maven.repository.redhat.com/ga/</url>
               <releases>
                   <enabled>true</enabled>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
               </snapshots>
           </pluginRepository>
       </pluginRepositories>
   </project>

   Copy to Clipboard Toggle word wrap

流程

1. 在 pom.xml 配置文件的 properties 部分中，为 BOM 版本添加属性。

   <properties>
       ...
       <version.bom.microprofile>5.0.0.GA-redhat-00009</version.bom.microprofile>
   </properties>

   Copy to Clipboard Toggle word wrap

   属性 < version.bom.microprofile& gt; 中定义的值用作 BOM 版本的值。

2. 导入 JBoss EAP BOMs 依赖项管理。

   <project>
       ...
       <dependencyManagement>
           <dependencies>
               <dependency>
                   <groupId>org.jboss.bom</groupId>                   

   1

   
                   <artifactId>jboss-eap-xp-microprofile</artifactId> 

   2

   
                   <version>${version.bom.microprofile}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
           </dependencies>
       </dependencyManagement>
   </project>

   Copy to Clipboard Toggle word wrap

   1

   JBoss EAP 提供的 BOM 的 GroupId。

   2

   提供支持的 JBoss EAP MicroProfile API 的 JBoss EAP 提供的 BOM 的 artifactId。

流程

1. 在 pom.xml 配置文件的 properties 部分中，为 BOM 版本添加属性。

   <properties>
       ....
       <version.bom.ee>8.0.0.GA-redhat-00009</version.bom.ee>
   </properties>

   Copy to Clipboard Toggle word wrap

2. 导入 JBoss EAP BOMs 依赖项管理。

   <project>
       ...
       <dependencyManagement>
           <dependencies>
               <dependency>
                   <groupId>org.jboss.bom</groupId>                 

   1

   
                   <artifactId>jboss-eap-ee-with-tools</artifactId> 

   2

   
                   <version>${version.bom.ee}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
           </dependencies>
       </dependencyManagement>
   </project>

   Copy to Clipboard Toggle word wrap

   1

   JBoss EAP 提供的 BOM 的 GroupId。

   2

   提供支持的 JBoss EAP Java EE API 的 JBoss EAP 提供的 artifactId，以及额外的 JBoss EAP API JAR 和客户端 BOM，以及 Arquillian 等开发工具。

流程

1. 在 < properties > 部分中，定义 wildfly-maven-plugin 和 maven-war-plugin 的版本。

   <properties>
       ...
       <version.plugin.wildfly>4.2.1.Final</version.plugin.wildfly>
       <version.plugin.war>3.3.2</version.plugin.war>
   </properties>

   Copy to Clipboard Toggle word wrap

2. 在 & lt; project> 部分的 & lt;build&gt; 部分添加 <pluginManagement &gt; 部分。

   <project>
       ...
       <build>
           <pluginManagement>
               <plugins>
                   <plugin>    

   1

   
                       <groupId>org.wildfly.plugins</groupId>
                       <artifactId>wildfly-maven-plugin</artifactId>
                       <version>${version.plugin.wildfly}</version>
                   </plugin>
                   <plugin>                                  

   2

   
                       <groupId>org.apache.maven.plugins</groupId>
                       <artifactId>maven-war-plugin</artifactId>
                       <version>${version.plugin.war}</version>
                   </plugin>
               </plugins>
           </pluginManagement>
       </build>
   </project>

   Copy to Clipboard Toggle word wrap

   1

   您可以使用 wildfly-maven-plugin 使用 wildfly:deploy 命令将应用部署到 JBoss EAP。

   2

   您需要管理 war 插件版本，以确保与 JDK17+ 兼容。

流程

1. 打开一个终端。

2. 运行以下命令来连接到服务器：

   ./jboss-cli.sh --connect

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，检查 Micrometer 扩展是否已添加到配置中：

   [standalone@localhost:9990 /] /extension=org.wildfly.extension.micrometer:read-resource

   Copy to Clipboard Toggle word wrap

4. 如果 Micrometer 扩展不可用，请运行以下命令来添加它：

   [standalone@localhost:9990 /] /extension=org.wildfly.extension.micrometer:add

   Copy to Clipboard Toggle word wrap

5. 使用所需的配置添加 Micrometer 子系统。例如，运行以下命令来指定指标收集器的端点 URL：

   [standalone@localhost:9990 /] /subsystem=micrometer:add(endpoint="http://localhost:4318/v1/metrics")

   Copy to Clipboard Toggle word wrap

6. 重新载入服务器以应用更改：

   [standalone@localhost:9990 /] reload

   Copy to Clipboard Toggle word wrap

流程

1. 打开终端。

2. 使用以下脚本将 JBoss EAP 启动为独立服务器：

   $ <EAP_HOME>/bin/standalone.sh -c standalone-microprofile.xml

   Copy to Clipboard Toggle word wrap
   注意

   对于 Windows 服务器，请使用 &lt ;EAP_HOME> \bin\standalone.bat 脚本。

3. 打开一个新的终端。
4. 导航到应用程序根目录。

5. 运行以下命令来配置服务器：

   $ <EAP_HOME>/bin/jboss-cli.sh --connect --file=configure-micrometer.cli

   Copy to Clipboard Toggle word wrap
   注意

   对于 Windows 服务器，请使用 &lt ;EAP_HOME> \bin\jboss-cli.bat 脚本。

   将 <EAP_HOME > 替换为服务器的路径。

   预期输出：

   The batch executed successfully
   process-state: reload-required

   Copy to Clipboard Toggle word wrap

6. 使用以下管理命令重新载入服务器：

   $ <EAP_HOME>/bin/jboss-cli.sh --connect --commands=reload

   Copy to Clipboard Toggle word wrap

7. 使用以下内容创建名为 docker-compose.yaml 的配置文件：

   version: "3"
   
   services:
     otel-collector:
       image: otel/opentelemetry-collector
       command: [--config=/etc/otel-collector-config.yaml]
       volumes:
         - ./otel-collector-config.yaml:/etc/otel-collector-config.yaml:Z
       ports:
         - 1888:1888 # pprof extension
         - 8888:8888 # Prometheus metrics exposed by the collector
         - 8889:8889 # Prometheus exporter metrics
         - 13133:13133 # health_check extension
         - 4317:4317 # OTLP gRPC receiver
         - 4318:4318 # OTLP http receiver
         - 55679:55679 # zpages extension
         - 1234:1234 # /metrics endpoint

   Copy to Clipboard Toggle word wrap

8. 使用以下内容创建名为 otel-collector-config.yaml 的配置文件：

   extensions:
     health_check:
     pprof:
       endpoint: 0.0.0.0:1777
     zpages:
       endpoint: 0.0.0.0:55679
   
   receivers:
     otlp:
       protocols:
         grpc:
         http:
   
   processors:
     batch:
   
   exporters:
     prometheus:
       endpoint: "0.0.0.0:1234"
   
   service:
     pipelines:
       metrics:
         receivers: [otlp]
         processors: [batch]
         exporters: [prometheus]
   
     extensions: [health_check, pprof, zpages]

   Copy to Clipboard Toggle word wrap

9. 运行以下命令启动收集器服务器实例：

   $ docker-compose up

   Copy to Clipboard Toggle word wrap
   注意

   您还可以使用 Podman 而不是 Docker。如果您选择 Podman，则使用 $ podman-compose up 命令而不是 $ docker-compose。如果您的环境不支持 Docker 或 Podman，请参阅 Otel Collector 文档了解 安装和运行 OpenTelemetry Collector 的指南。

10. 在 RootResource 类中，了解 MeterRegistry 如何注入您的类，以确保在注册量表前正确设置。

    @Path("/")
    @ApplicationScoped
    public class RootResource {
        // ...
        @Inject
        private MeterRegistry registry;
    
        private Counter performCheckCounter;
        private Counter originalCounter;
        private Counter duplicatedCounter;
    
        @PostConstruct
        private void createMeters() {
            Gauge.builder("prime.highestSoFar", () -> highestPrimeNumberSoFar)
                    .description("Highest prime number so far.")
                    .register(registry);
            performCheckCounter = Counter
                    .builder("prime.performedChecks")
                    .description("How many prime checks have been performed.")
                    .register(registry);
            originalCounter = Counter
                    .builder("prime.duplicatedCounter")
                    .tags(List.of(Tag.of("type", "original")))
                    .register(registry);
            duplicatedCounter = Counter
                    .builder("prime.duplicatedCounter")
                    .tags(List.of(Tag.of("type", "copy")))
                    .register(registry);
        }
        // ...
    }

    Copy to Clipboard Toggle word wrap

11. 检查 checkIfPrime （） 方法正文，以了解如何在应用程序逻辑中使用注册的量表。例如：

    @GET
    @Path("/prime/{number}")
    public String checkIfPrime(@PathParam("number") long number) throws Exception {
        performCheckCounter.increment();
    
        Timer timer = registry.timer("prime.timer");
    
        return timer.recordCallable(() -> {
    
            if (number < 1) {
                return "Only natural numbers can be prime numbers.";
            }
    
            if (number == 1) {
                return "1 is not prime.";
            }
    
            if (number == 2) {
                return "2 is prime.";
            }
    
            if (number % 2 == 0) {
                return number + " is not prime, it is divisible by 2.";
            }
    
            for (int i = 3; i < Math.floor(Math.sqrt(number)) + 1; i = i + 2) {
                try {
                    Thread.sleep(10);
                } catch (InterruptedException e) {
                    //
                }
                if (number % i == 0) {
                    return number + " is not prime, is divisible by " + i + ".";
                }
            }
    
            if (number > highestPrimeNumberSoFar) {
                highestPrimeNumberSoFar = number;
            }
    
            return number + " is prime.";
        });
    }

    Copy to Clipboard Toggle word wrap

12. 导航到应用程序根目录。

    语法

    $ cd <path_to_application_root>/<application_root>

    Copy to Clipboard Toggle word wrap

    例如，引用 Micrometer Quickstart：

    $ cd ~/quickstarts/micrometer

    Copy to Clipboard Toggle word wrap

13. 使用以下命令编译并部署应用程序：

    $ mvn clean package wildfly:deploy

    Copy to Clipboard Toggle word wrap

验证

1. 使用 Web 浏览器访问 应用，也可以运行以下命令：

   $ curl http://localhost:8080/micrometer/prime/13

   Copy to Clipboard Toggle word wrap

   预期输出：

   13 is prime.

   Copy to Clipboard Toggle word wrap

流程

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

2. 在 OpenShift 中创建一个新项目。

   项目允许一组用户独立于其他组组织和管理内容。您可以使用以下命令在 OpenShift 中创建项目。

   $ oc new-project PROJECT_NAME

   Copy to Clipboard Toggle word wrap

   例如，对于 microprofile-config Quickstart，使用以下命令创建一个名为 eap-demo 的新项目：

   $ oc new-project eap-demo

   Copy to Clipboard Toggle word wrap

流程

1. 使用以下 YAML 内容，创建名为 helm.yaml 的文件：

   build:
     uri: https://github.com/jboss-developer/jboss-eap-quickstarts.git
     ref: XP_5.0.0.GA
     contextDir: microprofile-config
     mode: s2i
   deploy:
     replicas: 1

   Copy to Clipboard Toggle word wrap

2. 使用以下命令，在 Openshift 上部署 JBoss EAP XP 应用程序：

   $ helm install microprofile-config -f helm.yaml jboss-eap/eap-xp5

   Copy to Clipboard Toggle word wrap

流程

1. 使用以下命令获取应用程序的服务名称。

   $ oc get service

   Copy to Clipboard Toggle word wrap

2. 可选 ：将主服务作为路由公开，以便您可以从 OpenShift 外部访问应用。例如，对于 microprofile-config Quickstart，请使用以下命令公开所需的服务和端口。

   $ oc expose service/microprofile-config --port=8080

   Copy to Clipboard Toggle word wrap

3. 获取路由的 URL。

   $ oc get route

   Copy to Clipboard Toggle word wrap

4. 使用 URL 在 Web 浏览器中访问应用程序。URL 是上一命令输出中的 HOST/PORT 字段的值。

   注意

   对于 JBoss EAP XP 5.0.0 GA 发布，Microprofile 配置快速启动不会回复对应用程序的根上下文的 HTTPS GET 请求。此功能增强仅适用于 {JBossXPShortName101} GA 发行版。

   例如，若要与 Microprofile Config 应用交互，您的浏览器中 URL 可能是 http://HOST_PORT_Value/config/value。

   如果您的应用程序没有使用 JBoss EAP root 上下文，请将应用的上下文附加到 URL。例如，对于 microprofile-config Quickstart，URL 可以是 http://HOST_PORT_VALUE/microprofile-config/。

5. 另外，您可以通过运行以下命令来扩展应用程序实例。此命令将副本数增加到 3。

   $ oc scale deploymentconfig DEPLOYMENTCONFIG_NAME --replicas=3

   Copy to Clipboard Toggle word wrap

   例如，对于 microprofile-config Quickstart，请使用以下命令来扩展应用：

   $ oc scale deployment/microprofile-config --replicas=3

   Copy to Clipboard Toggle word wrap

流程

1. 在 新建服务器 对话框中设置新的服务器。

   1. 在 Select server type 列表中，选择 Red Hat JBoss Enterprise Application Platform 8.0。
   2. 在 Server 的主机名 字段中，输入 localhost。
   3. 在 Server name 字段中，输入 JBoss EAP 8.0 XP。
   4. 点击 Next。

2. 配置新的服务器。

   1. 在 Home directory 字段中，如果您不想使用默认设置，请指定一个新目录；例如： home/myname/dev/microprofile/runtimes/jboss-eap-7.4。
   2. 确保 执行环境 设置为 JavaSE-1.8。
   3. 可选：更改 Server 基础目录 和配置文件字段中的值。
   4. 点 Finish。

流程

1. 从 Quickstart Parent Artifact 导入 pom.xml 文件。

2. 如果您使用需要环境变量的快速入门，请在服务器 Overview 对话框中在启动配置上配置这些变量。

   例如，opentelemetry-tracing quickstart 使用以下环境变量：

   • OTEL_COLLECTOR_HOST

流程

1. 确定支持的 JBoss EAP Galleon 层，提供运行应用程序所需的功能。

2. 在 Maven 项目 pom.xml 文件的 &lt ;plugin& gt; 元素中引用 JBoss EAP feature pack 位置。以下示例显示了包含单一功能包的单个功能包，其中包括 jaxrs-server 基础层和 jpa-distributed 层。jaxrs-server 基础层为服务器提供额外的支持。

   <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>jpa-distributed</layer>
   			</layers>
   			<excluded-layers>
   				<layer>jpa</layer>
   			</excluded-layers>
                    ...
   		</configuration>
   	</plugin>
   </plugins>

   Copy to Clipboard Toggle word wrap

   本例还显示来自项目的 jpa 层的排除。

   注意

   如果您在项目中包含 jpa-distributed 层，则必须从 jaxrs-server 层中排除 jpa 层。jpa 层配置本地 infinispan hibernate 缓存，而 jpa-distributed 层配置远程 infinispan hibernate 缓存。

流程

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>
   		</configuration>
   		<executions>
   			<execution>
   				<goals>
   					<goal>package</goal>
   				</goals>
   			</execution>
   		</executions>
   	</plugin>
   </plugins>

   Copy to Clipboard Toggle word wrap
   注意

   如果您没有在 pom.xml 文件中指定 Galleon 层，则可引导 JAR 服务器包含一个与 standalone-microprofile.xml 配置相同的配置。

2. 将应用程序打包为可引导 JAR:

   $ mvn package

   Copy to Clipboard Toggle word wrap

3. 启动应用程序：

   $ NAME="foo" java -jar target/microprofile-config-bootable.jar

   Copy to Clipboard Toggle word wrap
   注意

   该示例使用 NAME 作为环境变量，但您可以选择使用 jim，这是默认值。

   注意

   要查看支持的可引导 JAR 参数的列表，请将 --help 附加到 java -jar target/microprofile-config-bootable.jar 命令的末尾。

4. 在 Web 浏览器中指定以下 URL 以访问 MicroProfile Config 应用：

   http://localhost:8080/config/json

   Copy to Clipboard Toggle word wrap

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

   curl http://localhost:8080/config/json

   Copy to Clipboard Toggle word wrap

   以下是预期的输出：

   {"result":"Hello foo"}

   Copy to Clipboard Toggle word wrap

流程

1. 要构建 hollow bootable JAR，您必须在项目 pom.xml 文件中将 < hollow-jar > 插件配置元素设置为 true。例如：

1. 构建 hollow bootable JAR:

   $ mvn clean package

   Copy to Clipboard Toggle word wrap

2. 运行 hollow bootable JAR:

   $ java -jar target/microprofile-config-bootable.jar --deployment=target/microprofile-config.war

   Copy to Clipboard Toggle word wrap
   重要

   要指定要在服务器上部署的 WAR 文件的路径，请使用以下参数，其中 < PATH_NAME& gt; 是部署的路径。

   --deployment=<PATH_NAME>

   Copy to Clipboard Toggle word wrap

3. 访问应用程序：

   $ curl http://localhost:8080/microprofile-config/config/json

   Copy to Clipboard Toggle word wrap
   注意

   要将 Web 应用注册到根目录，请将应用命名为 ROOT.war。

流程

1. 在项目的根目录下，创建名为 scripts 的目录。例如：

   $ mkdir scripts

   Copy to Clipboard Toggle word wrap

2. 创建 cli.properties 文件，并将文件保存到 /scripts 目录中。在此文件中定义 config.path 和 config.ordinal 系统属性。例如：

   config.path=/etc/config
   config.ordinal=200

   Copy to Clipboard Toggle word wrap

3. 创建一个 CLI 脚本，如 mp-config.cli，并将它保存在可引导 JAR 的可访问目录中，如 /scripts 目录。以下示例显示了 mp-config.cli 脚本的内容：

   # config map
   
   /subsystem=microprofile-config-smallrye/config-source=os-map:add(dir={path=${config.path}}, ordinal=${config.ordinal})

   Copy to Clipboard Toggle word wrap

   mp-config.cli CLI 脚本会创建一个新的 ConfigSource，该脚本将从属性文件检索到的 ordinal 和 path 值。

4. 将脚本保存到 /scripts 目录中，该目录位于项目的根目录。

5. 在现有插件 <configuration> 元素 中添加以下 配置提取：

   <cli-sessions>
       <cli-session>
           <properties-file>
               scripts/cli.properties
           </properties-file>
           <script-files>
               <script>scripts/mp-config.cli</script>
           </script-files>
       </cli-session>
   </cli-sessions>

   Copy to Clipboard Toggle word wrap

6. 打包应用程序：

   $ mvn package

   Copy to Clipboard Toggle word wrap
7. 使用 oc login 命令登录到您的 OpenShift 实例。

8. 可选： 如果您之前还没有创建 target/openshift 子目录，则必须发出以下命令来创建 suddirectory：

   $ mkdir target/openshift

   Copy to Clipboard Toggle word wrap

9. 将打包的应用复制到创建的子目录中。

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

   Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap
    注意

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

11. 创建 ConfigMap。例如：

    $ oc create configmap microprofile-config-map --from-literal=name="Name comes from Openshift ConfigMap"

    Copy to Clipboard Toggle word wrap

12. 使用 dc 将 ConfigMap 挂载到应用。例如：

    $ oc set volume deployments/microprofile-config-app --add --name=config-volume \
    --mount-path=/etc/config \
    --type=configmap \
    --configmap-name=microprofile-config-map

    Copy to Clipboard Toggle word wrap

    执行 oc set volume 命令后，应用程序将使用新的配置设置重新部署。

13. 测试输出：

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

    Copy to Clipboard Toggle word wrap

    以下是预期的输出：

    {"result":"Hello Name comes from Openshift ConfigMap"}

    Copy to Clipboard Toggle word wrap