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 parameter を使用してオフラインリポジトリーを指定します。

手順

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

   例

   ./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. pom.xml 設定ファイルの <project> セクション内にある <name>helloworld Maven Webapp</name> 行の後ろの内容を削除します。

   ファイルが次のようになっていることを確認します。

   <?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. アーティファクトリポジトリーを定義します。

   <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 アーティファクトとその他の Red Hat アーティファクトを提供します。

   2

   JBoss Public Maven リポジトリーは、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> プロパティーで定義された値が、BOM バージョンの値として使用されます。

2. JBoss EAP BOM の依存関係管理をインポートします。

   <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 BOM の依存関係管理をインポートします。

   <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 が提供する BOM の artifactID。この BOM は、サポートされている JBoss EAP Java EE API に加えて、追加の 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. <project> セクション内の <build> セクションに <pluginManagement> を追加します。

   <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

   JDK17+ との互換性を確保するには、war プラグインのバージョンを管理する必要があります。

手順

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 Server の場合は、<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 Server の場合は、<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
   注記

   Docker の代わりに Podman を使用することもできます。Podman を選択した場合は、$ docker-compose up ではなく $ podman-compose up コマンドを使用します。ご使用の環境で 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 で新しいプロジェクトを作成します。

   プロジェクトでは、1 つのユーザーグループが他のグループとは別にコンテンツを整理および管理することができます。以下のコマンドを使用すると OpenShift でプロジェクトを作成できます。

   $ oc new-project PROJECT_NAME

   Copy to Clipboard Toggle word wrap

   たとえば、以下のコマンドを使用して、microprofile-config クイックスタートで 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. 以下のコマンドを使用して、JBoss EAP XP アプリケーションを OpenShift にデプロイします。

   $ 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 クイックスタートでは、以下のコマンドを使用して必要なサービスとポートを公開します。

   $ 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 Config クイックスタートはアプリケーションのルートコンテキストに対して HTTPS GET リクエストに応答しません。今回の機能拡張は、{JBossXPShortName101} GA ディストリビューションでのみ利用可能です。

   たとえば、Microprofile Config アプリケーションと対話するには、ブラウザーの URL は http://HOST_PORT_Value/config/value になります。

   アプリケーションが JBoss EAP ルートコンテキストを使用しない場合、アプリケーションのコンテキストを URL に追加します。たとえば、microprofile-config クイックスタートの URL は http://HOST_PORT_VALUE/microprofile-config/ のようになります。

5. 任意で、以下のコマンドを実行してアプリケーションインスタンスをスケールアップすることもができます。このコマンドにより、レプリカ数が 3 に増えます。

   $ oc scale deploymentconfig DEPLOYMENTCONFIG_NAME --replicas=3

   Copy to Clipboard Toggle word wrap

   たとえば、microprofile-config クイックスタートでは、以下のコマンドを使用してアプリケーションをスケールアップします。

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

   Copy to Clipboard Toggle word wrap

手順

1. New Server ダイアログボックスで新しいサーバーを設定します。

   1. Select server type リストで Red Hat JBoss Enterprise Application Platform 8.0 を選択します。
   2. Server's host name フィールドに 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. Execution Environment が JavaSE-1.8 に設定されていることを確認します。
   3. 任意: Server base directory と Configuration file フィールドの値を変更します。
   4. Finish をクリックします。

手順

1. Quickstart Parent Artifact から pom.xml ファイルをインポートします。

2. 環境変数を必要とするクイックスタートを使用している場合は、サーバーの Overview ダイアログボックスの起動設定でそれらの変数を設定します。

   たとえば、opentelemetry-tracing クイックスタートでは次の環境変数が使用されます。

   • OTEL_COLLECTOR_HOST

手順

1. アプリケーションの実行に必要な機能を提供する、サポートされる JBoss EAP Galleon レイヤーを特定します。

2. Maven プロジェクトの pom.xml ファイルの <plugin> 要素で JBoss EAP feature-pack の場所を参照します。以下の例は、jaxrs-server ベースレイヤーおよび jpa-distributed レイヤーを含む単一の feature-pack を組み込んでいます。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 JAR をビルドするには、プロジェクトの pom.xml ファイルで <hollow-jar> プラグイン設定要素を true に設定する必要があります。以下に例を示します。

1. 起動可能な hollow JAR をビルドします。

   $ mvn clean package

   Copy to Clipboard Toggle word wrap

2. 起動可能な hollow JAR を実行します。

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

   Copy to Clipboard Toggle word wrap
   重要

   サーバーにデプロイする WAR ファイルへのパスを指定するには、以下の引数を使用します。<PATH_NAME> は、デプロイメントへのパスになります。

   --deployment=<PATH_NAME>

   Copy to Clipboard Toggle word wrap

3. アプリケーションにアクセスします。

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

   Copy to Clipboard Toggle word wrap
   注記

   root ディレクトリーに 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. mp-config.cli などの CLI スクリプトを作成し、これを /scripts ディレクトリーなどの起動可能な JAR のアクセス可能なディレクトリーに保存します。以下の例は、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 を作成します。

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 サブディレクトリーを作成していない場合は、以下のコマンドを実行してサブディレクトリーを作成する必要があります。

   $ 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 directory の 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