6.6. 배포 동작 사용자 정의

프로세스

1. deployment-overlay add management CLI 명령을 사용하여 배포 오버레이를 추가합니다.

   deployment-overlay add --name=new-deployment-overlay --content=WEB-INF/web.xml=/path/to/other/web.xml --deployments=test-application.war --redeploy-affected

   참고

   관리형 도메인에서 --server-groups 를 사용하여 적용 가능한 서버 그룹을 지정하거나 --all-server-groups 를 사용하여 모든 서버 그룹을 지정합니다.

2. 배포 오버레이를 생성한 후 기존 오버레이에 콘텐츠를 추가하거나 오버레이를 배포에 연결하거나 오버레이를 제거할 수 있습니다.

3. 선택 사항: 오버레이 구성을 지정하여 < overlay > 요소를 사용하여 HTML, 이미지 또는 동영상과 같은 정적 웹 리소스가 포함된 외부 디렉터리에 연결할 수 있습니다.

   & lt;overlay > 요소는 JAR 오버레이 절차와 유사하게 웹 애플리케이션의 정적 파일을 오버레이하는 정적 파일을 지정합니다. 이 요소는 애플리케이션 파일 jboss-web.xml 에 있습니다. 이 요소 구성을 사용하면 애플리케이션을 다시 패키징할 필요가 없습니다.

   다음 예제에서는 < overlay > 요소의 시스템 속성 대체를 보여줍니다. 여기서 {example.path.to.overlay} 는 /PATH/TO/STATIC/WEB/CONTENT 위치를 정의합니다.

   예: jboss-web.xml 파일의 < overlay > 요소

   <jboss-web xmlns="http://www.jboss.com/xml/ns/javaee"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-web_10_0.xsd"
              version="10.0">
           <overlay>{example.path.to.overlay}</overlay>
   </jboss-web>

   jboss-descriptor-property-replacement 가 true 로 설정된 경우 설명자 속성의 기본값인 < overlay > 요소에서 시스템 속성을 지정할 수 있습니다.

   jboss-descriptor-property-replacement 를 구성하려면 다음 관리 CLI 명령을 사용합니다.

   /subsystem=ee:write-attribute(name=jboss-descriptor-property-replacement,value=true)

   이 명령은 JBoss EAP 구성의 ee 하위 시스템에 다음 XML 콘텐츠를 추가합니다.

   <subsystem xmlns="urn:jboss:domain:ee:4.0">
       <jboss-descriptor-property-replacement>true</jboss-descriptor-property-replacement>
   </subsystem>

   참고

   & lt;overlay > 요소는 EAP 프로젝트에 이미 존재하는 배포 파일을 재정의하지 않습니다. 여러 <overlay > 요소에 동일한 파일이 포함된 경우 우선순위 순서는 애플리케이션 jboss-web.xml 파일에서 오버레이 요소의 순서에 따라 결정됩니다.

1. 서버 그룹 group-A 및 group-B 는 작업을 동시에 적용합니다. 이 작업은 group-A 의 서버에 직렬로 적용되지만 group-B 의 모든 서버는 동시에 작업을 처리합니다. 그룹 A 에 있는 서버의 20% 이상이 작업을 적용하지 못하면 해당 그룹 전체에서 롤백됩니다. group-B 의 서버가 작업을 적용하지 않으면 해당 그룹에서 롤백됩니다.
2. group-A 및 group-B 의 모든 서버가 완료되면 이 작업이 group-C 의 서버에 적용됩니다. 이러한 서버는 작업을 동시에 처리합니다. group-C 의 서버가 두 개 이상 적용되지 않으면 해당 그룹에서 작업을 롤백합니다.
3. group-C 의 모든 서버가 완료되면 서버 그룹 group-D 및 group-E 가 작업을 동시에 적용합니다. 이 작업은 group-D 의 서버에 직렬로 적용되지만 group-E 의 모든 서버는 동시에 작업을 처리합니다. group-D 에 있는 서버의 20% 이상이 작업을 적용하지 못하면 해당 그룹 전체에서 롤백됩니다. group-E 의 서버가 작업을 적용하지 못하면 해당 그룹에서 롤백됩니다.

프로세스

1. rollout-plan 관리 CLI 명령을 사용하여 롤아웃 계획을 저장합니다. 형식에 대한 자세한 내용은 롤아웃 계획 구문 을 참조하십시오.

   rollout-plan add --name=my-rollout-plan --content={rollout main-server-group(rolling-to-servers=false,max-failed-servers=1),other-server-group(rolling-to-servers=true,max-failure-percentage=20) rollback-across-groups=true}

   이렇게 하면 다음 배포 계획이 생성됩니다.

   "rollout-plan" => {
       "in-series" => [
           {"server-group" => {"main-server-group" => {
               "rolling-to-servers" => false,
               "max-failed-servers" => 1
           }}},
           {"server-group" => {"other-server-group" => {
               "rolling-to-servers" => true,
               "max-failure-percentage" => 20
           }}}
       ],
       "rollback-across-groups" => true
   }

2. 애플리케이션을 배포할 때 저장된 롤아웃 계획 이름을 지정합니다.

   다음 관리 CLI 명령은 my-rollout-plan 저장된 롤아웃 계획을 사용하여 모든 서버 그룹에 애플리케이션을 배포합니다.

   deploy /path/to/test-application.war --all-server-groups --headers={rollout id=my-rollout-plan}