Live Copy 동기화 구성 configuring-live-copy-synchronization

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

관리자

라이브 카피를 소스 콘텐츠와 동기화하는 방법과 시기를 제어하려면 다음 작업을 수행하십시오.

기존 롤아웃 구성이 요구 사항을 충족하는지 여부 또는 하나 이상을 만들어야 하는지 여부를 결정합니다.
라이브 카피에 사용할 롤아웃 구성을 지정합니다.

설치된 롤아웃 구성 및 사용자 정의 롤아웃 구성 installed-and-custom-rollout-configurations

이 섹션에서는 설치된 롤아웃 구성 및 롤아웃 구성에서 사용하는 동기화 작업과 필요한 경우 사용자 정의 구성을 생성하는 방법에 대한 정보를 제공합니다.

CAUTION

기본(설치된) 롤아웃 구성을 업데이트하거나 변경하는 것은 권장되지 않습니다. 사용자 정의 라이브 작업에 대한 요구 사항이 있는 경우 사용자 정의 롤아웃 구성에 추가해야 합니다.

롤아웃 트리거 rollout-triggers

각 롤아웃 구성은 롤아웃이 발생하도록 하는 롤아웃 트리거를 사용합니다. 롤아웃 구성은 다음 트리거 중 하나를 사용할 수 있습니다.

롤아웃 시: 롤아웃 명령이 블루프린트 페이지에 사용되거나 동기화 명령이 라이브 카피 페이지에 사용됩니다.
수정 시: 소스 페이지가 수정됩니다.
활성화 시: 소스 페이지가 활성화됩니다.
비활성화 시: 소스 페이지가 비활성화됩니다.

NOTE

수정 시 트리거를 사용하면 성능에 영향을 줄 수 있습니다. 자세한 내용은 MSM 모범 사례를 참조하십시오.

설치된 롤아웃 구성 installed-rollout-configurations

다음 표에는 AEM과 함께 설치된 롤아웃 구성이 나열되어 있습니다. 이 표에는 각 롤아웃 구성의 트리거 및 동기화 작업이 포함되어 있습니다. 설치된 롤아웃 구성 작업이 요구 사항에 맞지 않으면 롤아웃 구성을 만들 수 있습니다.

이름

설명

트리거

동기화 작업

설치된 동기화 작업 참조

표준 롤아웃 구성

롤아웃 트리거 시 롤아웃 프로세스를 시작하고 작업을 실행할 수 있는 표준 롤아웃 구성: 컨텐츠 생성, 업데이트, 삭제 및 하위 노드 순서 지정.

롤아웃 시

contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren

블루프린트 활성화에서 활성화

소스가 게시되면 라이브 카피를 게시합니다.

활성화 시

target활성화

블루프린트 비활성화에서 비활성화

소스가 비활성화되면 라이브 카피가 비활성화됩니다.

비활성화 시

targetDeactivate

수정되면 푸시

소스가 수정되면 콘텐츠를 라이브 카피로 푸시합니다.

이 롤아웃 구성은 수정 시 트리거를 사용하므로 제한적으로 사용하십시오.

수정 시

contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren

수정되면 푸시(약식)

블루프린트 페이지가 수정되면 참조(예: 약식 사본 참조)를 업데이트하지 않고 콘텐츠를 라이브 카피로 푸시합니다.

이 롤아웃 구성은 수정 시 트리거를 사용하므로 제한적으로 사용하십시오.

수정 시

contentUpdate
contentCopy
contentDelete
orderChild

출시 홍보

시작 페이지를 홍보하기 위한 표준 롤아웃 구성입니다.

롤아웃 시

contentUpdate
contentCopy
contentDelete
referenceUpdate
orderChildren
markLiveRelationship

카탈로그 페이지 컨텐츠 롤아웃 구성

카탈로그 블루프린트에서 페이지 템플릿을 적용합니다.

롤아웃 시

contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChild

카탈로그 페이지 업데이트 롤아웃 구성

카탈로그 블루프린트에서 타겟 속성을 적용합니다. 카탈로그 페이지 컨텐츠 롤아웃 구성 후에 실행해야 합니다.

롤아웃 시

catalogRolloutHooks

DPS 발행물 롤아웃 구성

