7.3. 배포 스캐너를 사용하여 애플리케이션 배포
배포 스캐너는 애플리케이션이 배포되도록 배포 디렉터리를 모니터링합니다. 기본적으로 배포 스캐너는 변경 사항에 대해 5초마다 EAP_HOME/standalone/deployments/
디렉터리를 검사합니다. 마커 파일은 배포 상태를 표시하고 배포 취소 또는 재배포와 같은 배포에 대해 작업을 트리거하는 데 사용됩니다.
프로덕션 환경에서 애플리케이션 배포에 관리 콘솔 또는 관리 CLI를 사용하는 것이 좋지만 개발자의 편의를 위해 배포 스캐너를 사용하여 배포하는 것이 좋습니다. 이를 통해 사용자는 빠른 개발 사이클에 적합한 방식으로 애플리케이션을 빌드하고 테스트할 수 있습니다. 또한 배포 스캐너를 다른 배포 방법과 함께 사용해서는 안 됩니다.
배포 스캐너는 JBoss EAP를 독립 실행형 서버로 실행하는 경우에만 사용할 수 있습니다.
7.3.1. 배포 스캐너를 사용하여 독립 실행형 서버에 애플리케이션 배포
XML, zipped 및 내용의 자동 배포를 허용하거나 허용하지 않도록 배포 스캐너를 구성할 수 있습니다. 자동 배포를 비활성화한 경우 배포 작업을 트리거하려면 마커 파일을 수동으로 생성해야 합니다. 사용 가능한 마커 파일 유형 및 용도에 대한 자세한 내용은 Deployment Scanner Marker Files 섹션을 참조하십시오.
기본적으로 XML 및 zipped 콘텐츠에 대한 자동 배포가 활성화됩니다. 각 콘텐츠 유형에 대한 자동 배포 구성에 대한 자세한 내용은 배포 스캐너 구성을 참조하십시오.
배포 스캐너를 사용하여 배포하는 것은 개발자 편의를 위해 제공되며 프로덕션 환경에서 사용하는 것은 권장되지 않습니다. 또한 다른 배포 방법과 함께 사용해서는 안 됩니다.
애플리케이션 배포
콘텐츠를 배포 폴더에 복사합니다.
$ cp /path/to/test-application.war EAP_HOME/standalone/deployments/
자동 배포가 활성화되면 이 파일이 자동으로 선택되고 배포되고 .deployed
마커 파일이 생성됩니다. 자동 배포가 활성화되지 않은 경우 배포를 트리거하려면 .dodeploy
마커 파일을 수동으로 추가해야 합니다.
$ touch EAP_HOME/standalone/deployments/test-application.war.dodeploy
애플리케이션 배포 취소
.deployed
마커 파일을 제거하여 배포 취소를 트리거합니다.
$ rm EAP_HOME/standalone/deployments/test-application.war.deployed
자동 배포가 활성화된 경우 test-application.war
파일을 제거하여 배포 취소를 트리거할 수도 있습니다. 이는 불합리한 배포에는 적용되지 않습니다.
애플리케이션 재배포
.dodeploy
마커 파일을 생성하여 재배포를 시작합니다.
$ touch EAP_HOME/standalone/deployments/test-application.war.dodeploy
7.3.2. 배포 스캐너 구성
배포 스캐너는 관리 콘솔 또는 관리 CLI를 사용하여 구성할 수 있습니다. 검사 간격, 배포 폴더 위치, 특정 애플리케이션 파일 유형의 자동 배포와 같은 배포 스캐너의 동작을 구성할 수 있습니다. 배포 스캐너를 완전히 비활성화할 수도 있습니다.
사용 가능한 모든 배포 스캐너 속성에 대한 자세한 내용은 Deployment Scanner Attributes 섹션을 참조하십시오.
아래 관리 CLI 명령을 사용하여 기본 배포 스캐너를 구성합니다.
배포 스캐너 비활성화
/subsystem=deployment-scanner/scanner=default:write-attribute(name=scan-enabled,value=false)
이렇게 하면 기본
배포 스캐너가 비활성화됩니다.
검사 간격 변경
/subsystem=deployment-scanner/scanner=default:write-attribute(name=scan-interval,value=10000)
이렇게 하면 검사 간격 시간이 5000
밀리초(five 초)에서 10000
밀리초(10초)로 업데이트됩니다.
배포 폴더 변경
/subsystem=deployment-scanner/scanner=default:write-attribute(name=path,value=/path/to/deployments)
이렇게 하면 배포 폴더의 위치가 EAP_HOME/standalone/deployments
의 기본 위치에서 /path/to/deployments
로 변경됩니다.
relative-to
특성이 지정되지 않는 한 경로
값은 절대 경로로 취급되며 이 경우 해당 경로를 기준으로 합니다.
Exploded 콘텐츠의 자동 배포 활성화
/subsystem=deployment-scanner/scanner=default:write-attribute(name=auto-deploy-exploded,value=true)
이를 통해 의심 스러운 콘텐츠를 자동으로 배포할 수 있으며 이는 기본적으로 비활성화되어 있습니다.
Zipped 콘텐츠의 자동 배포 비활성화
/subsystem=deployment-scanner/scanner=default:write-attribute(name=auto-deploy-zipped,value=false)
이렇게 하면 기본적으로 활성화되어 있는 zipped 콘텐츠의 자동 배포가 비활성화됩니다.
XML 콘텐츠의 자동 배포 비활성화
/subsystem=deployment-scanner/scanner=default:write-attribute(name=auto-deploy-xml,value=false)
이렇게 하면 기본적으로 활성화되어 있는 XML 콘텐츠의 자동 배포가 비활성화됩니다.
7.3.3. 사용자 정의 배포 스캐너 정의
관리 CLI를 사용하여 새 배포 스캐너를 추가하거나 관리 콘솔의 구성 탭에서 Deployment Scanners 하위 시스템으로 이동하여 추가할 수 있습니다. 그러면 배포를 스캔할 새 디렉터리가 정의됩니다. 기본 배포 스캐너는 EAP_HOME/standalone/deployments
를 모니터링합니다. 기존 배포 스캐너 구성에 대한 자세한 내용은 배포 스캐너 구성을 참조하십시오.
다음 관리 CLI 명령은 배포에 대해 5초마다 EAP_HOME/standalone/new_deployment_dir
을 확인하는 새 배포 스캐너를 추가합니다.
/subsystem=deployment-scanner/scanner=new-scanner:add(path=new_deployment_dir,relative-to=jboss.server.base.dir,scan-interval=5000)
지정된 디렉터리가 이미 존재하거나 이 명령이 오류와 함께 실패합니다.
새 배포 스캐너가 정의되고 지정된 디렉터리가 배포에 대해 모니터링됩니다.