Adobe 컨텐츠 패키지 Maven 플러그인

Content Package Maven 플러그인을 사용하여 패키지 배포 및 관리 작업을 Maven 프로젝트에 통합합니다.

AEM에 구축된 패키지의 배포는 Adobe Content Package Maven 플러그인에 의해 수행되며, AEM을 사용하여 정상적으로 수행되는 작업의 자동화를 활성화합니다 패키지 관리자:

• 파일 시스템의 파일에서 새 패키지를 만듭니다.
• AEM에서 패키지를 설치 및 제거합니다.
• AEM에 이미 정의된 패키지를 만듭니다.
• AEM에 설치된 패키지 목록을 확인합니다.
• AEM에서 패키지를 제거합니다.

이 문서에서는 Maven을 사용하여 이러한 작업을 관리하는 방법에 대해 자세히 설명합니다. 하지만 또한 이해하는 것이 중요합니다 AEM 프로젝트 및 해당 패키지의 구성 방법.

패키지 및 AEM 프로젝트 구조

AEM은 최신 AEM Project Archetype에 의해 구현된 대로 패키지 관리 및 프로젝트 구조에 대한 최신 모범 사례를 준수합니다.

Content Package Maven 플러그인 가져오기

플러그인은 Maven 중앙 저장소.

컨텐츠 패키지 Maven 플러그인 목표 및 매개 변수

Content Package Maven 플러그인을 사용하려면 POM 파일의 빌드 요소 내에 다음 플러그인 요소를 추가합니다.

<plugin>
 <groupId>com.day.jcr.vault</groupId>
 <artifactId>content-package-maven-plugin</artifactId>
 <version>0.0.24</version>
 <configuration>
       <!-- parameters and values common to all goals, as required -->
 </configuration>
</plugin>

Maven이 플러그인을 다운로드하도록 하려면, Content Package Maven 플러그인 가져오기 섹션을 참조하십시오.

Content Package Maven 플러그인의 목표

컨텐츠 패키지 플러그인이 제공하는 목표 및 목표 매개 변수는 다음에 나오는 섹션에 설명되어 있습니다. 일반 매개 변수 섹션에 설명된 매개 변수는 대부분의 목표에 사용할 수 있습니다. 하나의 목표에 적용되는 매개 변수는 해당 목표에 대한 섹션에 설명되어 있습니다.

플러그인 접두사

플러그인 접두사는 다음과 같습니다. content-package. 다음 예제와 같이 명령줄에서 목표를 실행하려면 이 접두사를 사용합니다.

mvn content-package:build

매개 변수 접두사

별도로 언급되지 않는 한 플러그인 목표 및 매개 변수는 vault 접두사를 추가합니다.

mvn content-package:install -Dvault.targetURL="https://192.168.1.100:4502/crx/packmgr/service.jsp"

프록시

AEM용 프록시를 사용하는 목표는 Maven 설정에 있는 첫 번째 유효한 프록시 구성을 사용합니다. 프록시 구성이 없으면 프록시가 사용되지 않습니다. 자세한 내용은 useProxy 의 매개 변수 공통 매개 변수 섹션을 참조하십시오.

공통 매개 변수

다음 표의 매개 변수는 목표 열.

빌드

AEM 인스턴스에 이미 정의된 컨텐츠 패키지를 만듭니다.

매개 변수

빌드 목표에 대한 모든 매개 변수는 공통 매개 변수 섹션을 참조하십시오.

설치

저장소에 패키지를 설치합니다. 이 목표를 실행할 때에는 Maven 프로젝트가 필요하지 않습니다. 그 목표는 . install Maven 빌드 라이프사이클의 단계입니다.

매개 변수

다음 매개 변수 외에 의 설명을 참조하십시오. 공통 매개 변수 섹션을 참조하십시오.

ls

에 배포되는 패키지를 나열합니다 패키지 관리자.

매개 변수

ls 목표의 모든 매개 변수는 공통 매개 변수 섹션을 참조하십시오.

rm

에서 패키지 제거 패키지 관리자.

매개 변수

rm 목표의 모든 매개 변수는 공통 매개 변수 섹션을 참조하십시오.

