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

구현 단계 implementation-phase

Last update: Wed Oct 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 관리자

여정의 구현 단계에서는 AEM as a Cloud Service으로 이동할 준비가 된 코드 및 콘텐츠를 만들 수 있는 도구를 살펴봅니다.

지금까지의 스토리 story-so-far

여정의 이전 부분에서는 AEM as a Cloud Service의 변경 내용에 익숙해지고 준비 단계를 통해 배포를 클라우드로 이동할 준비가 되었는지 확인했습니다.

이 문서는 코드 및 콘텐츠를 클라우드로 이동할 준비가 되었는지 확인하기 위해 Adobe 제공 도구를 사용하는 방법에 대한 조언을 계속 제공합니다.

목표 objective

이 문서의 목적은 다음과 같습니다.

  • Cloud Manager에 코드를 배포하는 데 사용되는 AEM의 지속적인 통합 및 게재 프레임워크인 AEM as a Cloud Service을 소개합니다
  • 콘텐츠 전송 도구를 통해 최신 정보 제공
  • AEM as a Cloud Service의 코드를 현대화할 수 있도록 사용해야 하는 코드 리팩터링 도구에 대해 설명합니다

Cloud Manager 사용 using-cloud-manager

시작하기 전에 Cloud Manager에 코드를 배포하는 유일한 메커니즘이므로 AEM as a Cloud Service에 대해 숙지해야 합니다.

조직에서 Cloud Manager를 사용하여 클라우드에서 AEM을 자체 관리할 수 있습니다. IT팀 및 구현 파트너가 성능 또는 보안을 손상하지 않고 사용자 지정 내용 또는 업데이트를 신속하게 전달할 수 있는 CI/CD(지속적 통합 및 지속적 배포) 프레임워크가 포함되어 있습니다.

아래 리소스를 참조하여 Cloud Manager 사용에 익숙해질 수 있습니다.

Adobe 제공 도구를 사용하여 콘텐츠 및 코드 클라우드를 준비하십시오. use-tools-to-make-code-and-content-cloud-ready

Cloud Service으로 전환하는 정확한 단계는 구입한 시스템과 사용자가 따르는 소프트웨어 개발 수명 주기 방침에 따라 다릅니다.

다음 그림은 AEM as a Cloud Service에서 사용할 코드 및 콘텐츠를 변환하는 단계와 관련된 주요 단계를 보여줍니다.

전환 단계

아래 단원에서 이를 수행할 수 있도록 사용해야 하는 도구에 대한 세부 사항을 설명하겠습니다.

콘텐츠 마이그레이션 content-migration

현재 AEM 인스턴스에서 Cloud Service 인스턴스로 콘텐츠를 마이그레이션하려면 Adobe의 콘텐츠 전송 도구를 사용할 수 있습니다.

이 도구를 사용하여 소스 AEM 인스턴스에서 AEM 클라우드 서비스 인스턴스로 전송하려는 컨텐츠 하위 집합을 지정할 수 있습니다.

콘텐츠 마이그레이션은 여러 팀 간의 계획, 추적 및 협업이 필요한 여러 단계로 진행되는 프로세스입니다.

Adobe 이 도구의 작동 방식과 사용 권장 방법에 대한 자세한 내용은 컨텐츠 전송 도구 설명서를 참조하십시오.

코드 리팩터링 code-refactor

개발을 위한 설정 set-up-for-development

이제 Cloud Service과 호환될 수 있도록 기존 기능을 리팩터링할 때입니다.

먼저 기본 도구에 대해 자세히 설명하는 설명서를 살펴보고 코드 리팩터링을 시작합니다.

  • 계획 중에 AEM as a Cloud Service과 호환되도록 리팩터링해야 하는 영역 목록을 갖는 것이 좋습니다. Cloud Service을 위해 코드를 리팩터링하고 최적화하는 방법에 대한 자세한 내용은 개발 지침을 검토할 수 있습니다.
  • AEM as a Cloud Service에서 구성을 관리하는 방법에 대해 읽어 보십시오.
  • AEM as a Cloud Service SDK를 다운로드하여 로컬 개발 환경을 설정하는 방법을 알아봅니다
  • 마지막으로 AEM as a Cloud Service Java API를 숙지하십시오.

또한 다음을 수행할 수도 있습니다.

마음가짐의 변화 a-change-in-mindset

