Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

6장. 애플리케이션 배포 관리

JBoss EAP에는 관리자와 개발자 모두를 지원하는 다양한 애플리케이션 배포 및 구성 옵션이 있습니다. 관리자의 경우 관리 콘솔 과 관리 CLI 는 프로덕션 환경에서 애플리케이션 배포를 관리하는 이상적인 그래픽 및 명령줄 인터페이스를 제공합니다. 개발자의 경우 애플리케이션 배포 테스트 옵션에는 구성 가능한 파일 시스템 배포 스캐너, HTTP API, Red Hat CodeReady Studio와 같은 IDE, Maven 이 포함됩니다.

애플리케이션을 배포할 때 org.jboss.metadata.parser.validate 시스템 속성을 true 로 설정하여 배포 설명자에 대한 유효성 검사를 활성화할 수 있습니다. 이 작업은 다음 방법 중 하나로 수행할 수 있습니다.

  • 서버를 시작하는 동안 

    $ EAP_HOME/bin/standalone.sh -Dorg.jboss.metadata.parser.validate=true
    Copy to Clipboard Toggle word wrap

  • 다음 관리 CLI 명령을 사용하여 서버 구성에 추가하여 다음을 수행합니다. 

    /system-property=org.jboss.metadata.parser.validate:add(value=true)
    Copy to Clipboard Toggle word wrap

6.1. 관리 CLI를 사용하여 애플리케이션 배포 관리
링크 복사

관리 CLI를 사용하여 애플리케이션을 배포하면 배포 스크립트를 생성하고 실행하는 기능과 함께 단일 명령줄 인터페이스를 활용할 수 있습니다. 이 스크립팅 기능을 사용하여 특정 애플리케이션 배포 및 관리 시나리오를 구성할 수 있습니다. 독립 실행형 서버로 실행할 때 단일 서버의 배포를 관리하거나 관리형 도메인에서 실행할 때 전체 서버 네트워크를 관리할 수 있습니다.

6.1.1. 독립 실행형 서버에서 애플리케이션 배포 관리
링크 복사

6.1.1.1. 관리 CLI를 사용하여 독립 실행형 서버에 애플리케이션 배포
링크 복사

deployment deploy-file 명령을 사용하여 관리 CLI를 사용하여 독립 실행형 서버로 애플리케이션을 배포할 수 있습니다.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.

프로세스

  • 관리 CLI에서 웹 아카이브(war)로 패키지된 애플리케이션을 배포합니다.

    구문

    deployment deploy-file <path_to_the_application>/<application_name>.war
    Copy to Clipboard Toggle word wrap

    예

    deployment deploy-file /my-applications/test-application.war
    Copy to Clipboard Toggle word wrap

    배포에 성공하면 관리 CLI에 대한 출력이 생성되지 않지만 서버 로그에 다음 출력과 같은 배포 메시지가 표시됩니다. 

    WFLYSRV0027: Starting deployment of "test-application.war" (runtime-name: "test-application.war")
WFLYUT0021: Registered web context: /test-application
WFLYSRV0010: Deployed "test-application.war" (runtime-name : "test-application.war")
    Copy to Clipboard Toggle word wrap

마찬가지로 다음 배포 명령을 사용할 수 있습니다.

  • deployment deploy-cli-archive 를 사용하여 .cli 아카이브 파일의 콘텐츠를 배포합니다. CLI 배포 아카이브는 .cli 확장자가 있는 JAR 파일입니다. 배포해야 하는 애플리케이션 아카이브와 CLI 스크립트 파일, deploy.scr 및 undeploy.scr, 명령 및 작업이 포함되어 있습니다. 한 스크립트 파일 deploy.scr 에는 애플리케이션 아카이브를 배포하고 환경을 설정하는 명령 및 작업이 포함되어 있습니다. 다른 스크립트 파일인 undeploy.scr 에는 애플리케이션 아카이브 배포를 취소하고 환경을 정리하는 명령이 포함되어 있습니다.
  • 배포 deploy-url 을 사용하여 URL에서 참조하는 콘텐츠를 배포합니다.
