프로세스

1. mvn 명령을 사용하여 Maven 프로젝트를 설정합니다. 명령은 프로젝트에 대한 디렉터리 구조와 pom.xml 구성 파일을 생성합니다.

   $ mvn archetype:generate                          \
   -DgroupId=org.jboss.as.quickstarts                \1
   -DartifactId=helloworld                           \2
   -DarchetypeGroupId=org.apache.maven.archetypes    \3
   -DarchetypeArtifactId=maven-archetype-webapp      \4
   -DinteractiveMode=false                            5

   1

   groupID 는 프로젝트를 고유하게 식별합니다.

   2

   artifactId 는 생성된 Cryostat 아카이브 의 이름입니다.

   3

   maven-archetype-webapp 의 groupID 입니다.

   4

   maven-archetype-webapp 의 artifactID 입니다.

   5

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

2. 생성된 디렉터리로 이동합니다.

   $ cd helloworld

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>org.jboss.as.quickstarts</groupId>
       <artifactId>helloworld</artifactId>
       <version>1.0-SNAPSHOT</version>
       <packaging>war</packaging>
       <name>helloworld Maven Webapp</name>
   
   </project>

   애플리케이션에 필요하지 않기 때문에 콘텐츠가 제거되었습니다.

프로세스

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>

   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>

프로세스

1. pom.xml 구성 파일의 properties 섹션에 BOM 버전의 속성을 추가합니다.

   <properties>
       ....
       <version.bom.ee>${version.server}</version.bom.ee>
   </properties>

   < version.server> 속성에 정의된 값은 BOM 버전의 값으로 사용됩니다.

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>

   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.1.1.Final</version.plugin.wildfly>
       <version.plugin.war>3.3.2</version.plugin.war>
   </properties>

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>

   1

   wildfly-maven-plugin 을 사용하여 wildfly:deploy 명령을 사용하여 애플리케이션을 JBoss EAP에 배포할 수 있습니다.

   2

   JDK17+와의 호환성을 보장하기 위해 war 플러그인 버전을 관리해야 합니다.

프로세스

1. 애플리케이션 루트 디렉터리로 이동합니다.

   애플리케이션 루트 디렉터리에는 pom.xml 구성 파일이 포함되어 있습니다.

2. 다음 빌드 구성을 < project > 섹션에 있는 pom.xml 구성 파일에 추가하여 애플리케이션 아카이브 파일 이름을 정의합니다.

   <build>
       ...
       <finalName>${project.artifactId}</finalName>        1
   </build>

   1

   배포 이름을 프로젝트의 아티팩트 ID로 설정합니다.

3. JBoss EAP 배포 플러그인을 사용하여 애플리케이션을 빌드하고 배포합니다.

   $ mvn package wildfly:deploy

프로세스

1. pom.xml 구성 파일에 다음 속성을 정의합니다.

   <properties>
       ...
       <version.plugin.failsafe>3.2.2</version.plugin.failsafe>
   </properties>

2. 테스트에 필요한 종속성을 추가합니다.

   <project>
       ...
       <dependencies>
           ...
           <dependency>
              <groupId>junit</groupId>
              <artifactId>junit</artifactId>
              <scope>test</scope>
           </dependency>
       </dependencies>
   </project>

3. 통합 테스트에 필요한 플러그인을 추가하도록 프로필을 정의합니다.

   <project>
       ...
       <profiles>
       ...
           <profile>
               <id>integration-testing</id>
               <build>
                   <plugins>
                       <plugin>
                           <groupId>org.apache.maven.plugins</groupId>
                           <artifactId>maven-failsafe-plugin</artifactId> 1
                           <version>${version.plugin.failsafe}</version>
                           <configuration>
                               <includes>
                                   <include>**/HelloWorldServletIT</include>       2
                               </includes>
                           </configuration>
                           <executions>
                               <execution>
                                  <goals>
                                      <goal>integration-test</goal>
                                      <goal>verify</goal>
                                  </goals>
                               </execution>
                           </executions>
                       </plugin>
                   </plugins>
               </build>
           </profile>
       </profiles>
   </project>

   1

   통합 테스트 실행을 위한 Maven 플러그인입니다.

   2

   애플리케이션을 테스트하는 Java 클래스의 이름입니다.

프로세스

1. < application_home> 디렉터리 로 이동합니다.