AEM as a Cloud Service에서 코드를 개발하고 실행하려면 사고방식을 변경해야 합니다. 특히 인스턴스가 언제든지 중지될 수 있으므로 코드가 복원력이 있어야 합니다. 클라우드 서비스에서 실행 중인 코드는 항상 클러스터에서 실행되고 있다는 것을 알고 있어야 합니다. 즉, 실행되는 인스턴스가 항상 두 개 이상 있습니다.

AEM Maven 프로젝트가 클라우드와 호환되려면 특정 변경 사항이 필요합니다. AEM as a Cloud Service을 AEM에 배포하려면 content ​과(와) code ​을(를) 개별 패키지로 분리해야 합니다.

  • /apps 및 /libs은(는) AEM 시작 후(즉, 런타임 시) 변경할 수 없으므로 AEM에서 변경할 수 없는 영역으로 간주됩니다. 여기에는 만들기, 업데이트 또는 삭제 작업이 포함됩니다. 런타임 시 변경할 수 없는 영역을 변경하려고 하면 오류가 발생합니다.

  • 저장소의 다른 모든 항목(예: /content , /conf , /var , /home , /etc , /oak:index , /system , /tmp)은 모두 변경할 수 있는 영역입니다. 즉, 런타임 시 변경할 수 있습니다.

자세한 내용은 권장 패키지 구조 설명서를 참조하십시오.

클라우드 마이그레이션 도구 cloud-migration-tools

Adobe은 일부 코드 리팩터링 작업을 가속화하는 데 도움이 되는 몇 가지 도구를 제공합니다. 이러한 툴과 툴이 해결하는 문제를 이해하면 마이그레이션 복잡성과 시간이 줄어듭니다.

  • 자산 처리 워크플로우를 자동으로 마이그레이션하는 데 사용되는 도구인 자산 워크플로우 마이그레이션
  • 기존 Dispatcher 구성을 AEM as a Cloud Service에 맞는 형식으로 변환하는 도구인 Dispatcher 변환기.
  • AEM 다중 모드 프로젝트를 입력으로 받아 AEM as a Cloud Service 프로젝트로 변환하는 도구인 Repository Modernizer
  • 인덱스 변환기, 인덱스를 AEM as a Cloud Service과 호환되는 양식으로 변환하는 도구
  • 현대화 도구, 레거시 AEM 기능을 AEM as a Cloud Service의 최신 지원 기능으로 변환하는 데 사용할 수 있는 유틸리티 세트입니다.

로컬 개발 환경을 설정한 후에는 설명서를 참조하여 AEM as a Cloud Service SDK에 익숙해지십시오.

코드 고정 예약 schedule-a-code-freeze

전환 여정Adobe 의 일부로 코드 리팩터링 작업과 함께 활성 AEM에서 진행 중인 코드 개발을 관리하려면, Maven 프로젝트 재구성을 AEM as a Cloud Service과 호환되도록 완료할 때까지 코드 동결 기간을 예약하는 것이 좋습니다.

프로젝트 재구성이 완료되면 이 새 구조를 기반으로 새 코드 개발을 재개할 수 있습니다. 이렇게 하면 코드 배포 및 테스트 중 Cloud Manager 파이프라인 오류가 줄어듭니다.

NOTE
컨텐츠 전송 및 코드 리팩터링 작업은 순차적으로 수행하지 않아도 됩니다. 이러한 작업은 서로 독립적으로 수행할 수 있습니다. 그러나 컨텐츠가 클라우드 서비스 환경에서 성공적으로 렌더링되도록 하려면 올바른 프로젝트 구조가 필요합니다.

코드 배포 및 테스트 우수 사례 best-practices

Cloud Manager 파이프라인은 스테이지 환경에 대해 실행되는 테스트 실행을 지원합니다.

코드 품질 테스트에 대한 아래 문서의 모범 사례를 따르십시오.

  • 코드 품질 테스트. 테스트 스크립트를 작성하는 프로세스를 설명하고 최소 50%의 권장 적용 범위를 설명하는 문서입니다.
  • 사용자 지정 코드 품질 규칙 이해 AEM Engineering의 모범 사례를 기반으로 만들어진 Cloud Manager에서 실행되는 사용자 지정 코드 품질 규칙을 설명하는 것입니다.

Go-Live 준비 preparing-for-go-live

마이그레이션을 위한 소스 시스템을 준비하려면 시스템 및 AEM 관리자 수준 작업이 필요합니다. 먼저 수정 정리 및 데이터 저장소 가비지 수집 작업 상태를 확인하여 콘텐츠 리포지토리가 잘 유지 관리되고 있는지 확인할 수 있습니다. 컨텐츠 전송 도구가 버전 6.3부터 호환되므로 AEM 버전 6.3을 실행 중인 경우 오프라인 압축을 수행한 다음 데이터 저장소 가비지 수집을 수행하는 것이 좋습니다.

