설명서AEM as a Cloud Service사용 안내서

클라우드 서비스에 콘텐츠 수집 ingesting-content

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Cloud Acceleration Manager의 수집 프로세스 ingestion-process

Cloud Acceleration Manager를 사용하여 마이그레이션 세트를 수집하려면 아래 단계를 따르십시오.

  1. Cloud Acceleration Manager 로 이동합니다. 프로젝트 카드를 클릭하고 컨텐츠 전송 카드를 클릭합니다. 다음으로 이동 수집 작업 및 클릭 새 수집

    이미지

  2. 수집 체크리스트를 검토하고 모든 단계가 완료되었는지 확인합니다. 이러한 단계는 성공적인 수집을 보장하기 위해 필요합니다. 다음으로 진행 다음 체크리스트가 완료된 경우에만 단계를 수행합니다.

    이미지

  3. 수집을 만드는 데 필요한 정보를 제공합니다.

    • 마이그레이션 세트: 추출된 데이터가 포함된 마이그레이션 세트를 소스로 선택합니다.
      • 마이그레이션 세트는 장기간 사용하지 않으면 만료되므로 추출이 수행된 후 비교적 곧 수집이 발생할 것으로 예상됩니다. 리뷰 마이그레이션 세트 만료 을 참조하십시오.
    note tip
    TIP
    추출이 실행 중인 경우 대화 상자에 추출이 표시됩니다. 추출이 완료되면 자동으로 수집이 시작됩니다. 추출이 실패하거나 중지되면 수집 작업이 취소됩니다.

    • 대상: 대상 환경을 선택합니다. 이 환경에서는 마이그레이션 세트의 콘텐츠가 수집됩니다.

      • 수집은 RDE(신속한 개발 환경) 또는 미리보기 유형의 대상을 지원하지 않으며, 사용자가 액세스할 수 있는 경우에도 가능한 대상 선택으로 표시되지 않습니다.
      • 마이그레이션 세트를 여러 대상에 동시에 수집할 수 있지만 대상은 한 번에 실행 중이거나 대기 중인 수집 하나만 대상으로 할 수 있습니다.

    • 계층: 계층을 선택합니다. (작성자/게시).

      • 소스가 Author로 수집하는 것이 좋습니다. Author 대상의 계층입니다. 마찬가지로 소스가 Publish, 대상은 다음과 같아야 합니다. Publish 또한.
    note note
    NOTE
    대상 계층이 Author, 작성자 인스턴스는 수집 기간 동안 종료되며 사용자(예: 작성자 또는 유지 관리를 수행하는 모든 사용자)는 사용할 수 없게 됩니다. 그 이유는 시스템을 보호하기 위해서이며, 손실되거나 수집 충돌을 야기할 수 있는 모든 변경 사항을 방지합니다. 팀이 이 사실을 알고 있는지 확인합니다. 또한 환경은 작성자 수집 중에 최대 절전 모드로 표시됩니다.

    • 지우기: 다음을 선택합니다. Wipe 값

      • 다음 지우기 옵션은 수집의 시작 지점을 설정합니다. If 지우기 가 활성화되면 모든 콘텐츠를 포함하는 대상이 Cloud Manager에 지정된 AEM 버전으로 재설정됩니다. 활성화되지 않은 경우 대상은 현재 콘텐츠를 시작점으로 유지합니다.
      • 이 옵션은 다음을 수행합니다 아님 콘텐츠 수집이 수행되는 방식에 영향을 줍니다. 수집은 항상 컨텐츠 대체 전략을 사용하며 아님 컨텐츠 병합 전략 지우기 및 지우지 않음 마이그레이션 세트를 수집하면 대상의 동일한 경로에 있는 콘텐츠를 덮어씁니다. 예를 들어 마이그레이션 세트에 /content/page1 대상에 이미 다음 항목이 포함되어 있음 /content/page1/product1, 수집하면 전체 제거 page1 경로 및 해당 하위 페이지: product1을 클릭하고 마이그레이션 세트의 콘텐츠로 대체합니다. 이는 다음을 수행할 때 신중하게 계획해야 함을 의미합니다. 지우지 않음 유지 관리해야 하는 콘텐츠가 포함된 대상으로의 수집
    note important
    IMPORTANT
    다음과 같은 경우 지우기 수집이 활성화되고 대상 Cloud Service 인스턴스에 대한 사용자 권한을 포함하여 기존 저장소 전체가 재설정됩니다. 이 재설정은 에 추가된 관리자 사용자에게도 적용됩니다. 관리자 수집을 시작하려면 그룹 및 해당 사용자를 관리자 그룹에 다시 추가해야 합니다.

    • 사전 복사: 다음을 선택합니다. Pre-copy 값

      • 선택적 사전 복사 단계를 실행하여 수집 속도를 크게 높일 수 있습니다. 다음을 참조하십시오 AzCopy로 수집 을 참조하십시오.
      • 사전 복사를 사용하여 수집하는 경우(S3 또는 Azure Data Store의 경우) 실행하는 것이 좋습니다 Author 먼저 수집하십시오. 이렇게 하면 속도가 빨라집니다. Publish 나중에 실행될 때 수집.
    note important
    IMPORTANT
    로컬 환경에 속해 있는 경우에만 대상 환경에 대한 수집을 시작할 수 있습니다 AEM 관리자 대상 Cloud Service 작성자 서비스의 그룹입니다. 수집을 시작할 수 없는 경우 다음을 참조하십시오. 수집을 시작할 수 없음 을 참조하십시오.

  4. 수집 선택 사항을 선택하면 예상 기간이 표시됩니다. 이는 유사한 수집의 내역 데이터를 기반으로 한 최적 예상 작업입니다.

    • 이 추정치는 추출의 'Check Size' 값이 수집되고 사용 가능한 경우에만 계산되어 표시됩니다.
    • 이 값은 예상치이며, 지능적으로 계산되지만 정확하게 간주해서는 안 됩니다. 다양한 요인들이 실제 기간을 변화시킬 수 있다.
    • 수집이 실행되는 동안 이 값은 ""를 통해 액세스하는 기간 대화 상자에서도 사용할 수 있습니다.기간 보기"수집 작업.