2. 테스트 클래스를 저장할 디렉터리를 만듭니다.

   $ mkdir -p src/test/java/org/jboss/as/quickstarts/helloworld

3. 새 디렉터리로 이동합니다.

   $ cd src/test/java/org/jboss/as/quickstarts/helloworld

4. 배포를 테스트하는 Java 클래스 HelloWorldServletIT.java 를 생성합니다.

   package org.jboss.as.quickstarts.helloworld;
   
   import org.junit.Test;
   import java.io.IOException;
   import java.net.URI;
   import java.net.URISyntaxException;
   import java.net.http.HttpClient;
   import java.net.http.HttpRequest;
   import java.net.http.HttpResponse;
   import java.time.Duration;
   import static org.junit.Assert.assertEquals;
   
   public class HelloWorldServletIT {
   
       private static final String DEFAULT_SERVER_HOST = "http://localhost:8080/helloworld";                1
   
       @Test
       public void testHTTPEndpointIsAvailable() throws IOException, InterruptedException, URISyntaxException {
           String serverHost = System.getProperty("server.host");
           if (serverHost == null) {
               serverHost = DEFAULT_SERVER_HOST;
           }
           final HttpRequest request = HttpRequest.newBuilder()
                   .uri(new URI(serverHost+"/HelloWorld"))
                   .GET()
                   .build();                                                                                 2
           final HttpClient client = HttpClient.newBuilder()
                   .followRedirects(HttpClient.Redirect.ALWAYS)
                   .connectTimeout(Duration.ofMinutes(1))
                   .build();                                                                                 3
           final HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); 4
           assertEquals(200, response.statusCode());                                                         5
       }
   }

   1

   애플리케이션이 실행 중인 URL입니다. 이 값은 sever.host 가 정의되지 않은 경우 사용됩니다.

   2

   애플리케이션 URI에 대한 CryostatRequest 인스턴스를 생성합니다.

   3

   애플리케이션에 대한 요청을 보내고 애플리케이션에서 응답을 받을 수 있는 CryostatClient를 만듭니다.

   4

   애플리케이션에서 응답을 가져옵니다.

   5

   애플리케이션에서 다시 수신되는 응답이 "200"이 애플리케이션을 다시 예약할 수 있음을 나타내는지 테스트합니다.

프로세스

1. < application_home> 디렉터리 로 이동합니다.

2. 통합 테스트 프로필과 함께 verify 명령을 사용하여 통합 테스트를 실행합니다.

   $ mvn verify -Pintegration-testing

   출력 예

   [INFO]
   [INFO] Results:
   [INFO]
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   [INFO]
   [INFO]
   [INFO] --- maven-failsafe-plugin:3.2.2:verify (default) @ helloworld ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  9.982 s
   [INFO] Finished at: 2023-11-22T14:53:54+05:30
   [INFO] ------------------------------------------------------------------------

프로세스

1. Git 리포지토리로 변경 사항을 내보냅니다.
2. < application_home> 디렉터리 로 이동합니다.

3. verify 명령을 사용하여 테스트를 실행하고 통합 테스트 프로필을 활성화하고 애플리케이션에 URL을 지정하여 테스트를 실행합니다.

   $ mvn verify -Pintegration-testing -Dserver.host=https://$(oc get route helloworld --template='{{ .spec.host }}')

   참고

   테스트에서는 SSL/TLS를 사용하여 배포된 애플리케이션에 연결합니다. 따라서 테스트가 실행되는 시스템에서 인증서를 신뢰해야 합니다.

   인증서를 신뢰하려면 Java 신뢰 저장소에 인증서를 추가해야 합니다.

   예제

   $ keytool -trustcacerts -keystore _<path-to-java-truststore>_ -storepass _<trust-store-password>_ -importcert -alias _<alias-for-the-certificate>_ -file _<path-to-certificate>_/_<certificate-name>_

   출력 예

   [INFO] Running org.jboss.as.quickstarts.helloworld.HelloWorldServletIT
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.345 s -- in org.jboss.as.quickstarts.helloworld.HelloWorldServletIT
   [INFO]
   [INFO] Results:
   [INFO]
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   [INFO]
   [INFO]
   [INFO] --- maven-failsafe-plugin:3.2.2:verify (default) @ helloworld ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  2.984 s
   [INFO] Finished at: 2023-11-30T15:51:22+05:30
   [INFO] ------------------------------------------------------------------------