참고

-- runtime-name 옵션을 사용하여 runtime-name 속성을 지정하는 경우 이름에 .war 확장을 포함해야 합니다. 그렇지 않으면 웹 컨텍스트는 JBoss EAP에 의해 등록되지 않습니다.

배포 un deploy 명령을 사용하여 관리 CLI를 사용하여 독립 실행형 서버에서 애플리케이션 배포를 취소할 수 있습니다. 애플리케이션 배포를 취소하면 리포지토리에서 배포 콘텐츠가 삭제됩니다. 애플리케이션을 사용할 수 없는 동안 배포 콘텐츠를 유지하려면 대신 배포를 비활성화할 수 있습니다. 자세한 내용은 관리 CLI를 사용하여 독립 실행형 서버에서 애플리케이션 비활성화를 참조하십시오.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.

프로세스

  • 관리 CLI를 사용하여 애플리케이션 배포를 취소합니다.

    구문

    deployment undeploy <deployment>
    Copy to Clipboard Toggle word wrap

    예

    deployment undeploy test-application.war
    Copy to Clipboard Toggle word wrap

    배포 취소에 성공하면 관리 CLI에 대한 출력이 생성되지 않지만 서버 로그에 다음 출력과 같은 배포 취소 메시지가 표시됩니다. 

    WFLYUT0022: Unregistered web context: /test-application
WFLYSRV0028: Stopped deployment test-application.war (runtime-name: test-application.war) in 62ms
WFLYSRV0009: Undeployed "test-application.war" (runtime-name: "test-application.war")
    Copy to Clipboard Toggle word wrap

마찬가지로 배포 undeploy-cli-archive를 사용하여 .cli 아카이브 파일에서 콘텐츠를 배포 취소할 수 있습니다. 와일드카드(*)를 사용하여 모든 배포 배포를 취소할 수도 있습니다. 

deployment undeploy *
Copy to Clipboard Toggle word wrap

리포지토리에서 배포 콘텐츠를 제거하지 않고 배포된 애플리케이션을 비활성화할 수 있습니다.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.

프로세스

  • 관리 CLI에서 배포 disable 명령을 사용하여 단일 애플리케이션 또는 JBoss EAP에 배포된 모든 애플리케이션을 비활성화할 수 있습니다.

    • 단일 배포를 비활성화합니다.

      구문

      deployment disable <deployment>
      Copy to Clipboard Toggle word wrap

      예

      deployment disable test-application.war
      Copy to Clipboard Toggle word wrap

    • 모든 배포를 비활성화합니다. 

      deployment disable-all
      Copy to Clipboard Toggle word wrap

비활성화된 애플리케이션을 활성화할 수 있습니다.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.

프로세스

  • 관리 CLI에서 deployment enable 명령을 사용하여 JBoss EAP에 배포된 단일 애플리케이션 또는 모든 애플리케이션을 활성화할 수 있습니다.

    • 단일 배포를 활성화합니다.

      구문

      deployment enable <deployment>
      Copy to Clipboard Toggle word wrap

      예

      deployment enable test-application.war
      Copy to Clipboard Toggle word wrap

    • 모든 배포를 활성화합니다. 

      deployment enable-all
      Copy to Clipboard Toggle word wrap

6.1.1.5. 관리 CLI를 사용하여 독립 실행형 서버에 배포 나열
링크 복사

독립 실행형 서버에 배포를 나열하고 런타임 이름, 상태 등과 같은 배포 정보를 볼 수 있습니다.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.

프로세스

  • 배포 info 명령을 사용하여 배포 정보를 나열합니다. 

    deployment info
    Copy to Clipboard Toggle word wrap

    출력에는 런타임 이름, 상태 및 활성화 여부와 같은 각 배포에 대한 세부 정보가 표시됩니다. 

    NAME                 RUNTIME-NAME         PERSISTENT ENABLED STATUS
helloworld.war       helloworld.war       true       true    OK
test-application.war test-application.war true       true    OK
    Copy to Clipboard Toggle word wrap

    이름별 배포 정보를 표시하려면 다음을 수행합니다. 

    deployment info helloworld.war
    Copy to Clipboard Toggle word wrap