데이터 일관성 검사를 모든 AEM 버전에서 권장하므로 콘텐츠 리포지토리가 마이그레이션 활동을 시작하는 데 좋은 상태가 됩니다.

AZCopy를 설치하고 구성하려면 시스템 관리자 수준 액세스 권한이 필요합니다.

또한 사용하지 않은 Assets, 페이지, AEM 프로젝트, 사용자 및 그룹을 검토하여 마이그레이션 시간을 절약하는 것이 좋습니다. 콘텐츠 저장소 상태 섹션을 참조하십시오.

콘텐츠 저장소 상태 repository-health

프로덕션 복제에 대한 액세스가 설정되면 계속 진행하여 저장소의 상태를 확인합니다. 이전 섹션에서 언급했듯이 마이그레이션이 시작되기 전에 소스에서 저장소를 정리하고 압축하는 것이 목표입니다. 이 단계를 수행하면 마이그레이션이 시작된 후 문제를 해결하는 데 드는 시간을 절약할 수 있습니다.

작업 항목
주요 개선 사항
사용자, 그룹 및 권한
사용자, 그룹 및 멤버십의 복잡성에 대해 이해해야 합니다. 마이그레이션 전에 소스에서 사용하지 않는 사용자, 그룹을 정리할 수 있는 기회를 찾습니다.
불완전한 자산 처리
마이그레이션을 시작하기 전에 소스 시스템에서 자산 처리를 완료하여 AEM as a Cloud Service 마이그레이션 후 발생할 수 있는 문제를 방지하십시오.
콘텐츠 상태
마이그레이션을 시작하기 전에 잘못된 콘텐츠를 쿼리하고 제거하는 것이 좋습니다. 예를 들어 원본 렌디션이 없거나 워크플로우 처리에 남아 있는 에셋 또는 페이지를 찾습니다. 자산 상태도 참조하세요.

데이터 수집 중 gathering-data

NOTE
콘텐츠 마이그레이션 전략 및 타임라인 섹션에서는 수집된 데이터를 외삽하고 마이그레이션 계획을 만드는 방법에 대해 자세히 설명합니다.

데이터를 수집하면 마이그레이션 활동 및 관련 작업을 계획하는 데 도움이 될 수 있습니다. 데이터 포인트를 마이그레이션 세트의 특정 크기와 연결할 수 있으므로 추출 및 수집 시간이 특히 유용합니다. 따라서 다음 데이터 포인트를 외삽하여 계획을 제안할 수 있습니다.

  • 추출에 걸린 총 시간
  • 수집에 걸린 총 시간
  • 추가 추출에 걸린 총 시간
  • 추가 수집에 걸린 총 시간

이러한 데이터 포인트는 KPI 설정 및 기타 마이그레이션 관련 작업에도 도움이 될 수 있습니다.

마이그레이션 계획 migration-plan

수집한 데이터 포인트(위 참조)를 기반으로 매크로 프로젝트 계획에 통합할 수 있는 마이그레이션 계획을 만들 수 있습니다. 이 단계를 통해 모든 주요 이해 당사자는 마이그레이션 활동을 시각화하고 계획할 수 있습니다.

다음 표는 일반적인 마이그레이션 계획을 보여 줍니다.

마이그레이션 반복
시작 일자
예상 종료 일자
종속성
예상 기간(일)
추가 세부 정보/작업 항목
PRDCLONE-AUTHOR-INITIAL-USRMAP-CSSTAGE-AUTHOR
PRDCLONE-PUBLISH-TOPUP-CSSTAGE-AUTHOR

위의 표에서 볼 수 있듯이 특정 이름 지정 형식을 따라 마이그레이션 반복을 식별하는 것이 유용합니다. 예를 들어 소스 AEM 환경의 경우 PRDCLONE, AEM as a Cloud Service 환경의 경우 AUTHOR/PUBLISH, AEM as a Cloud Service 인스턴스의 경우 CSSTAGE-AUTHOR 등입니다.

마이그레이션 계획에 영향을 주는 몇 가지 중요한 세부 정보:

필요한 총 추출 수

  • 특정 환경의 작성자 및 Publish 추출은 서로 독립적이므로 두 개의 병렬 추출로 간주됩니다.
  • 특정 기간의 저장소 증가를 기반으로 하는 추가 추출 수입니다.