초기 롤아웃 시 FolioProducer 바인딩 속성을 제외하면서 롤아웃 트리거 시 롤아웃 프로세스를 시작할 수 있는 DPS 게시 롤아웃 구성

롤아웃 시

contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter

레거시(5.6.0) 카탈로그 롤아웃 구성

사용하지 않음. 카탈로그 롤아웃에 MSM 대신 Catalog Generator를 사용하십시오.

롤아웃 시

editProperties

설치된 동기화 작업 installed-synchronization-actions

다음 표에는 AEM과 함께 설치되는 동기화 작업이 나열되어 있습니다. 설치된 작업이 요구 사항에 맞지 않으면 새 동기화 작업을 만들 수 있습니다.

작업 이름

설명

속성

contentCopy

라이브 카피에 소스 노드가 없는 경우 는 노드를 라이브 카피로 복사합니다. CQ MSM 콘텐츠 복사 작업 서비스를 구성하여 제외할 노드 형식, 단락 항목 및 페이지 속성을 지정합니다.

contentDelete

소스에 존재하지 않는 라이브 카피의 노드를 삭제합니다. CQ MSM 콘텐츠 삭제 작업 서비스를 구성하여 제외할 노드 형식, 단락 항목 및 페이지 속성을 지정합니다.

contentUpdate

소스의 변경 내용으로 라이브 카피 콘텐츠를 업데이트합니다. CQ MSM 콘텐츠 업데이트 작업 서비스를 구성하여 제외할 노드 형식, 단락 항목 및 페이지 속성을 지정합니다.

editProperties

라이브 카피의 속성을 편집합니다. editMap 속성은 편집할 속성과 해당 값을 결정합니다. editMap 속성 값은 다음 형식을 사용해야 합니다.

[property_name_1]#[current_value]#[new_value],
[property_name_2]#[current_value]#[new_value],
... ,
[property_name_n]#[current_value]#[new_value]

current_value 및 new_value 항목은 정규식입니다.

예를 들어 editMap에 대해 다음 값을 고려하십시오.

sling:resourceType#/(contentpage|homepage)#/
mobilecontentpage,
cq:template#/contentpage#/mobilecontentpage

이 값은 라이브 카피 노드의 속성을 다음과 같이 편집합니다.

contentpage 또는 homepage(으)로 설정된 sling:resourceType 속성이 mobilecontentpage.
contentpage(으)로 설정된 cq:template 속성이 mobilecontentpage.

editMap: (문자열) 속성, 현재 값 및 새 값을 식별합니다. 자세한 내용은 설명을 참조하십시오.

알림

페이지가 롤아웃되었다는 페이지 이벤트를 보냅니다. 알림을 받으려면 먼저 롤아웃 이벤트를 구독해야 합니다.

하위 주문

Live Copy에서는 블루프린트의 순서를 기반으로 하위(노드)를 정렬합니다.

referencesUpdate

라이브 카피에서 이 동기화 작업은 링크 등의 참조를 업데이트합니다.
Live Copy 페이지에서 블루프린트 내의 리소스를 가리키는 경로를 검색합니다. 경로를 찾으면 라이브 카피(블루프린트 대신) 내의 관련 리소스를 나타내는 경로를 업데이트합니다. 대상이 블루프린트 외부에 있는 참조는 변경되지 않습니다.

CQ MSM 참조 업데이트 작업 서비스를 구성하여 제외할 노드 형식, 단락 항목 및 페이지 속성을 지정합니다.

targetVersion

라이브 카피의 버전을 만듭니다.

이 작업은 롤아웃 구성에 포함된 유일한 동기화 작업이어야 합니다.

target활성화

라이브 카피를 활성화합니다.

이 작업은 롤아웃 구성에 포함된 유일한 동기화 작업이어야 합니다.

targetDeactivate

라이브 카피를 비활성화합니다.

이 작업은 롤아웃 구성에 포함된 유일한 동기화 작업이어야 합니다.

워크플로우

대상 속성으로 정의된 워크플로(페이지만 해당)를 시작하고 라이브 카피를 페이로드로 가져옵니다.

대상 경로는 모델 노드의 경로입니다.

target: (문자열) 워크플로 모델의 경로입니다.

