설명서Experience Cloud KCS

Cloud Manager 배포를 위한 AEM 프로덕션 코드 롤백 절차

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

Adobe Experience Manager(AEM) 프로덕션 배포에는 배포 유형, 배포 기간 및 호스팅 모델에 따라 다른 롤백 방법이 필요합니다. 이 문제는 Cloud Manager이 적합한 전체 스택 배포에 대해서만 롤백을 지원하는 반면 프론트엔드 전용 배포, 이전 배포 및 특정 AMS 시나리오에는 대체 복구 방법이 필요하기 때문에 발생합니다. 이 문제를 해결하려면 롤백 적격성을 식별하고 코드를 복원한 다음 배포를 확인합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • 프로덕션 배포에서는 회귀가 발생하며 즉시 롤백이 필요합니다.
  • 이전에 성공적으로 배포한 기간이 30일 이상이므로 배포된 이전 코드 복원 옵션을 사용할 수 없습니다.
  • 프론트엔드 전용 배포는 잘못된 CSS 또는 JavaScript 변경 사항을 도입하며 Cloud Manager 복원 기능을 통해 롤백할 수 없습니다.
  • Git 동기화 또는 분기 문제로 인해 이전 커밋이 재배포되지 않습니다.
  • AMS 환경 복원은 복구 중에 다운타임을 연장합니다.

근본 원인

이 문제는 AEM에서 플랫폼 코드, 고객 사용자 지정 코드 및 변경 가능한 콘텐츠를 분리하기 때문에 발생합니다. 전체 스택 배포만 Cloud Manager에서 복원할 수 있는 아티팩트를 생성합니다. 프론트엔드 전용 배포는 복원 가능한 AEM 이미지를 생성하지 않으며, 30일 이상 지난 배포는 복원 작업을 위해 유지되지 않습니다. 파란색-녹색 배포 기능이 없는 AMS 환경은 재배포 또는 환경 복원에 의존하여 다운타임을 초래할 수 있습니다.

해결 방법 resolution

올바른 롤백 전략을 결정하고 프로덕션 안정성을 복원하려면 다음 단계를 따르십시오.

  1. 배포가 전체 스택 배포인지, 프론트엔드 전용 배포인지, AMS 배포인지 또는 지원되는 복원 창 외부의 이전 배포인지를 확인하여 롤백 시나리오를 식별합니다.
  2. AEM as a Cloud Service(으)로 이동하여 적격한 Cloud Manager 전체 스택 배포 복원 > 환경 > 프로덕션 환경 > 복원 > 이전 코드가 배포됨 이전에 성공한 배포가 지원되는 보존 기간 내에 있을 때.
  3. 복원 옵션을 사용할 수 없을 때 정상 작동이 확인된 커밋으로 되돌리고 프로덕션 파이프라인을 통해 되돌린 코드를 재배포하여 Git 기반 롤백을 수행합니다.
  4. Cloud Manager 복원은 프론트엔드 전용 배포를 지원하지 않으므로 Git에서 프론트엔드 코드를 되돌리고 프론트엔드 배포 파이프라인을 다시 실행하여 프론트엔드 전용 배포를 롤백합니다.
  5. 이전 코드 버전을 재배포하거나 필요한 경우 환경 복원을 요청하여 AEM Managed Services 배포를 복원합니다.
  6. 파이프라인이 정상적으로 완료되고 예상 커밋 버전이 활성으로 표시되는지 확인하여 배포 완료를 확인합니다.
  7. 프로덕션 연기 테스트를 수행하고, 애플리케이션 안정성을 확인하고, 복원된 코드가 예상대로 작동하는지 확인하여 해상도를 확인합니다.

에스컬레이션 시기

  • 배포가 복원 자격 요구 사항을 충족하더라도 복원 옵션은 계속 사용할 수 없습니다.
  • 이전 커밋으로 되돌린 후 배포가 반복적으로 실패합니다.
  • 롤백이 잘못된 코드 버전을 복원하거나 추가 불안정을 초래합니다.
  • 저장소 동기화 문제로 인해 Git에서 롤백 또는 재배포가 되지 않습니다.

관련 읽기

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