필요한 총 수집 수

  • 추출된 세트는 여러 Cloud Service 환경으로 수집할 수 있으므로 이 항목을 플랜에 캡처하는 것이 중요합니다.
  • 추가 수집 수.
  • Source 작성자에서 클라우드 서비스 작성자 인스턴스로, Source Publish에서 Cloud Service Publish으로 콘텐츠를 마이그레이션하는 것은 모든 작성자 콘텐츠를 Cloud Service Publish에 수집하지 않는 모범 사례입니다.

마이그레이션 추적기 migration-tracker

마이그레이션 추적기를 사용하여 초기 실행과 위로 실행 모두에 대한 시간을 기록할 수 있습니다. 이러한 데이터 포인트는 최종 추가 작업 전에 사실적인 콘텐츠 고정 요구 사항을 작성하는 데 도움이 됩니다.

추적기는 또한 다음을 수행하는 데 도움이 됩니다.

  • 계획 또는 Go-Live 타임라인에서 조정이 필요한 계획자의 변경 사항을 식별합니다
  • 필요한 모든 통신에 사용할 수 있는 실제 상태 제공
  • 초기 또는 향후 추가 마이그레이션 계획

다음 표는 기능 마이그레이션 추적기를 보여 줍니다.

Source (환경 / 인스턴스 / URL)
대상(환경/인스턴스/URL)
마이그레이션 세트 이름, 유형(초기 또는 추가)
마이그레이션 세트 크기(MB)
사용자 매핑 (예 / 아니요)
추출 기간(시작, 종료, 소요 시간)
수집 기간(시작, 종료, 소요 시간)
문제 / 해결 방법 / 세부 정보

컨텐츠 마이그레이션 전략 및 타임라인 content-strategyand-timeline

다음 섹션에서는 컨텐츠 마이그레이션 전략 및 타임라인을 수립하는 데 사용할 수 있는 중요한 단계 및 관련 작업을 보여줍니다.

마이그레이션 전략을 만드는 단계

장비 fitment

  • 개정 정리, 데이터 저장소 가비지 수집 및 데이터 일관성 검사를 수행합니다. Go-Live 준비 중도 참조하세요.

  • AEM 원본 저장소에 대한 통계 수집:

    • 세그먼트 저장소 크기
    • 인덱스 저장소 크기
    • 페이지 수
    • 에셋 수
    • 사용자 및 그룹 수

  • AEM 소스에서 다음 기능을 활성화할지(AEM as a Cloud Service에서도 필요) 확인합니다.

    • 스마트 태그 지정
    • 유사성 검색
    • Word 및 PDF 문서에서 포함 텍스트 검색

  • 모범 사례 분석기 보고서 수집

  • Cloud Acceleration Manager(으)로 가져오기

    • 자체 분석 권장 사항을 검토하여 AEM as a Cloud Service이 스토리지 요구 사항을 처리할 수 있는지 확인하십시오.

  • 마이그레이션 계획을 계속하기 전에 설명이 필요한 Adobe 지원 티켓을 만드십시오.

마이그레이션 증명 proof-of-migration

  • 다음과 같은 운영 클론 요청:

    • 동일한 네트워크 영역에 있음
    • 사용자 및 그룹과 같은 프로덕션 콘텐츠를 제공합니다.
    • 작성자 및 게시 복제 - 클러스터 또는 게시 팜의 경우 각각 하나의 노드

  • 다음과 같이 마이그레이션되는 콘텐츠의 하위 집합을 선택하십시오.

    • 사용 가능한 모든 콘텐츠 유형이 혼합되어 있습니다
    • 모든 사용자 및 그룹 포함

  • 컨텐츠의 25% 또는 최대 1TB의 컨텐츠 중 더 적은 것을 포함합니다.

  • 프로덕션 복제본에서 AEM as a Cloud Service 비프로덕션 환경으로 하나 이상의 전체 및 추가 마이그레이션을 실행합니다.

  • 다음과 같은 잠재적 문제를 해결합니다.

  • 추출 및 수집에 걸린 시간을 기록하십시오.

    • 일주일에 추가되는 콘텐츠 양을 파악할 수 있습니다.
    • 마이그레이션 계획을 만들기 위해 마이그레이션 증명에서 측정된 시간을 외삽합니다.

다음 단계 what-is-next

AEM 설치를 클라우드로 이전할 준비가 되었는지 평가하는 방법을 완전히 이해한 후에는 이를 준비하는 데 필요한 도구를 사용하는 방법에 대해 알아보았으므로 Go-Live 단계(으)로 이동할 차례입니다.

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