필수

특정 사용자 그룹에 대해 라이브 카피 페이지에 있는 여러 ACL의 권한을 읽기 전용으로 설정합니다. 다음과 같은 ACL이 구성됩니다.

ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY

이 작업은 페이지에만 사용하십시오.

target: (문자열) 권한을 설정하는 그룹의 ID입니다.

mandatoryContent

특정 사용자 그룹에 대해 라이브 카피 페이지에 있는 여러 ACL의 권한을 읽기 전용으로 설정합니다. 다음과 같은 ACL이 구성됩니다.

ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY

이 작업은 페이지에만 사용하십시오.

target: (문자열) 권한을 설정하는 그룹의 ID입니다.

mandatoryStructure

특정 사용자 그룹에 대해 라이브 카피 페이지에 있는 ActionSet.ACTION_NAME_REMOVE ACL의 권한을 읽기 전용으로 설정합니다. 이 작업은 페이지에만 사용하십시오.

target: (문자열) 권한을 설정하는 그룹의 ID입니다.

VersionCopyAction

블루프린트/소스 페이지가 한 번 이상 게시된 경우 는 게시된 버전을 사용하여 라이브 카피 페이지를 만듭니다. 참고: 이 작업은 게시된 소스 페이지를 기반으로 하는 라이브 카피 페이지를 만드는 데만 사용할 수 있으며, 기존 라이브 카피 페이지를 업데이트하는 데는 사용할 수 없습니다.

PageMoveAction

PageMoveAction은 페이지가 블루프린트에서 이동된 경우 적용됩니다.

이 작업은 (관련) 라이브 카피 페이지를 한 위치에서 다른 위치로 이동하지 않고 복사합니다.

PageMoveAction은 이동 전 위치에서 라이브 카피 페이지를 변경하지 않습니다. 따라서 연속된 RolloutConfigurations의 경우 블루프린트가 없는 LiveRelationship 상태가 됩니다.

CQ MSM 페이지 이동 작업 서비스를 구성하여 제외할 노드 형식, 단락 항목 및 페이지 속성을 지정합니다.

이 작업은 롤아웃 구성에 포함된 유일한 동기화 작업이어야 합니다.

prop_referenceUpdate: (부울) 참조를 업데이트하려면 true로 설정합니다. 기본값은 true입니다.

productCreateUpdate

카탈로그 내에서 제품 리소스를 만들거나 업데이트합니다. 이 작업은 다음 상황 중 하나에 사용하기 위한 것입니다.

카탈로그(또는 카탈로그 섹션) 생성 또는 롤아웃
사용자가 제품 구성 요소에 대한 동기화 상속을 복원합니다.

markLiveRelationship

론치가 생성한 콘텐츠에 대해 라이브 관계가 존재함을 나타냅니다.

catalogRolloutHooks

카탈로그 생성별 롤아웃 후크를 실행합니다. CatalogGenerator의 executePageRolloutHooks 및 executeProductRolloutHooks 메서드를 호출합니다.
AEM JavaDoc에서 com.adobe.cq.commerce.pim.api.CatalogGenerator를 참조하십시오.

productUpdate

제품 카탈로그의 라이브 카피에서 제품 페이지를 업데이트합니다.

롤아웃 구성 만들기 creating-a-rollout-configuration

설치된 롤아웃 구성이 애플리케이션 요구 사항에 맞지 않으면 롤아웃 구성을 만들 수 있습니다.

새 롤아웃 구성을 만들었다면 블루프린트 또는 Live Copy 페이지에서 롤아웃 구성을 설정할 때 사용할 수 있습니다.

동기화에서 속성 및 노드 유형 제외 excluding-properties-and-node-types-from-synchronization

특정 노드 유형 및 속성에 영향을 주지 않도록 해당 동기화 작업을 지원하는 여러 OSGi 서비스를 구성할 수 있습니다. 예를 들어 AEM의 내부 기능과 관련된 많은 속성 및 하위 노드를 라이브 카피에 포함할 수 없습니다. 페이지 사용자와 관련된 콘텐츠만 복사해야 합니다.

AEM을 사용하여 작업할 때 이러한 서비스에 대한 구성 설정을 관리할 수 있는 방법에는 몇 가지가 있습니다. 자세한 내용 및 권장 사례를 보려면 OSGi 구성을 참조하십시오.

