최적화된 GraphQL 필터링을 위해 콘텐츠 조각 업데이트

AEM as a Cloud Service의 2023.1.0 이상 릴리스가 있는지 확인하십시오.

작업을 수행하는 사용자에게 필요한 권한이 있는지 확인하십시오.

• 최소한 Cloud Manager의 Deployment Manager 역할이 필요합니다.

Cloud Manager UI를 사용해 인스턴스에 대해 다음 변수를 설정하여 업데이트를 활성화합니다.

사용 가능한 변수는 다음과 같습니다.

NOTE

(*)

CF_MIGRATION_INTERVAL의 값은 또한 마이그레이션 작업의 총 실행 시간을 추정하는 데 도움이 될 수 있습니다.

예:

• 콘텐츠 조각의 총 수 = 20,000
• CF_MIGRATION_LIMIT = 1000
• CF_MIGRATION_INTERNAL = 60(초)
• 마이그레이션 완료에 필요한 대략적인 시간 = 60 + (20,000/1000 * 60) = 1260초 = 21분
  시작 시 추가된 “60”초는 작업 시작 시 초기 지연으로 인한 것입니다.

이는 작업을 완료하는 데 필요한 최소한 ​의 시간이며 I/O 시간은 포함하지 않습니다. 소요되는 실제 시간은 이 추정치보다 더 클 수 있습니다.

진행 상황과 업데이트 완료를 모니터링합니다.

이를 위해서는 다음의 작성자 및 골든 게시에 대한 로그를 모니터링하십시오.

• com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob

  • 작성자 로그, 예:

    23.01.2023 13:13:45.926 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<dd9ffdc1-0c28-4d04-9a96-5d4d223e457e> is the leader, will schedule the upgrade schedule job.
    ...
    23.01.2023 13:13:45.941 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, enforce: true, limit: 1000, batch: 50, interval: 60s
    
    23.01.2023 13:20:40.960 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 6m, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}
    

  • 골든 게시 로그, 예:

    23.01.2023 12:35:05.150 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<ad1b399e-77be-408e-bc3f-57097498fddb> is the leader, will schedule the upgrade schedule job.
    
    23.01.2023 12:35:05.161 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, enforce: true, limit: 1000, batch: 50, interval: 60s
    ...
    23.01.2023 12:40:45.180 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 5m, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}
    

Splunk를 사용하여 환경 로그에 대한 액세스를 활성화한 고객은 아래 예제 쿼리를 사용하여 업그레이드 프로세스를 모니터링할 수 있습니다. Splunk 로깅 활성화에 대한 자세한 내용은 프로덕션 및 스테이지 디버깅을 참조하십시오.

index=<indexName> sourcetype=aemerror aem_envId=<environmentId> msg="*com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished*"
(aem_tier=golden-publish OR aem_tier=author) | table _time aem_tier pod_name msg | sort -_time desc

위치:

• environmentId - 고객 환경 식별자 (예: e1234)
• indexName - 고객 색인 이름, aemerror 이벤트 수집

출력 예:

업데이트 절차를 비활성화합니다.

IMPORTANT

이 단계는 업그레이드를 완료하는 데 필요합니다.

업데이트 절차가 실행된 후 클라우드 환경 변수CF_MIGRATION_ENABLED를 ‘0’으로 재설정하여 모든 포드의 재활용을 트리거합니다.

NOTE

이는 게시 계층에 중요한데, 콘텐츠 업데이트가 골든 게시에서만 수행되며, 포드를 재활용할 때 모든 일반 게시 포드가 골든 게시를 기반으로 하기 때문입니다.

업데이트 절차가 완료되었는지 확인합니다.

Cloud Manager 개발자 콘솔의 저장소 브라우저를 사용해 콘텐츠 조각 데이터를 확인하여 업데이트가 정상적으로 완료되었는지 확인할 수 있습니다.

• 첫 번째 전체 마이그레이션 전까지는 cfGlobalVersion 속성이 존재하지 않습니다.
  따라서 JCR 노드 /content/dam에 이 속성이 있고 값이 1이면 마이그레이션이 완료된 것입니다.

• 개별 콘텐츠 조각에서 다음 속성을 확인할 수도 있습니다.

  • _strucVersion의 값이 1이어야 함
  • indexedData 구조가 존재해야 함
  NOTE

  이 절차는 작성자 및 게시 인스턴스에서 콘텐츠 조각을 업데이트합니다.

  따라서 Adobe는 저장소 브라우저를 통해 최소 한 명의 작성자 및 하나의 게시 인스턴스에 대해 검증을 수행하는 것을 권장합니다.