패키지 관리자 working-with-packages

패키지를 사용하면 저장소 콘텐츠를 가져오고 내보낼 수 있습니다. 패키지를 사용하여 새 콘텐츠를 설치하고 새 기능을 설치하고 인스턴스 간에 콘텐츠를 전송하고 저장소 콘텐츠를 백업할 수 있습니다.

패키지 관리자를 사용하면 개발 목적으로 AEM 인스턴스와 로컬 파일 시스템 간에 패키지를 전송할 수 있습니다.

패키지란 무엇입니까? what-are-packages

패키지는 파일 시스템 직렬화 형식의 저장소 콘텐츠를 포함하는 zip 파일로, 저장소 직렬화라고 하며, 파일 및 폴더를 사용하기 쉽고 편집하기 쉬운 표현입니다. 패키지에 포함된 콘텐츠는 필터를 사용하여 정의됩니다.

패키지에는 필터 정의 및 가져오기 구성 정보를 포함한 저장소 메타 정보도 포함됩니다. 설명, 시각적 이미지 또는 아이콘과 같이 패키지 추출에 사용되지 않는 추가 콘텐츠 속성을 패키지에 포함할 수 있습니다. 이러한 추가 콘텐츠 속성은 콘텐츠 패키지 소비자를 위한 것이며 정보 제공 목적으로만 사용됩니다.

패키지 관리자 package-manager

패키지 관리자는 AEM 설치에서 패키지를 관리합니다. 필요한 권한을 할당한 후에는 패키지 구성, 빌드, 다운로드 및 설치를 포함한 다양한 작업에 패키지 관리자를 사용할 수 있습니다.

필수 권한 required-permissions

패키지를 생성, 수정, 업로드 및 설치하려면 사용자에게 다음 노드에 대한 적절한 권한이 있어야 합니다.

패키지 관리자 액세스 accessing

다음 세 가지 방법으로 패키지 관리자에 액세스할 수 있습니다.

패키지 관리자 UI ui

Package Manager 는 네 가지 주요 기능 영역으로 나뉩니다.

왼쪽 탐색 패널에서 옵션을 클릭하면 패키지 목록이 즉시 필터링됩니다.

패키지 이름을 클릭하면 패키지 목록의 항목이 확장되어 패키지에 대한 세부 정보가 표시됩니다.

패키지 세부 사항을 확장할 때 사용할 수 있는 도구 모음 버튼을 통해 패키지에서 수행할 수 있는 여러 작업이 있습니다.

추가 작업은 자세히 단추 아래에서 사용할 수 있습니다.

패키지 상태 package-status

패키지 목록의 각 항목에는 패키지의 상태를 한 눈에 알 수 있도록 상태 표시기가 있습니다. 상태를 마우스로 가리키면 상태의 세부 정보와 함께 도구 설명이 표시됩니다.

패키지를 변경했거나 빌드한 적이 없는 경우 상태는 패키지를 다시 빌드하거나 설치하기 위해 빠른 조치를 취하는 링크로 표시됩니다.

패키지 설정 package-settings

패키지는 기본적으로 필터 세트이며 이러한 필터를 기반으로 하는 저장소 데이터입니다. 패키지 관리자 UI를 사용하여 패키지를 클릭한 다음 편집 단추를 클릭하여 다음 설정을 포함한 패키지의 세부 정보를 볼 수 있습니다.

일반 설정 general-settings

다양한 패키지 설정을 편집하여 패키지 설명, 종속성 및 공급자 세부 사항과 같은 정보를 정의할 수 있습니다.

패키지 설정 대화 상자는 패키지를 만들기 또는 편집할 때 편집 단추를 통해 사용할 수 있습니다. 변경 사항이 있으면 저장 ​을 클릭하세요.

패키지 썸네일 thumbnails

썸네일은 패키지에 포함된 내용에 대한 빠른 참조 시각적 표현을 제공합니다. 그런 다음 패키지 목록에 표시되며 패키지 또는 패키지 클래스를 쉽게 식별할 수 있습니다.

다음은 공식 패키지에 사용되는 규칙의 예입니다.

공식 핫픽스

확장의 공식 AEM 설치

공식 서비스 팩

패키지에 고유한 아이콘을 사용합니다. Adobe에서 사용하는 아이콘을 재사용하지 마십시오.

패키지 필터 package-filters

필터는 패키지에 포함할 저장소 노드를 식별합니다. 필터 정의 ​는 다음 정보를 지정합니다.

+ 단추를 사용하여 규칙을 추가합니다. - 단추를 사용하여 규칙을 제거합니다.

규칙은 순서에 따라 적용되므로 위쪽 및 아래쪽 화살표 단추를 사용하여 필요에 따라 배치합니다.

필터에는 0개 이상의 규칙이 포함될 수 있습니다. 규칙이 정의되지 않으면 패키지에는 루트 경로 아래의 모든 콘텐츠가 포함됩니다.