deployment list 명령을 사용하여 모든 배포를 나열 할 수도 있습니다.

6.1.2. 관리형 도메인에서 애플리케이션 배포 관리
링크 복사

6.1.2.1. 관리 CLI를 사용하여 관리형 도메인에 애플리케이션 배포
링크 복사

deployment deploy-file 명령을 사용하고 애플리케이션을 배포해야 하는 서버 그룹을 지정하여 관리 CLI를 사용하여 독립 실행형 서버를 배포할 수 있습니다.

사전 요구 사항

  • JBoss EAP는 관리형 도메인으로 실행되고 있습니다.

프로세스

  • 관리 CLI에서 특정 서버 그룹 또는 모든 서버 그룹에 웹 아카이브(war)로 패키지된 애플리케이션을 배포할 수 있습니다.

    • 애플리케이션을 특정 서버 그룹에 배포합니다.

      구문

      deployment deploy-file <path_to_the_application>/<application_name>.war --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      예

      deployment deploy-file /my-applications/test-application.war --server-groups=main-server-group,other-server-group
      Copy to Clipboard Toggle word wrap

    • 모든 서버 그룹에 애플리케이션을 배포합니다.

      구문

      deployment deploy-file <path_to_the_application>/<application_name>.war --all-server-groups
      Copy to Clipboard Toggle word wrap

      예

      deployment deploy-file /my-applications/test-application.war --all-server-groups
      Copy to Clipboard Toggle word wrap

      성공적으로 배포해도 관리 CLI에 대한 출력이 생성되지 않지만 서버 로그에 영향을 받는 각 서버에 대한 배포 메시지가 표시됩니다. 

    [Server:server-one] WFLYSRV0027: Starting deployment of "test-application.war" (runtime-name: "test-application.war")
[Server:server-one] WFLYUT0021: Registered web context: /test-application
[Server:server-one] WFLYSRV0010: Deployed "test-application.war" (runtime-name : "test-application.war")
    Copy to Clipboard Toggle word wrap

마찬가지로 다음 배포 명령을 사용할 수 있습니다.

  • deployment deploy-cli-archive 명령을 사용하여 .cli 아카이브 파일의 콘텐츠를 배포합니다. CLI 배포 아카이브는 .cli 확장자가 있는 JAR 파일입니다. 배포해야 하는 애플리케이션 아카이브와 CLI 스크립트 파일, deploy.scr 및 undeploy.scr, 명령 및 작업이 포함되어 있습니다. 한 스크립트 파일 deploy.scr 에는 애플리케이션 아카이브를 배포하고 환경을 설정하는 명령 및 작업이 포함되어 있습니다. 다른 스크립트 파일인 undeploy.scr 에는 애플리케이션 아카이브 배포를 취소하고 환경을 정리하는 명령이 포함되어 있습니다.
  • 배포 deploy-url 명령을 사용하여 URL에서 참조하는 콘텐츠를 배포합니다.
참고

-- runtime-name 옵션을 사용하여 runtime-name 속성을 지정하는 경우 이름에 .war 확장을 포함해야 합니다. 그렇지 않으면 웹 컨텍스트는 JBoss EAP에 의해 등록되지 않습니다.

배포 un deploy 명령을 사용하여 관리 CLI를 사용하여 관리형 도메인으로 실행되는 JBoss EAP에서 애플리케이션 배포를 취소할 수 있습니다. 애플리케이션 배포를 취소하면 리포지토리에서 배포 콘텐츠가 삭제됩니다. 애플리케이션을 사용할 수 없는 동안 배포 콘텐츠를 유지하려면 대신 배포를 비활성화할 수 있습니다. 자세한 내용은 관리 CLI를 사용하여 관리형 도메인에서 애플리케이션 비활성화를 참조하십시오.

사전 요구 사항

  • JBoss EAP는 관리형 도메인으로 실행되고 있습니다.

