Using 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

   예

   ./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 는 생성된 Cryostat 아카이브 의 이름입니다.

   3

   archetypeGroupID 는 maven-archetype-webapp 의 고유 ID입니다.

   4

   archetypeArtifactId 는 maven-archetype-webapp 의 아티팩트 ID입니다.

   5

   InteractiveMode 는 대화형 모드에서 시작하는 대신 제공된 매개 변수를 사용하도록 Maven에 지시합니다.

2. 생성된 디렉터리로 이동합니다.
3. 텍스트 편집기에서 생성된 pom.xml 구성 파일을 엽니다.

4. <name> 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. 아티팩트 리포지토리를 정의합니다.

   <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 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> 속성에 정의된 값은 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 API JAR 및 클라이언트 BOMs, Arquillian과 같은 개발 툴을 제공하는 JBoss EAP 제공 BOM의 artifactId입니다.

프로세스

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> 섹션의 < 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 서버의 경우 < EAP_HOME> \bin\standalone.batch 스크립트를 사용합니다.

3. 새 터미널을 엽니다.
4. 애플리케이션 루트 디렉터리로 이동합니다.

5. 다음 명령을 실행하여 서버를 구성합니다.

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

   Copy to Clipboard Toggle word wrap
   참고

   Windows 서버의 경우 < EAP_HOME> \bin\jboss-cli.extension 스크립트를 사용합니다.

   & lt;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이 지원되지 않는 경우 OpenTelemetry 수집기 설치 및 실행에 대한 지침은 Otel 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

    마이크로미터 빠른 시작에 대한 예를 들면 다음과 같습니다.

    $ cd ~/quickstarts/micrometer

    Copy to Clipboard Toggle word wrap

13. 다음 명령을 사용하여 애플리케이션을 컴파일하고 배포합니다.

    $ mvn clean package wildfly:deploy

    Copy to Clipboard Toggle word wrap

검증

1. 웹 브라우저를 사용하여 애플리케이션에 액세스하거나 다음 명령을 실행할 수 있습니다.

   $ 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 빠른 시작의 경우 다음 명령을 사용하여 Cryostat -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 빠른 시작의 경우 다음 명령을 사용하여 필요한 서비스와 포트를 노출합니다.

   $ 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을 사용하여 웹 브라우저에서 애플리케이션에 액세스합니다. URL은 이전 명령의 출력의 HOST/PORT 필드 값입니다.

   참고

   JBoss EAP XP 5.0.0 GA 배포의 경우 Microprofile Config quickstart는 애플리케이션의 루트 컨텍스트에 대한 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. 새 서버 대화 상자에서 새 서버를 설정합니다.

   1. Select server type 목록에서 Red Hat JBoss Enterprise Application Platform 8.0 을 선택합니다.
   2. 서버의 호스트 이름 필드에 localhost 를 입력합니다.
   3. 서버 이름 필드에 JBoss EAP 8.0 XP 를 입력합니다.
   4. 다음을 클릭합니다.

2. 새 서버를 구성합니다.

   1. 홈 디렉터리 필드에서 기본 설정을 사용하지 않으려면 새 디렉터리를 지정합니다(예: home/myname/dev/microprofile/runtimes/jboss-eap-7.4 ).
   2. 실행 환경이 JavaSE-1.8 로 설정되어 있는지 확인합니다.
   3. 선택 사항: 서버 기본 디렉터리 및 구성 파일 필드의 값을 변경합니다.
   4. 완료를 클릭합니다.

프로세스

1. 빠른 시작 부모 Artifact에서 pom.xml 파일을 가져옵니다.

2. 환경 변수가 필요한 퀵 스타트를 사용하는 경우 서버 개요 대화 상자에서 해당 변수를 시작 구성에 구성합니다.

   예를 들어 opentelemetry-tracing 빠른 시작에서는 다음 환경 변수를 사용합니다.

   • OTEL_COLLECTOR_HOST

프로세스

1. 애플리케이션을 실행하는 데 필요한 기능을 제공하는 지원되는 JBoss EAP Galleon 계층을 식별합니다.

2. Maven 프로젝트 pom.xml 파일의 &lt ;plugin& gt; 요소에서 JBoss EAP 기능 팩 위치를 참조합니다. 다음 예제에서는 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 계층을 프로젝트에 포함하는 경우 jpa 계층을 jaxrs-server 계층에서 제외해야 합니다. jpa 계층은 로컬 infinispan hibernate 캐시를 구성하고, jpa-distributed 계층은 원격 infinispan hibernate 캐시를 구성합니다.

프로세스

1. pom.xml 파일의 & lt;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 인수 목록을 보려면 java -jar target/microprofile-config-bootable.jar 명령 끝에 --help 를 추가합니다.

4. 웹 브라우저에서 다음 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. 빈 부팅 가능한 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.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 스크립트는 속성 파일에서 ordinal 및 path 값이 검색되는 새 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 하위 디렉터리를 생성하지 않은 경우 다음 명령을 실행하여 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는 부팅 가능한 JAR 구성 파일에 CLI 스크립트 명령 세트를 적용하여 클라우드 환경에서 활성화합니다. 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