AEM as a Cloud Service의 트리 복제 워크플로 tree-replication-workflows

콘텐츠 트리의 큰 분기를 게시해야 하는 경우, 표준 페이지별 게시가 느리고 리소스를 많이 사용할 수 있습니다. AEM as a Cloud Service은 관리 가능한 청크로 심층 콘텐츠 계층을 복제하고, 복제 큐가 사용 중일 때 일시 중지하며, 중단되면 다시 시작하는 워크플로우 기반 접근 방식을 제공합니다.

벌크 트리 복제를 위해 트리 활성화 워크플로 단계​를 사용하십시오. 이는 대용량 페이로드에 대해 권장되는 방법입니다. 콘텐츠 트리 게시 워크플로​는 참조할 수 있도록 문서화되었지만 트리 활성화 단계를 위해 더 이상 사용되지 않습니다.

다른 복제 항목은 복제를 참조하십시오.

트리 활성화 워크플로 단계 tree-activation

트리 활성화 워크플로 단계는 콘텐츠 노드의 심층 계층을 강력하게 복제하기 위한 것입니다. 큐가 너무 커지면 자동으로 일시 중지되므로 다른 복제가 지연 시간을 최소화하면서 동시에 진행될 수 있습니다.

TreeActivation 프로세스 단계를 사용하는 워크플로 모델 만들기:

  1. AEM as a Cloud Service 홈페이지에서 도구 - 워크플로 - 모델(으)로 이동합니다.

  2. 워크플로 모델 페이지에서 화면 오른쪽 상단의 만들기​를 누릅니다.

  3. 모델에 제목과 이름을 추가합니다. 자세한 내용은 워크플로 모델 만들기를 참조하십시오.

  4. 목록에서 만든 모델을 선택하고 편집​을 누릅니다.

  5. 다음 창에서 기본적으로 나타나는 단계를 삭제합니다

  6. 프로세스 단계를 현재 모델 플로우로 끌어서 놓습니다.

    프로세스 단계

  7. 흐름에서 프로세스 단계를 선택하고 렌치 아이콘을 눌러 구성​을(를) 선택합니다.

  8. 프로세스 탭을 선택하고 드롭다운 목록에서 Publish Content Tree을(를) 선택한 다음 핸들러 고급 확인란을 선택합니다

    트리 활성화

  9. 인수 필드에서 추가 매개변수를 설정합니다. 여러 개의 쉼표로 구분된 인수를 함께 연결할 수 있습니다. 예:

    enableVersion=false,agentId=publish,chunkSize=50,maxTreeSize=500000,dryRun=false,filters=onlyModified,maxQueueSize=10

    note
    NOTE
    매개변수 목록은 아래의 매개변수 섹션을 참조하십시오.
  10. 완료​를 눌러 워크플로 모델을 저장합니다.

매개변수

이름
기본
설명
경로
시작할 루트 경로
agentId
게시
복제를 받는 에이전트(publish 또는 preview)
청크 크기
50
단일 복제에 번들로 묶을 경로 수
maxTreeSize
500000
트리로 작은 것으로 간주할 최대 노드 수
maxQueueSize
10
복제 큐의 최대 항목 수
enableVersion
false
버전 관리 활성화
dryRun
false
true로 설정하면 복제가 실제로 호출되지 않습니다.
userId
작업 전용입니다. 워크플로우에서는 해당 워크플로우를 호출하는 사용자가 사용됩니다
개의 필터
노드 필터 이름 목록입니다. 아래의 지원되는 필터 를 참조하십시오

지원 필터

이름
설명
only수정됨
노드: 마지막 게시 이후 수정된 신규 및 기존 노드 모두
onlyActivated
노드: 마지막 게시 전에 게시된 노드

지원 다시 시작

워크플로는 콘텐츠를 청크 단위로 처리하며, 각 청크는 게시할 전체 콘텐츠의 하위 집합을 나타냅니다. 시스템이 워크플로우를 중지하면 중단된 부분부터 계속 진행됩니다.

워크플로 진행 상황 모니터링

  1. AEM as a Cloud Service 홈페이지에서 도구 - 일반 - 작업(으)로 이동합니다.

  2. 워크플로우에 해당하는 행을 확인합니다. progress 열은 복제가 진행되는 방식을 나타냅니다. 예를 들어 41/564를 표시하고 새로 고침하면 52/564로 업데이트할 수 있습니다.

    트리 활성화 진행률

  3. 행을 선택하고 열면 워크플로우 실행 상태에 대한 추가 세부 정보가 제공됩니다.

    트리 활성화 상태 세부 정보

콘텐츠 트리 게시 워크플로 publish-content-tree-workflow