이미지

  1. 클릭 수집.

    이미지

  2. 그런 다음 수집 작업 목록 보기에서 수집을 모니터링하고 수집의 작업 메뉴를 사용하여 지속 시간을 보고 수집 진행 상황을 기록할 수 있습니다.

    이미지

  3. 다음을 클릭합니다. (i) 수집 작업에 대한 자세한 내용을 보려면 행의 단추를 클릭하십시오. 실행 중이거나 완료된 수집 단계의 각 기간은 다음을 클릭하여 확인할 수 있습니다. … ​을 클릭한 다음 기간 보기. 추출에서 얻은 정보도 수집되는 내용을 인식하는 것으로 표시됩니다.

    이미지

추가 수집 top-up-ingestion-process

컨텐츠 전송 도구에는 다음을 수행하여 차등 컨텐츠를 추출할 수 있는 기능이 있습니다. 추가 마이그레이션 세트. 이렇게 하면 모든 콘텐츠를 다시 추출할 필요 없이 이전 추출 후 변경된 콘텐츠만 포함하도록 마이그레이션 세트를 수정할 수 있습니다.

NOTE
초기 컨텐츠 전송 후 Cloud Service으로 시작하기 전에 최종 차등 컨텐츠 전송에 대한 컨텐츠 고정 기간을 단축하기 위해 자주 차등 컨텐츠 추가를 수행하는 것이 좋습니다. 첫 번째 수집에 사전 복사 단계를 사용한 경우 후속 추가 수집에 대해 사전 복사를 건너뛸 수 있습니다(추가 마이그레이션 세트 크기가 200GB 미만인 경우). 그 이유는 전체 과정에 시간이 추가될 수 있기 때문이다.

일부 수집이 완료된 후 차등 콘텐츠를 수집하려면 다음을 실행해야 합니다. 추가 추출를 클릭한 다음 를 사용하여 수집 방법 사용 지우기 옵션 비활성화됨. 다음을 읽으십시오. 지우기 대상에 이미 있는 콘텐츠를 잃지 않도록 위의 설명을 참조하십시오.

