설명서Experience Cloud KCS

AEM 환경 콘텐츠를 콘텐츠 복사 도구와 동기화

마지막 업데이트: 2026년 6월 24일

콘텐츠 복사 도구를 종속된 구성 경로 없이 또는 지원되지 않는 흐름 방향에 대해 사용할 경우 AEMaaCS 환경 간에 콘텐츠를 동기화하면 실패하거나 잘못된 결과가 발생합니다. AEMaaCS는 변경 불가능한 코드와 변경 가능한 콘텐츠를 분리하므로 저장소 수준에서 환경을 복제할 수 없습니다. 지원되는 메커니즘은 일치하는 JCR 경로를 덮어쓰고 다른 위치에서 병합하는 경로 기반 복사입니다. /conf 메타데이터 프로필과 같은 종속 경로가 누락되면 동기화 후 잘못된 메타데이터가 발생하고, 낮은 환경에서 더 높은 환경으로 복사하려면 정방향 흐름을 사용해야 합니다. 종속 경로를 포함하여 흐름 방향 및 권한을 확인하고 대상 환경을 검증하면 안정적이고 반복 가능한 동기화가 생성됩니다.

설명 description

문제: 컨텐츠 복사가 잘못된 메타데이터를 생성하거나 AEM 환경 간에 실패합니다

설명

고객은 테스트 또는 유효성 검사를 위해 프로덕션 환경에서 단계, 개발 또는 RDE 환경으로 콘텐츠를 정기적으로 동기화합니다. 수동 패키지 기반 전송은 느리고 오류가 많으며 큰 DAM 저장소에 적합하지 않습니다. AEMaaCS는 허용되는 변경 가능한 JCR 경로를 상위 환경에서 하위 환경으로 복사할 수 있는 콘텐츠 복사 도구를 제공하지만, 누락된 /conf 종속성, 자동화 제한(콘텐츠 복사는 기본적으로 온디맨드 상태임), 흐름 제한(전달 흐름이 활성화되지 않은 경우 프로덕션은 하위로만 제공), 지원되지 않는 증분 또는 델타 복사에 대한 혼동 등에서 메타데이터 프로필 불일치가 발생할 수 있습니다.

환경:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Assets 기본 사항
  • AEM Managed Services
  • Cloud Manager(콘텐츠 세트 및 콘텐츠 복사)

문제/증상:

  • 단계에 복사된 컨텐츠에 잘못된 메타데이터 스키마 또는 기본값이 표시됩니다.
  • 권한 누락(배포 관리자와 AEM 관리자) 또는 사용할 수 없는 환경 흐름 방향으로 인해 콘텐츠 복사 작업을 시작할 수 없습니다.
  • 전달 흐름을 명시적으로 사용하지 않는 한 개발에서 스테이지로 또는 개발에서 프로덕션으로 복사하는 것과 같이 낮은 환경에서 더 높은 환경으로 복사할 수 없습니다.
  • 콘텐츠 사본에 내장된 스케줄러가 없기 때문에 자동화 시도가 실패합니다.
  • DAM 크기가 AEM 패키지 제한을 초과하여 패키지 기반 동기화가 너무 오래 걸리거나 실패합니다.

근본 원인:

AEMaaCS는 변경 불가능한 코드와 변경 가능한 콘텐츠의 분리를 사용하므로 저장소 수준에서 환경 콘텐츠를 직접 복제할 수 없습니다. 지원되는 메커니즘은 콘텐츠 복사 도구를 사용한 경로 기반 복사입니다. 이 복사본은 일치하는 JCR 경로에 대한 대상 콘텐츠를 덮어쓰고, 경로가 다른 경우 병합하며, 비프로덕션 흐름에 대해 정방향 흐름이 활성화되지 않은 경우 더 높은 환경에서 더 낮은 환경으로만 작동합니다. /conf 메타데이터 프로필과 같은 종속 경로가 누락되면 동기화 후 예기치 않은 동작이 발생합니다. 컨텐츠 복사는 노드 유형 필터링 또는 증분 변경을 지원하지 않습니다. 각 실행은 정의된 컨텐츠 세트에 대한 전체 새로 고침입니다.

확인하는 방법

  1. 환경 흐름 방향과 사용 권한을 확인합니다. Cloud Manager에서 Program → Environments(으)로 이동하여 소스와 대상을 모두 선택하고 소스가 더 높은 수준의 환경(프로덕션 → 단계 → 개발 → RDE)인지 확인합니다. Cloud Manager → 콘텐츠 세트를 열고 액세스 거부 오류 없이 로드되는지 확인하여 사용자가 배포 관리자 및 AEM 관리자 역할을 보유하고 있는지 확인하십시오.

  2. 동기화해야 하는 JCR 경로(페이지, DAM 에셋, 태그, 경험 조각 및 메타데이터 프로필)를 식별하고 해당 /conf 경로를 포함하여 메타데이터 또는 구성 불일치를 방지합니다. 허용되는 경로는 다음과 같습니다.

    • /content/<b>
    • /conf/</b>
    • /etc/<b>
    • /var/workflow/models/</b>
    • /var/commerce/<b>

해결 방법 resolution

  1. Cloud Manager에서 컨텐츠 세트를 만듭니다. Program → Environments → Content Sets → Add Content Set(으)로 이동하여 필요한 모든 포함 경로를 추가하고 필요한 경우 제외를 추가합니다. 콘텐츠 세트 세부 사항을 열고 모든 경로가 요구 사항과 일치하는지 확인합니다. UI가 경로를 차단하는 경우 위에 허용된 경로 중 하나인지 확인합니다.
  2. 콘텐츠 복사 프로세스를 시작합니다. Cloud Manager → 콘텐츠 복사에서 콘텐츠 세트와 소스 및 대상 환경을 선택한 다음 복사를 시작합니다. Cloud Manager은 소스 환경 볼륨의 스냅샷을 사용하여 컨텐츠를 전송합니다. 동기화 중에 타겟 환경이 다운타임에 들어가는 동안 프로덕션의 가용성은 완전히 유지됩니다. 상태가 실행 중​에서 완료됨(으)로 이동할 때까지 진행 상태를 모니터링합니다.
  3. . 자동화를 위해 Cloud Manager Content Copy API를 사용합니다. 외부 스케줄러에서 Adobe I/O을 통해 콘텐츠 세트 API 및 콘텐츠 흐름 API를 호출하여 일별, 주별 또는 월별 흐름을 실행합니다. Cloud Manager UI에서 스케줄러와 일치하는 타임스탬프와 함께 흐름이 표시되는지 확인합니다. 증분 동기화는 지원되지 않으므로 전체 콘텐츠 복사만 가능합니다. 타겟 환경의 유효성을 검사합니다. 대상 AEM 작성자에 로그인하고 샘플 콘텐츠 경로 및 에셋으로 이동한 다음, 페이지, DAM 에셋, 메타데이터 프로필 및 경험 조각이 소스를 반영하는지 확인합니다. DAM 메타데이터의 경우 에셋을 선택하고 메타데이터→ 속성을 연 다음 사용자 지정 스키마가 적용되었는지 확인하십시오. 메타데이터가 잘못된 경우 상위 /conf 경로를 포함한 콘텐츠 복사본을 다시 실행하십시오. . 스테이지 작성자를 스테이지 게시로 동기화합니다. 프로덕션 대 스테이징 작성자 복사가 완료되면 표준 AEM 작성자 대 게시 복제를 사용하여 콘텐츠를 스테이지 게시로 복제합니다. 게시자 로그를 확인하고 게시된 URL을 열어 게시 단계에 콘텐츠가 표시되는지 확인합니다. 콘텐츠가 표시되지 않으면 스테이지 작성자에서 복제 에이전트의 유효성을 검사하십시오.

유효성 검사

*1. 대상 AEM 작성자 환경에 로그인하고 /content/에 필요한 모든 콘텐츠가 있는지 확인하십시오. 2. 여러 DAM 자산을 열고 메타데이터 스키마가 올바르고 프로덕션과 일치하는지 확인합니다. 3. 자동화를 사용하는 경우 Cloud Manager 콘텐츠 흐름 작업이 예상 간격으로 표시되는지 확인하십시오.### 관련 읽기 콘텐츠 복사 도구

recommendation-more-help
experience-cloud-kcs-help-kbarticles