패키지에 대해 하나 이상의 필터 정의를 정의할 수 있습니다. 여러 루트 경로의 콘텐츠를 포함하려면 두 개 이상의 필터를 사용하십시오.

규칙을 생성할 때 정규 표현식(regex, regexp 또는 rational expression이라고도 함)을 정의하여 포함 또는 제외할 모든 노드를 지정합니다.

패키지 필터는 처음 패키지를 만들 때 가장 자주 정의됩니다. 그러나 나중에 편집할 수도 있습니다. 그런 다음 새 필터 정의를 기반으로 콘텐츠를 업데이트하도록 패키지를 다시 빌드해야 합니다.

종속성 dependencies

고급 설정 advanced-settings

패키지 스크린샷 package-screenshots

패키지에 여러 스크린샷을 연결하여 콘텐츠가 표시되는 방식을 시각적으로 나타낼 수 있습니다.

패키지 작업 package-actions

패키지에서 수행할 수 있는 작업은 여러 가지가 있습니다.

패키지 만들기 creating-a-new-package

패키지를 생성한 후 즉시 패키지를 빌드해야 하는 것은 아닙니다. 빌드되지 않은 패키지는 콘텐츠를 포함하지 않고 패키지의 필터 데이터와 기타 메타데이터로만 구성됩니다.

패키지 빌드 building-a-package

패키지는 종종 패키지를 만들기와 동시에 빌드되지만 나중에 다시 돌아와 패키지를 빌드하거나 다시 빌드할 수 있습니다. 이 기능은 저장소 내의 콘텐츠가 변경되었거나 패키지 필터가 변경된 경우에 유용합니다.

패키지 편집 edit-package

패키지가 AEM에 업로드되면 설정을 수정할 수 있습니다.

변경 내용을 기반으로 콘텐츠를 업데이트하려면 패키지를 다시 빌드해야 할 수 있습니다.

패키지 다시 래핑 rewrapping-a-package

패키지가 빌드되면 다시 래핑할 수 있습니다. 다시 래핑하면 패키지 내용을 변경하지 않고 썸네일, 설명 등과 같은 패키지 정보를 변경하지 않습니다.

다른 패키지 버전 보기 other-versions

패키지의 모든 버전은 다른 패키지와 마찬가지로 목록에 표시되므로 패키지 관리자는 선택한 패키지의 다른 버전을 찾을 수 있습니다.

패키지 내용 보기 및 설치 테스트 viewing-package-contents-and-testing-installation

패키지가 빌드되면 콘텐츠를 볼 수 있습니다.

파일 시스템에 패키지 다운로드 downloading-packages-to-your-file-system

패키지 공유 share

패키지 공유는 콘텐츠 패키지를 배포하기 위한 중앙 집중식 공개 서비스였습니다. 패키지 공유가 소프트웨어 배포로 대체되었으며 이 단추는 더 이상 작동하지 않습니다.

파일 시스템에서 패키지 업로드 uploading-packages-from-your-file-system

이제 패키지 콘텐츠가 AEM에 있지만 콘텐츠를 사용할 수 있도록 하려면 패키지를 설치하십시오.

패키지 확인 validating-packages

패키지는 기존 콘텐츠를 수정할 수 있으므로 설치하기 전에 이러한 변경 사항의 유효성을 검사하는 것이 유용한 경우가 많습니다.

유효성 검사 옵션 validation-options

패키지 관리자는 다음 유효성 검사를 수행할 수 있습니다.

OSGi 패키지 가져오기 유효성 검사 osgi-package-imports

확인된 항목

이 유효성 검사는 모든 JAR 파일(OSGi 번들)에 대한 패키지를 검사하고 해당 manifest.xml(해당 OSGi 번들이 의존하는 버전화된 종속성을 포함)을 추출하며 AEM 인스턴스가 해당 종속성을 올바른 버전과 내보내는지 확인합니다.

보고 방법

AEM 인스턴스가 충족할 수 없는 버전 종속 항목은 패키지 관리자의 작업 로그에 나열됩니다.

오류 상태

종속성이 충족되지 않으면 해당 종속성이 있는 패키지의 OSGi 번들이 시작되지 않습니다. 따라서 시작되지 않은 OSGi 번들에 의존하는 모든 것이 결국 제대로 작동하지 않아 애플리케이션 배포가 중단됩니다.

오류 해결

충족되지 않은 OSGi 번들로 인한 오류를 해결하려면 충족되지 않은 가져오기가 포함된 번들의 종속성 버전을 조정해야 합니다.

오버레이 유효성 검사 overlays

확인된 항목

이 유효성 검사는 설치 중인 패키지에 대상 AEM 인스턴스에 이미 오버레이된 파일이 포함되어 있는지 확인합니다.

예를 들어 /apps/sling/servlet/errorhandler/404.jsp에 기존 오버레이가 있는 경우 /libs/sling/servlet/errorhandler/404.jsp이(가) 포함된 패키지가 /libs/sling/servlet/errorhandler/404.jsp에 있는 기존 파일을 변경하게 됩니다.