수집 작업 생성으로 시작하여 다음을 확인합니다. 지우기 는 아래와 같이 수집 중에 비활성화됩니다.

이미지

문제 해결 troubleshooting

CAM에서 마이그레이션 토큰을 검색할 수 없음 cam-unable-to-retrieve-the-migration-token

다음을 포함한 다양한 이유로 마이그레이션 토큰의 자동 검색이 실패할 수 있습니다. Cloud Manager를 통해 IP 허용 목록 설정 대상 Cloud Service 환경에서. 이러한 시나리오에서는 수집을 시작할 때 다음과 같은 대화 상자가 표시됩니다.

이미지

대화 상자에서 "토큰 가져오기" 링크를 클릭하여 마이그레이션 토큰을 수동으로 검색합니다. 토큰을 표시하는 다른 탭이 열립니다. 그런 다음 토큰을 복사하여 마이그레이션 토큰 입력 필드. 이제 수집을 시작할 수 있습니다.

NOTE
토큰은 로컬에 속하는 사용자가 사용할 수 있습니다. AEM 관리자 대상 Cloud Service 작성자 서비스의 그룹입니다.

수집을 시작할 수 없음 unable-to-start-ingestion

로컬 환경에 속해 있는 경우에만 대상 환경에 대한 수집을 시작할 수 있습니다 AEM 관리자 대상 Cloud Service 작성자 서비스의 그룹입니다. AEM 관리자 그룹에 속하지 않는 경우 수집을 시작하려고 하면 아래와 같은 오류가 표시됩니다. 관리자에게 사용자를 로컬 그룹에 추가하도록 요청할 수 있습니다. AEM 관리자 또는 토큰 자체를 요청하십시오. 그러면 토큰에 붙여 넣을 수 있습니다 마이그레이션 토큰 입력 필드.

이미지

마이그레이션 서비스에 연결할 수 없음 unable-to-reach-migration-service

수집이 요청되면 다음과 같은 메시지가 사용자에게 표시될 수 있습니다. "대상 환경의 마이그레이션 서비스에 연결할 수 없습니다. 이 경우 나중에 다시 시도하거나 Adobe 지원 센터에 문의하십시오."

이미지

이 메시지는 Cloud Acceleration Manager가 수집을 시작하기 위해 대상 환경의 마이그레이션 서비스에 연결할 수 없음을 나타냅니다. 이러한 상황은 다양한 이유로 발생할 수 있습니다.

NOTE
몇 가지 경우에 해당 토큰을 검색하는 것이 실제로 허용되지 않으므로 "마이그레이션 토큰" 필드가 표시됩니다. 수동으로 제공될 수 있게 함으로써, 이는 사용자가 어떠한 추가적인 도움 없이도 수집을 신속하게 시작할 수 있게 할 수 있다. 토큰을 제공하고 메시지가 여전히 나타나면, 토큰을 검색하는 것은 문제가 되지 않습니다.
  • AEM은 환경 상태를 as a Cloud Service으로 유지하며 경우에 따라 다양한 일반적인 이유로 마이그레이션 서비스를 다시 시작해야 합니다. 서비스를 다시 시작하는 경우에는 해당 서비스에 연결할 수 없지만 결국 사용할 수 있습니다.
  • 인스턴스에서 다른 프로세스가 실행되고 있을 수 있습니다. 예를 들어 다음과 같습니다. AEM 버전 업데이트 업데이트를 적용하는 중입니다. 시스템이 사용 중이고 마이그레이션 서비스를 정기적으로 사용할 수 없습니다. 해당 프로세스가 완료되면 수집 시작을 다시 시도할 수 있습니다.
  • 다음과 같은 경우 IP 허용 목록이 적용되었습니다. cloud Manager를 통해 Cloud Acceleration Manager가 마이그레이션 서비스에 도달하는 것을 차단합니다. 주소가 동적이므로 수집에 IP 주소를 추가할 수 없습니다. 현재, 유일한 해결책은 수집 및 인덱싱 프로세스 동안 IP 허용 목록을 비활성화하는 것이다.
  • 조사가 필요한 다른 이유가 있을 수 있다. 수집 또는 색인화에 계속 오류가 발생하면 Adobe 고객 지원 센터에 문의하십시오.