다음 표에는 제외할 노드를 지정할 수 있는 동기화 작업이 나열되어 있습니다. 이 표는 웹 콘솔을 사용하여 구성할 서비스의 이름 및 저장소 노드를 사용하여 구성할 PID를 제공합니다.

동기화 작업

웹 콘솔의 서비스 이름

서비스 PID

contentCopy

CQ MSM 콘텐츠 복사 작업

com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory

contentDelete

CQ MSM 콘텐츠 삭제 작업

com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory

contentUpdate

CQ MSM 콘텐츠 업데이트 작업

com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory

PageMoveAction

CQ MSM 페이지 이동 작업

com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory

referencesUpdate

CQ MSM 참조 업데이트 작업

com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

다음 표는 구성할 수 있는 속성을 설명합니다.

웹 콘솔 속성/OSGi 속성

설명

제외된 노드 유형

cq.wcm.msm.action.excludednodetypes

동기화 작업에서 제외할 노드 유형과 일치하는 정규 표현식.

제외된 단락 항목

cq.wcm.msm.action.excludedparagraphitems

동기화 작업에서 제외할 단락 항목과 일치하는 정규 표현식.

제외된 페이지 속성

cq.wcm.msm.action.excludedprops

동기화 작업에서 제외할 페이지 속성과 일치하는 정규 표현식.

무시된 믹스인 노드 유형

cq.wcm.msm.action.ignoredMixin

CQ MSM 콘텐츠 업데이트 작업에만 사용할 수 있습니다. 동기화 작업에서 제외할 믹스인 노드 유형의 이름과 일치하는 정규 표현식.

NOTE

클래식 UI에서 라이브 카피 페이지의 페이지 속성 대화 상자에 표시되는 잠금 아이콘은 제외된 페이지 속성 속성의 구성을 반영하지 않습니다. 동기화 작업에서 제외된 속성에 대해서도 잠금 아이콘이 표시됩니다.

NOTE

터치에 적합한 UI에서 페이지 속성에 MSM 잠금 구성(터치에 적합한 UI)도 참조하십시오.

CQ MSM 콘텐츠 업데이트 작업 - 제외 cq-msm-content-update-action-exclusions

일부 속성 및 노드 유형은 기본적으로 제외되며, 이들은 제외된 페이지 속성 아래에 있는 CQ MSM 콘텐츠 업데이트 작업 의 OSGi 구성에 정의되어 있습니다.

기본적으로 다음 정규 표현식과 일치하는 속성은 롤아웃 시 제외됩니다(즉, 업데이트되지 않음).

CQ MSM 콘텐츠 업데이트 작업

필요에 따라 제외 목록을 정의하는 표현식을 변경할 수 있습니다.

예를 들어 페이지 제목 을 롤아웃 변경 내용에 포함하려면 제외에서 jcr:title을 제거합니다. 예를 들어 정규 표현식은 다음과 같습니다.

jcr:(?!(title)$).*

참조를 업데이트하도록 동기화 구성 configuring-synchronization-for-updating-references

참조 업데이트와 관련된 해당 동기화 작업을 지원하는 여러 OSGi 서비스를 구성할 수 있습니다.

다음 표에는 참조 업데이트를 지정할 수 있는 동기화 작업이 나열되어 있습니다. 이 표는 웹 콘솔을 사용하여 구성할 서비스의 이름 및 저장소 노드를 사용하여 구성할 PID를 제공합니다.

웹 콘솔 속성/OSGi 속성

설명

중첩된 Live Copy 간 참조 업데이트

cq.wcm.msm.impl.action.referencesupdate.prop_updateNested

CQ MSM 참조 업데이트 작업에만 사용할 수 있습니다. 최상위 LiveCopy 분기 내에 있는 리소스를 타겟팅하는 참조를 바꾸려면 이 옵션(웹 콘솔)을 선택하거나 이 부울 속성을 true(저장소 구성)로 설정하십시오.

참조 페이지 업데이트

cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate

CQ MSM 페이지 이동 작업에만 사용할 수 있습니다. 원본 페이지를 사용하여 LiveCopy 페이지를 대신 참조하도록 참조를 업데이트하려면 이 옵션(웹 콘솔)을 선택하거나 이 부울 속성을 true(저장소 구성)로 설정하십시오.

사용할 롤아웃 구성 지정 specifying-the-rollout-configurations-to-use

MSM을 사용하면 일반적으로 사용되는 롤아웃 구성 세트를 지정하고 필요한 경우 이를 특정 라이브 카피에 대해 재정의할 수 있습니다. MSM은 사용할 롤아웃 구성을 지정할 여러 위치를 제공합니다. 이 위치는 구성이 특정 라이브 카피에 적용되는지 여부를 결정합니다.

사용할 롤아웃 구성을 지정할 수 있는 다음 위치 목록은 MSM이 라이브 카피에 사용할 롤아웃 구성을 결정하는 방법을 설명합니다.

라이브 카피 페이지 속성: 라이브 카피 페이지가 하나 이상의 롤아웃 구성을 사용하도록 구성된 경우 MSM은 해당 롤아웃 구성을 사용합니다.
블루프린트 페이지 속성: 라이브 카피가 블루프린트를 기반으로 하며 라이브 카피 페이지가 롤아웃 구성을 사용하여 구성되지 않은 경우, 블루프린트 소스 페이지와 연결된 롤아웃 구성이 사용됩니다.
라이브 카피 상위 페이지 속성: 라이브 카피 페이지와 블루프린트 소스 페이지가 롤아웃 구성을 사용하여 구성되지 않은 경우, 라이브 카피 페이지의 상위 페이지에 적용되는 롤아웃 구성이 사용됩니다.
시스템 기본값: Live Copy의 상위 페이지에 대한 롤아웃 구성을 결정할 수 없는 경우 시스템 기본 롤아웃 구성이 사용됩니다.

예를 들어 블루프린트는 We.Retail 참조 사이트 를 소스 콘텐츠로 사용합니다. 블루프린트에서 사이트가 생성됩니다. 다음 목록의 각 항목은 롤아웃 구성 사용과 관련된 여러 시나리오를 설명합니다.

롤아웃 구성을 사용하도록 구성된 블루프린트 페이지 또는 라이브 카피 페이지가 없습니다. MSM은 모든 라이브 카피 페이지에 시스템 기본 롤아웃 구성을 사용합니다.
We.Retail 참조 사이트의 루트 페이지는 여러 롤아웃 구성을 사용하여 구성됩니다. MSM은 모든 라이브 카피 페이지에 이러한 롤아웃 구성을 사용합니다.
We.Retail 참조 사이트의 루트 페이지는 여러 롤아웃 구성을 사용하여 구성되고 라이브 카피 사이트의 루트 페이지는 다른 롤아웃 구성 세트를 사용하여 구성됩니다. MSM은 라이브 카피 사이트의 루트 페이지에 구성된 롤아웃 구성을 사용합니다.

Live Copy 페이지에 대한 롤아웃 구성 설정 setting-the-rollout-configurations-for-a-live-copy-page

소스 페이지가 롤아웃될 때 사용할 롤아웃 구성을 사용하여 라이브 카피 페이지를 구성합니다. 기본적으로 하위 페이지는 구성을 상속합니다. 사용할 롤아웃 구성을 구성할 때는 라이브 카피 페이지가 해당 상위 항목에서 상속하는 구성을 오버라이드하게 됩니다.

라이브 카피를 만들기할 때 라이브 카피 페이지에 대한 롤아웃 구성을 구성할 수도 있습니다.

사이트 콘솔을 사용하여 Live Copy 페이지를 선택하십시오.
도구 모음에서 속성 을 선택합니다.
Live Copy 탭을 엽니다.

구성 섹션에 페이지가 상속하는 롤아웃 구성이 표시됩니다.
필요한 경우 Live Copy 상속 플래그를 조정하십시오. 선택하면 라이브 카피 구성이 모든 하위 항목에 적용됩니다.
상위 항목에서 롤아웃 구성 상속 속성을 지우고 목록에서 롤아웃 구성을 한 개 이상 선택합니다.

선택한 롤아웃 구성이 드롭다운 목록 아래에 표시됩니다.
저장 을 클릭합니다.