보고 방법

이러한 모든 오버레이는 패키지 관리자의 작업 로그에 설명되어 있습니다.

오류 상태

오류 상태는 패키지가 이미 오버레이된 파일을 배포하려고 시도하고 있음을 의미하므로 패키지의 변경 사항이 오버레이에 의해 재정의되고(따라서 "숨김") 적용되지 않습니다.

오류 해결

이 문제를 해결하려면 /apps의 오버레이 파일 유지 관리자가 /libs에서 오버레이된 파일의 변경 사항을 검토하고 필요에 따라 변경 사항을 오버레이( /apps)에 통합한 다음 오버레이된 파일을 다시 배포해야 합니다.

ACL 유효성 검사 acls

확인된 항목

이 유효성 검사는 추가되는 권한, 처리 방법(병합/바꾸기) 및 현재 권한에 영향을 주는지 확인합니다.

보고 방법

권한은 패키지 관리자의 작업 로그에 설명되어 있습니다.

오류 상태

명시적 오류를 제공할 수 없습니다. 유효성 검사는 새 ACL 권한이 패키지 설치에 의해 추가되거나 영향을 받는지 여부만 표시합니다.

오류 해결

유효성 검사에서 제공한 정보를 사용하여 영향을 받는 노드를 CRXDE에서 검토하고 필요에 따라 ACL을 패키지에서 조정할 수 있습니다.

유효성 검사 수행 performing-validation

패키지의 유효성 검사는 다음 두 가지 방법으로 수행할 수 있습니다.

패키지를 업로드한 후 설치하기 전에 항상 유효성 검사가 수행되어야 합니다.

패키지 관리자를 통한 패키지 유효성 검사 via-package-manager

HTTP POST 요청을 통한 패키지 유효성 검사 via-post-request

POST 요청은 다음 양식을 사용합니다.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

type 매개 변수는 쉼표로 구분된 다음 무순서 목록일 수 있습니다.

명시적으로 전달되지 않은 경우 type의 값은 기본적으로 osgiPackageImports입니다.

cURL을 사용할 때 다음과 유사한 문을 실행합니다.

curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'

POST 요청을 통해 유효성을 검사할 때 응답은 JSON 개체로 다시 전송됩니다.

패키지 범위 보기 package-coverage

패키지는 해당 필터에 의해 정의됩니다. 패키지 관리자에서 기존 저장소 콘텐츠에 패키지 필터를 적용하여 패키지의 필터 정의에 포함되는 저장소 콘텐츠를 표시하도록 할 수 있습니다.

패키지 설치 installing-packages

패키지를 업로드하면 패키지 콘텐츠가 저장소에만 추가되지만 액세스할 수 없습니다. 업로드된 패키지를 설치하여 패키지의 콘텐츠를 사용합니다.

패키지를 설치하기 전에 패키지 관리자에서 덮어쓸 콘텐츠가 포함된 스냅샷 패키지를 자동으로 만듭니다. 패키지를 제거하면 이 스냅샷이 다시 설치됩니다.

설치가 완료되고 성공하면 패키지 목록이 업데이트되고 패키지 상태에 설치됨 ​이라는 단어가 나타납니다.

패키지 재설치 reinstalling-packages

패키지를 다시 설치하면 처음 패키지를 설치할 때 처리된 이미 설치된 패키지에서 동일한 단계를 수행합니다.

파일 시스템 기반 업로드 및 설치 file-system-based-upload-and-installation

패키지를 설치할 때 패키지 관리자를 모두 포기할 수 있습니다. AEM은 호스트 시스템의 로컬 파일 시스템에서 특정 위치에 배치된 패키지를 감지하여 자동으로 업로드 및 설치할 수 있습니다.

인스턴스가 실행 중인 경우 패키지를 install 폴더에 추가하면 즉시 업로드 및 설치가 시작됩니다

인스턴스가 실행되고 있지 않으면 install 폴더에 배치된 패키지가 시작 시 알파벳 순서로 설치됩니다.

패키지 제거 uninstalling-packages

패키지를 제거하면 저장소의 내용이 설치 전에 패키지 관리자에서 자동으로 만든 스냅샷으로 되돌아갑니다.

패키지 삭제 deleting-packages

패키지를 삭제하면 패키지 관리자에서 세부 사항만 삭제됩니다. 이 패키지가 이미 설치된 경우 설치된 콘텐츠는 삭제되지 않습니다.

패키지 복제 replicating-packages

패키지의 콘텐츠를 복제하여 게시 인스턴스에 설치합니다.

소프트웨어 배포 software-distribution

AEM 패키지를 사용하여 AEM 환경에서 콘텐츠를 만들고 공유할 수 있습니다.

Software Distribution은(는) AEM 패키지의 검색 및 다운로드를 간소화하기 위해 고안된 중앙 집중식 서비스입니다.

자세한 내용은 소프트웨어 배포 설명서를 참조하십시오.