11.4. 부팅 가능한 JAR 서버의 Galleon 계층 지정
Galleon 레이어를 지정하여 서버의 사용자 지정 구성을 빌드할 수 있습니다. 또한 서버에서 제외하려는 Galleon 레이어를 지정할 수 있습니다.
JBoss EAP XP 5.0부터 서버 아티팩트를 검색하려면 JBoss EAP 8.0 및 JBoss EAP XP 5.0 채널을 사용하여 JBoss EAP JAR Maven 플러그인을 구성해야 합니다. JBoss EAP 채널에 대한 자세한 내용은 JBoss EAP 설치 채널 관리를 참조하십시오.
최신 JBoss EAP XP 5.0 서버를 프로비저닝하기 위해 JBoss EAP 및 JBoss EAP XP 채널을 지정하려면 다음 예제를 따르십시오.
< ;feature-pack-location> 요소를 사용하여 기능 팩 위치를 지정합니다. Maven 플러그인 구성 파일에서 다음 예제에서는 < feature-pack-location> 요소 내의 을 지정합니다.
org.jboss.eap.xp:wildfly-galleon-pack
<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>
</configuration>
둘 이상의 기능 팩을 참조해야 하는 경우 < feature-packs> 요소에 나열합니다. 다음 예제에서는 JBoss EAP 데이터 소스 기능 팩을 < feature-packs> 요소에 추가하는 방법을 보여줍니다.
<configuration>
<feature-packs>
<feature-pack>
<location>org.jboss.eap.xp:wildfly-galleon-pack</location>
</feature-pack>
<feature-pack>
<location>org.jboss.eap:eap-datasources-galleon-pack</location>
</feature-pack>
</feature-packs>
</configuration>
여러 기능 팩에서 Galleon 레이어를 결합하여 필요한 기능을 제공하는 지원되는 Galleon 계층만 포함하도록 부팅 가능한 JAR 서버를 구성할 수 있습니다.
베어 메탈 플랫폼에서 구성 파일에 Galleon 계층을 지정하지 않으면 프로비저닝된 서버에 기본 standalone-microprofile.xml 구성과 동일한 구성이 포함됩니다.
OpenShift 플랫폼에서 플러그인 구성에 < cloud/ > 구성 요소를 추가하고 구성 파일에서 Galleon 계층을 지정하지 않도록 선택한 후 프로비저닝된 서버에는 클라우드 환경에 맞게 조정되고 기본 standalone-microprofile-ha.xml 과 유사한 구성이 포함되어 있습니다.
사전 요구 사항
- Maven이 설치되어 있어야 합니다.
-
9.minor.micro.Final-redhat-XXXXX와 같은 최신 Maven 플러그인 버전을 확인했습니다. 여기서 9 는 주요 버전이며 마이너 버전은 마이크로 마이크로 버전이며 X 는 Red Hat 빌드 번호입니다. 예:9.0.1.Final-redhat-00009.
절차에 표시된 예제에서는 다음 속성을 지정합니다.
-
${bootable.jar.maven.plugin.version}은(는) Maven 플러그인 버전에 해당합니다.
프로젝트에 이러한 속성을 설정해야 합니다. 예를 들면 다음과 같습니다.
<properties>
<bootable.jar.maven.plugin.version>9.0.1.Final-redhat-00009</bootable.jar.maven.plugin.version>
</properties>
프로세스
- 애플리케이션을 실행하는 데 필요한 기능을 제공하는 지원되는 JBoss EAP Galleon 계층을 식별합니다.
Maven 프로젝트
pom.xml파일의 <plugin> 요소에서 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>이 예제에서는 프로젝트에서
jpa계층을 제외하는 방법도 보여줍니다.참고jpa-distributed계층을 프로젝트에 포함하는 경우jpa계층을jaxrs-server계층에서 제외해야 합니다.jpa계층은 로컬 infinispan hibernate 캐시를 구성하고,jpa-distributed계층은 원격 infinispan hibernate 캐시를 구성합니다.