AEM 버전 업데이트 및 수집 aem-version-updates-and-ingestions

AEM 버전 업데이트 최신 AEM as a Cloud Service 버전을 최신 상태로 유지하기 위해 환경에 자동으로 적용됩니다. 수집이 수행될 때 업데이트가 트리거되면 환경 손상 등 예측할 수 없는 결과가 발생할 수 있습니다.

대상 프로그램에 "AEM 버전 업데이트"가 온보딩되면 수집 프로세스는 시작하기 전에 해당 대기열을 비활성화하려고 시도합니다. 수집이 완료되면 버전 업데이트 프로그램 상태가 수집이 시작되기 전의 상태로 반환됩니다.

NOTE
"AEM 버전 업데이트"를 비활성화하기 위해 더 이상 지원 티켓을 기록할 필요가 없습니다.

"AEM 버전 업데이트"가 활성 상태인 경우(즉, 업데이트가 실행 중이거나 실행 대기 중인 경우) 수집이 시작되지 않고 사용자 인터페이스에 다음 메시지가 표시됩니다. 업데이트가 완료되면 수집을 시작할 수 있습니다. Cloud Manager를 사용하여 프로그램 파이프라인의 현재 상태를 볼 수 있습니다.

NOTE
"AEM 버전 업데이트"는 환경의 파이프라인에서 실행되며 파이프라인이 지워질 때까지 기다립니다. 업데이트가 예상보다 오래 큐에 있는 경우 사용자 지정 워크플로우에 의도하지 않게 파이프라인이 잠겨 있지 않은지 확인하십시오.

이미지

고유성 제한 사항 위반으로 인한 추가 수집 실패 top-up-ingestion-failure-due-to-uniqueness-constraint-violation

의 일반적인 원인 추가 수집 실패는 노드 id의 충돌입니다. 이 오류를 식별하려면 Cloud Acceleration Manager UI를 사용하여 수집 로그를 다운로드하고 다음과 같은 항목을 찾습니다.

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: 고유성 제약 조건이 속성을 위반했습니다 [jcr:uuid] 값 a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content

AEM의 각 노드에는 고유한 UUID가 있어야 합니다. 이 오류는 수집되는 노드의 UUID가 대상 인스턴스의 다른 경로에 있는 노드의 UUID와 동일함을 나타냅니다. 이러한 상황은 다음 두 가지 이유로 발생할 수 있습니다.

  • 노드는 소스에서 추출과 후속 추출 사이에서 이동됩니다 추가 추출
    • 기억: 추가 추출의 경우, 노드가 소스에 더 이상 존재하지 않더라도 마이그레이션 세트에 계속 존재합니다.
  • 대상의 노드가 수집과 후속 추가 수집 사이에서 이동됩니다.

이 충돌은 수동으로 해결해야 합니다. 콘텐츠에 익숙한 사용자는 두 노드 중 삭제할 노드를 참조하는 다른 콘텐츠를 염두에 두고 결정해야 합니다. 해결책은 불쾌한 노드 없이 다시 추가 추출이 수행될 것을 요구할 수 있다.

참조 노드 삭제 불가로 인한 추가 수집 실패 top-up-ingestion-failure-due-to-unable-to-delete-referenced-node

다음의 또 다른 일반적인 원인 추가 수집 실패는 대상 인스턴스의 특정 노드에 대한 버전 충돌입니다. 이 오류를 식별하려면 Cloud Acceleration Manager UI를 사용하여 수집 로그를 다운로드하고 다음과 같은 항목을 찾습니다.

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity0001: 참조된 노드를 삭제할 수 없음: 8a2289f4-b904-4bd0-8410-15e41e0976a8

대상의 노드가 수집과 후속 수집 사이에서 수정된 경우 이 문제가 발생할 수 있습니다 지우지 않음 수집 - 새 버전이 만들어집니다. 마이그레이션 세트가 "버전 포함"을 활성화한 상태로 추출된 경우 대상에 버전 내역 및 기타 콘텐츠에서 참조되는 최신 버전이 있으므로 충돌이 발생할 수 있습니다. 수정 버전 노드가 참조되기 때문에 수집 프로세스에서 수정 버전 노드를 삭제할 수 없습니다.