NOTE
이 기능은 사용자 지정 워크플로에 포함할 수 있는 더 많은 성능 트리 활성화 단계를 위해 더 이상 사용되지 않습니다.
더 이상 사용되지 않는 기능에 대한 자세한 내용을 보려면 여기를 클릭하십시오 .

도구 - 워크플로 - 모델​을 선택한 다음 아래와 같이 기본 워크플로 모델의 콘텐츠 트리 게시​를 복사하여 트리 복제를 트리거할 수 있습니다.

콘텐츠 트리 게시 워크플로 카드

원래 모델을 호출하지 마십시오. 대신 먼저 모델을 복사하고 해당 복사본을 호출해야 합니다.

모든 워크플로와 마찬가지로 API를 통해 호출할 수도 있습니다. 자세한 내용은 프로그래밍 방식으로 워크플로와 상호 작용을 참조하십시오.

또는 Publish Content Tree 프로세스 단계를 사용하는 워크플로 모델을 만들 수 있습니다.

  1. AEM as a Cloud Service 홈페이지에서 도구 - 워크플로 - 모델(으)로 이동합니다.

  2. 워크플로 모델 페이지에서 화면 오른쪽 상단의 만들기​를 누릅니다.

  3. 모델에 제목과 이름을 추가합니다. 자세한 내용은 워크플로 모델 만들기를 참조하십시오.

  4. 목록에서 만든 모델을 선택하고 편집​을 누릅니다.

  5. 다음 창에서 프로세스 단계를 현재 모델 플로우로 드래그하여 놓습니다.

    프로세스 단계

  6. 흐름에서 프로세스 단계를 선택하고 렌치 아이콘을 눌러 구성​을(를) 선택합니다.

  7. 프로세스 탭을 선택하고 드롭다운 목록에서 Publish Content Tree을(를) 선택한 다음 핸들러 고급 확인란을 선택합니다

    트리 활성화

  8. 인수 필드에서 추가 매개변수를 설정합니다. 여러 개의 쉼표로 구분된 인수를 함께 연결할 수 있습니다. 예:

    enableVersion=true,agentId=publish,includeChildren=true

    note
    NOTE
    매개변수 목록은 아래의 매개변수 섹션을 참조하십시오.
  9. 완료​를 눌러 워크플로 모델을 저장합니다.

매개변수

  • includeChildren(부울 값, 기본값: false) 값 false은(는) 경로만 게시됨을 의미하고 true은(는) 하위 항목도 게시됨을 의미합니다.

  • replicateAsParticipant(부울 값, 기본값: false) true로 구성된 경우 복제는 참가자 단계를 수행한 원칙의 userid를 사용합니다.

  • enableVersion(부울 값, 기본값: false) 이 매개변수는 복제 시 새 버전을 만들지 여부를 결정합니다.

  • agentId(문자열 값, 기본값은 게시용 에이전트만 사용됨을 의미합니다.) 대상 에이전트를 명시적으로 지정하십시오(예: 라이브 게시 계층의 경우 publish, 미리 보기 계층의 경우 preview).

  • filters(문자열 값, 기본값은 모든 경로가 활성화되었음을 의미합니다.) 사용 가능한 값은 다음과 같습니다.

    • onlyActivated - (이미) 활성화된 페이지만 활성화합니다. 재활성화의 한 형태로 작동합니다.
    • onlyModified - 이미 활성화된 경로만 활성화하며 활성화 날짜 이후의 수정 날짜가 있습니다.
    • 위에서는 파이프 “|”을 사용하여 OR 구문을 만들 수 있습니다. (예: onlyActivated|onlyModified)

로깅

트리 활성화 워크플로 단계가 시작되면 INFO 로그 수준에 구성 매개 변수가 기록됩니다. 경로가 활성화되면 INFO 문도 기록됩니다.

워크플로 단계가 모든 경로를 복제한 후 최종 INFO 문이 기록됩니다.

또한 com.day.cq.wcm.workflow.process.impl 아래의 로거의 로그 수준을 DEBUG/TRACE으로 높여 더 많은 로그 정보를 가져올 수 있습니다.

오류가 있으면 워크플로 단계가 WorkflowException(으)로 종료되어 기본 예외가 래핑됩니다.

다음은 샘플 게시 콘텐츠 트리 워크플로 중에 생성된 로그의 예입니다.

code language-none
21.04.2021 19:14:55.566 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.treeactivation.TreeActivationWorkflowProcess TreeActivation options: replicateAsParticipant=false(userid=workflow-process-service), agentId=publish, chunkSize=100, filter=, enableVersion=false
code language-none
21.04.2021 19:14:58.541 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.ChunkedReplicator closing chunkedReplication-VolatileWorkItem_node1_var_workflow_instances_server60_2021-04-20_brian-tree-replication-test-2_1, 17 paths replicated in 2971 ms
recommendation-more-help
experience-manager-cloud-service-help-main-toc