제거

패키지를 제거합니다. 패키지는 제거된 상태로 서버에 남아 있습니다.

매개 변수

제거 목표의 모든 매개 변수는 공통 매개 변수 섹션을 참조하십시오.

패키지

컨텐츠 패키지를 만듭니다. 패키지 목표의 기본 구성에는 컴파일된 파일이 저장된 디렉토리의 내용이 포함됩니다. 패키지 목표를 실행하려면 컴파일 빌드 단계가 완료되어야 합니다. 패키지 목표는 Maven 빌드 라이프사이클의 패키지 단계에 바인딩됩니다.

매개 변수

다음 매개 변수 외에 name 의 매개 변수 공통 매개 변수 섹션을 참조하십시오.

필터 사용

필터 요소를 사용하여 패키지 콘텐츠를 정의합니다. 필터가 workspaceFilter 요소의 요소 META-INF/vault/filter.xml 패키지의 파일입니다.

다음 필터 예제에서는 사용할 XML 구조를 보여 줍니다.

<filter>
   <root>/apps/myapp</root>
   <mode>merge</mode>
       <includes>
              <include>/apps/myapp/install/</include>
              <include>/apps/myapp/components</include>
       </includes>
       <excludes>
              <exclude>/apps/myapp/config/*</exclude>
       </excludes>
</filter>

가져오기 모드

다음 mode 요소는 패키지를 가져올 때 저장소가 미치는 영향을 정의합니다. 다음 값을 사용할 수 있습니다.

• 병합: 저장소에 아직 없는 패키지의 콘텐츠가 추가됩니다. 패키지와 저장소 모두에 있는 컨텐츠는 변경되지 않습니다. 저장소에서 콘텐츠가 제거되지 않습니다.
• 바꾸기: 저장소에 없는 패키지의 콘텐츠가 저장소에 추가됩니다. 저장소의 컨텐츠는 패키지의 일치하는 컨텐츠로 대체됩니다. 패키지에 존재하지 않으면 저장소에서 컨텐츠가 제거됩니다.
• 업데이트: 저장소에 없는 패키지의 콘텐츠가 저장소에 추가됩니다. 저장소의 컨텐츠는 패키지의 일치하는 컨텐츠로 대체됩니다. 기존 컨텐츠가 저장소에서 제거됩니다.

필터에 없음 포함 mode 요소, 기본값은 replace 이 사용됩니다.

도움말

매개 변수

패키지에 축소판 이미지 또는 속성 파일 포함

기본 패키지 구성 파일을 대체하여 패키지 속성을 사용자 지정합니다. 예를 들어 의 패키지를 구분할 수 있도록 축소판 이미지를 포함합니다 패키지 관리자.

소스 파일은 파일 시스템의 어느 곳에서든 찾을 수 있습니다. POM 파일에서 소스 파일을 target/vault-work/META-INF 를 참조하십시오.

다음 POM 코드는 META-INF 패키지에 대한 프로젝트 소스의 폴더:

<build>
    <resources>
        <!-- vault META-INF resources (thumbnail etc.) -->
        <resource>
            <directory>${basedir}/src/main/content/META-INF</directory>
            <targetPath>../vault-work/META-INF</targetPath>
        </resource>
    </resources>
</build>

다음 POM 코드는 패키지에 축소판 이미지만 추가합니다. 축소판 이미지의 이름을 지정해야 합니다 thumbnail.png, 및은(는) META-INF/vault/definition 패키지의 폴더입니다. 이 예제에서 소스 파일은 /src/main/content/META-INF/vault/definition 프로젝트의 폴더:

<build>
    <resources>
        <!-- thumbnail only -->
        <resource>
            <directory>${basedir}/src/main/content/META-INF/vault/definition</directory>
            <targetPath>../vault-work/META-INF/vault/definition</targetPath>
        </resource>
    </resources>
</build>

AEM Project Archetype을 사용하여 AEM 프로젝트 생성

최신 AEM 프로젝트 원형 은 온프레미스 및 AMS 구현 모두에 대한 모범 사례 패키지 구조를 구현하며 모든 AEM 프로젝트에 권장됩니다.