해결책은 불쾌한 노드 없이 다시 추가 추출이 수행될 것을 요구할 수 있다. 또는 문제가 되는 노드의 소규모 마이그레이션 세트를 만들지만 "버전 포함"은 비활성화되어 있습니다.

모범 사례에 따르면 지우지 않음 수집은 버전이 포함된 마이그레이션 세트를 사용하여 실행해야 합니다. 마이그레이션 여정이 완료될 때까지 대상의 콘텐츠를 가능한 한 적게 수정하는 것이 중요합니다. 그렇지 않으면 이러한 충돌이 발생할 수 있습니다.

대형 노드 속성 값으로 인한 수집 실패 ingestion-failure-due-to-large-node-property-values

MongoDB에 저장된 노드 속성 값은 16MB를 초과할 수 없습니다. 노드 값이 지원되는 크기를 초과하면 수집이 실패하고 로그에 BSONObjectTooLarge 오류 및 최대값을 초과하는 노드를 지정합니다. MongoDB 제한 사항입니다.

다음을 참조하십시오. Node property value in MongoDB 의 메모 컨텐츠 전송 도구 사전 요구 사항 자세한 내용 및 모든 큰 노드를 찾는 데 도움이 될 수 있는 Oak 도구에 대한 링크입니다. 크기가 큰 모든 노드가 복구되면 추출 및 수집을 다시 실행합니다.

수집 취소됨 ingestion-rescinded

실행 중인 추출을 소스 마이그레이션 세트로 사용하여 생성된 수집은 해당 추출이 성공할 때까지 잠시 기다렸다가 이 시점에서 정상적으로 시작됩니다. 추출이 실패하거나 중지되면 수집 및 색인 지정 작업이 시작되지 않고 취소됩니다. 이 경우 추출을 확인하여 실패한 이유를 확인하고 문제를 해결한 다음 추출을 다시 시작합니다. 고정 추출이 실행되면 새 수집을 예약할 수 있습니다.

수집을 다시 실행한 후 삭제된 자산이 없음

일반적으로 수집 사이에 있는 클라우드 환경 데이터는 수정하지 않는 것이 좋습니다.

Assets Touch UI를 사용하여 Cloud Service 대상에서 에셋을 삭제하면 노드 데이터는 삭제되지만 이미지가 있는 에셋 blob는 즉시 삭제되지 않습니다. 이 ID는 삭제하도록 표시되어 더 이상 UI에 표시되지 않지만 가비지 수집이 발생하고 BLOB가 제거될 때까지 데이터 저장소에 남아 있습니다.

이전에 마이그레이션된 자산이 삭제되고 가비지 수집기가 자산 삭제를 완료하기 전에 다음 수집이 실행되는 시나리오에서는 동일한 마이그레이션 세트를 수집해도 삭제된 자산은 복원되지 않습니다. 수집이 클라우드 환경에서 에셋을 확인하면 노드 데이터가 없습니다. 따라서 수집은 노드 데이터를 클라우드 환경에 복사합니다. 하지만 Blob 저장소를 확인하면 Blob가 있는 것을 확인하고 Blob 복사를 건너뜁니다. 이것이 Touch UI에서 에셋을 볼 때 메타데이터가 수집 후 표시되지만 이미지는 표시되지 않는 이유입니다. 마이그레이션 세트 및 콘텐츠 수집은 이 사례를 처리하도록 설계되지 않았습니다. 클라우드 환경에 새 콘텐츠를 추가하고 이전에 마이그레이션된 콘텐츠를 복원하지 않는 것을 목표로 합니다.

다음 단계 whats-next

수집이 성공하면 AEM 색인화가 자동으로 시작됩니다. 다음을 참조하십시오 콘텐츠 마이그레이션 후 색인화 추가 정보.

Cloud Service에 컨텐츠 수집을 완료하면 각 단계(추출 및 수집)의 로그를 보고 오류를 검색할 수 있습니다. 다음을 참조하십시오 마이그레이션 세트에 대한 로그 보기 자세히 알아보십시오.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab