AEM as a Cloud Service에서 트리 활성화 방법

때로는 문서나 자산의 전체 트리를 게시해야 할 때가 있습니다. 예를 들어, 전체 문서 시리즈가 라이브로 배포될 준비가 되었을 때나, AEM as a Cloud Service로 자산 마이그레이션을 완료했을 때 등이 해당됩니다. 최근 몇 년간 대량 활성화 작업을 수행하는 방식이 변경되었습니다. 이제 AEM Cloud Service에서 과거 방식대로 트리 복제를 수행할 수 없습니다. 다음은 변경된 내용입니다:

AEM 이전 버전에서의 트리 복제

이전 버전의 AEM(예: AEM 6.5 및 이전 버전에서는 대량 활성화(또는 "대량 게시")를 수행해야 할 경우 AEM의 "트리 복제" 또는 "트리 활성화" 기능을 사용했습니다. 이 작업은 복제하려는 모든 페이지 또는 자산을 대기열에 추가하고, 각각을 AEM의 복제 대기열에 추가합니다.
이 시점에서, 당신은 AEM을 설정하는 가장 전통적이고 클래식한 방법 중 하나를 시작했습니다. 이 과정에서는 여러 가지 문제가 발생할 수 있으며, 실제로 자주 발생합니다:

• 복제 대기열은 콘텐츠 트리의 크기, AEM에 활성화하도록 지정한 콘텐츠 트리의 크기, 그리고 가져와야 할 하위 자산이나 자식 페이지의 수에 따라 수백 개, 수천 개, 때로는 수십만 개의 자산과 페이지로 채워질 수 있습니다.
• AEM 작성자는 해당 복제 트래픽을 모두 임시 저장소에 끌어와 AEM 퍼블리셔로 전송하려고 시도하는 과정에서 심각한 성능 저하를 겪을 수 있습니다.
• 현재 다른 작성자들이 수행 중인 일반적인 페이지 활성화 작업은 이 대규모 복제 트래픽 큐 뒤로 대기해야 하며, 이 큐는 수 시간 (심지어 일부 사례에서는 주말 내내) 소요될 수 있습니다.
• 출판사 중 어느 하나라도 문제가 발생하면(예: 출판사 중 하나가 높은 CPU 사용률을 보이고, 항목이 복제되는 동안 네트워크 또는 저장소 문제 발생, 직원 샤먼이 하늘에 불길한 징조를 발견하는 등 어떤 이유든) 복제 대기열이 중단됩니다. 이 문제는 해당 문제가 해결될 때까지 전체 복제 대기열이 중단된 상태로 유지됩니다.
• 자산이나 페이지 중 복제되는 항목에 권한 문제가 발생하면(예: 해당 자산을 게시한 사용자가 어떤 이유로든 전체 트리에 액세스 권한이 없거나, 게시자 중 하나에 대해 수동으로 처리된 사항이 있어 고려하지 않은 경우), 전체 큐가 중단됩니다.
• 또는 트리 복제 이벤트가 캐시 무효화 이벤트를 너무 많이 발생시켜 들어오는 부하가 자산 활성화를 반복적으로 시도하는 중 출판 서버를 다운시킬 수 있습니다.

AEM 사이트를 일정 기간 운영해본 사람이라면 누구나 트리 복제와 관련된 복제 문제 및 사이트 안정성 문제를 경험했을 것입니다.

AEM 클라우드 서비스에서의 트리 복제

AEM as a Cloud Service가 처음 출시되었을 때, 트리 복제 기능은 여전히 사용 가능했으며(일부 제한 사항이 적용됨) AEM 6.5에서 수행되던 방식과 유사한 방식으로 구현되었습니다. (트리 복제 UI는 2021년 말에 실제로 제거되었습니다)

먼저, AEM 6.5 및 이전 버전에서 "복제(replication)"로 알려진 기능은 이제 콘텐츠가 Author에서 Publish로 전송되는 방식이 아니라는 점을 유의하시기 바랍니다. 이 작업은 이제 Sling Distribution을 통해 수행됩니다. 이 AdaptTo 동영상을 시청하시면 해당 기능이 어떻게 작동하는지 자세히 알아보실 수 있습니다:

새로운 트리 복제 메커니즘은 "Publish Content Tree"워크플로우입니다.
이 워크플로는 기본적으로 다음과 같은 작업을 수행합니다:

• 워크플로우를 시작하면 활성화하려는 트리의 수준(즉, 어떤 수준부터 시작할지)을 지정하는 페이로드가 표시됩니다.
• AEM은 워크플로를 시작하고 트리 복제를 패키지로 분할한 후 Sling Distribution을 통해 모든 퍼블리셔에게 배포합니다. 전체 페이로드 경로를 재귀적으로 탐색하여 완료될 때까지 진행됩니다.

다음은 이를 활용하기 위한 단계입니다: 예를 들어, 온프레미스 AEM 6.5 Assets 인스턴스에서 AEM as a Cloud Service로 자산 마이그레이션을 완료했다고 가정해 보겠습니다. 예를 들어, "/content/dam/arborydigital/images"라는 경로에 수천 개의 이미지를 포함하는 여러 하위 디렉토리가 있으며, 이 모든 이미지를 활성화하고 싶다고 가정해 보겠습니다. 이들을 활성화/게시하려면:

1. AEM Cloud Service Author 인스턴스로 이동하세요.

2. 도구 -> 워크플로우 -> 모델

   

3. 상단 오른쪽에 있는 “CREATE”를 클릭한 후 “Create Model”을 클릭하세요.

4. 이름을 지어주세요.

   

5. 워크플로우 모델을 클릭하고 "편집"을 클릭하세요.

   

6. "프로세스 단계"를 검색하고 워크플로우의 단계로 드래그하여 추가하세요.

   

7. 프로세스 단계를 클릭한 후 톱니바퀴 아이콘을 클릭하여 해당 단계를 구성합니다. 팝업 창에 표시되는 "PROCESS" 탭을 클릭하세요.

8. "콘텐츠 트리 게시" 프로세스를 선택하고 "핸들러 사전 처리" 체크박스를 선택합니다.

9. 인수(arguments)에 “enableVersion=true,agentId=publish,includeChildren=true”를 추가하세요. 기본적으로 Publish Content Tree 워크플로는 자식 항목을 포함하지 않습니다. 이 인수를 추가하면 워크플로우가 트리를 순회하며 모든 자식 노드를 게시합니다.
   또한, 이 워크플로우를 Publish 티어 대신 Preview에만 적용하려면 “agentId=preview”를 인수로 지정하시면 됩니다. ( 에릭 반 지엠에게 이 점을 지적해 주셔서 감사합니다!)

10. 화면 오른쪽 상단의 “SYNC” 버튼을 클릭하세요.

    

11. 워크플로우 모델 목록에서 새로운 워크플로우를 선택한 후 "워크플로우 시작"을 클릭하세요. 팝업 창이 표시되면 "Payload" 섹션에서 활성화하려는 트리를 직접 입력하거나 탐색하여 선택할 수 있습니다. 예를 들어, "/content/dam/arborydigital/images"를 입력하면 해당 디렉토리 아래의 모든 노드가 활성화됩니다. "실행"을 클릭하세요.

    

12. 워크플로우가 시작되며, 활성화하도록 지정한 자산의 수에 따라 몇 분에서 몇 시간까지 소요될 수 있습니다.

13. 모니터링: 복제 이벤트의 상태를 모니터링하려면 Splunk에서 `aemerror` 로그를 확인하거나 명령줄에서 Adobe IO를 사용하여 AEM 오류 로그를 테일링할 수 있습니다.
    
    다음과 같은 이벤트가 표시되면 트리 활성화 패키지가 배포 중임을 의미합니다:
    
    2024.08.20 13:53:24.538 [cm-p107857-e1299068-aem-author-6d6b4bddf6-bnhwx] *INFO* [EventAdminAsyncThread #7] org.apache.sling.distribution.journal.impl.publisher.DistributionPublisher [publish] 패키지 ID dstrpck-1724161011143-d6d35a6a-d557-4f99-9906-e8eb55e7772c를 성공적으로 적용했습니다. 유형: ADD, 경로: [/content/dam/arborydigital/images/smoothing-spline-jmp.jpg, /content/dam/arborydigital/images/screenshots/gallery/blorp.jpg…

제한 사항: 현재까지 자산 활성화에 있어 "어떤 크기가 너무 큰지"에 대한 제한을 경험하지 않았습니다. 이 블로그 글을 작성하는 동안 AEM Cloud Service에서 약 100GB의 자산을 포함하는 콘텐츠 트리에 대한 트리 복제 워크플로를 시작했으며, 트리 복제가 블로그 글을 작성하는 동안 완료되었습니다.
이것이 잘 작동하기를 바랍니다!

저자 소개

들으신 내용이 마음에 드시나요? 어떤 것이 적합한지 궁금한 점이 있으신가요? 상담하고 싶어요! 문의하기

팟캐스트 에피소드 & 블로그 게시물