프로세스

  • 관리 CLI에서 해당 배포를 사용하여 모든 서버 그룹에서 애플리케이션 배포를 취소합니다.

    구문

    deployment undeploy <application_name>.war --all-relevant-server-groups
    Copy to Clipboard Toggle word wrap

    예

    deployment undeploy test-application.war --all-relevant-server-groups
    Copy to Clipboard Toggle word wrap

    배포에 성공하면 관리 CLI에 대한 출력이 생성되지 않지만 다음 출력과 같이 영향을 받는 각 서버에 대한 배포 취소 메시지가 표시됩니다. 

[Server:server-one] WFLYUT0022: Unregistered web context: /test-application
[Server:server-one] WFLYSRV0028: Stopped deployment test-application.war (runtime-name: test-application.war) in 74ms
[Server:server-one] WFLYSRV0009: Undeployed "test-application.war" (runtime-name: "test-application.war")
Copy to Clipboard Toggle word wrap

마찬가지로 배포 undeploy-cli-archive 명령을 사용하여 .cli 아카이브 파일에서 컨텐츠 배포를 취소할 수 있습니다. 와일드카드(*)를 사용하여 모든 배포 배포를 취소할 수도 있습니다. 

deployment undeploy * --all-relevant-server-groups
Copy to Clipboard Toggle word wrap

배포된 애플리케이션을 특정 서버 그룹에서 비활성화하고 해당 배포를 사용하는 다른 서버 그룹의 리포지토리에 해당 콘텐츠를 유지할 수 있습니다.

사전 요구 사항

  • JBoss EAP는 관리형 도메인으로 실행되고 있습니다.

프로세스

  • 관리 CLI에서 배포 disable 명령을 사용하여 단일 애플리케이션 또는 JBoss EAP에 배포된 모든 애플리케이션을 비활성화할 수 있습니다.

    • 단일 애플리케이션 중단:

      구문

      deployment disable <application_name>.war --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      예

      deployment disable test-application.war --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

    • 모든 배포를 비활성화합니다.

      구문

      deployment disable-all --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      예

      deployment disable-all --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

6.1.2.4. 관리 CLI를 사용하여 관리형 도메인에서 애플리케이션 활성화
링크 복사

비활성화된 배포된 애플리케이션을 활성화합니다.

사전 요구 사항

  • JBoss EAP는 관리형 도메인으로 실행되고 있습니다.

프로세스

  • 관리 CLI에서 deployment enable 명령을 사용하여 JBoss EAP에 배포된 단일 애플리케이션 또는 모든 애플리케이션을 활성화할 수 있습니다.

    • 단일 배포를 활성화합니다.

      구문

      deployment enable <deployment> --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      예

      deployment enable test-application.war --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

    • 모든 배포를 활성화합니다. 

      deployment enable-all --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      예

      deployment enable-all --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

6.1.2.5. 관리 CLI를 사용하여 관리형 도메인에 배포 나열
링크 복사

배포 목록을 나열하고 런타임 이름, 상태 등과 같은 배포 정보를 볼 수 있습니다.

사전 요구 사항

  • JBoss EAP는 관리형 도메인으로 실행되고 있습니다.

프로세스

  • 배포 info 명령을 사용하여 배포 정보를 나열합니다. 

    deployment info helloworld.war
    Copy to Clipboard Toggle word wrap

    출력에는 각 서버 그룹에 배포 및 해당 상태가 나열됩니다. 

    NAME               RUNTIME-NAME
helloworld.war     helloworld.war

SERVER-GROUP       STATE
main-server-group  enabled
other-server-group added
    Copy to Clipboard Toggle word wrap

    서버 그룹별 배포 정보를 표시하려면 다음을 수행합니다. 

    deployment info --server-group=other-server-group
    Copy to Clipboard Toggle word wrap

    출력에는 지정된 서버 그룹의 배포 및 해당 상태가 나열됩니다. 

    NAME                 RUNTIME-NAME         STATE
helloworld.war       helloworld.war       added
test-application.war test-application.war enabled
    Copy to Clipboard Toggle word wrap

deployment list 명령을 사용하여 도메인의 모든 배포를 나열 할 수도 있습니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat맨 위로 이동