[Beta]{class="badge positive"}
카나리아 배포를 사용하여 코드 유효성 검사 canary-deployments
AEM Cloud Service 구현의 경우, Cloud Manager의 카나리아 배포를 사용하면 실제 사용자 트래픽을 AEM으로 라우팅하기 전에 라이브 프로덕션 인프라의 게시 계층에서 새 코드를 확인할 수 있습니다. 현재 안정적인 버전과 함께 새 버전을 배포하고 전용 요청 헤더를 통해 도달합니다. 새 버전이 성공적으로 작동함을 확인한 후 모든 트래픽으로 승격하거나(3시간 기간 후 자동으로 발생) 롤백할 수 있습니다.
개발 및 스테이지 환경은 코드 릴리스를 테스트하는 기본 위치로 유지됩니다. 카나리아 배포는 릴리스가 예상대로 작동하는지 확인할 수 있는 추가 기회입니다. 예를 들어 AEM 프로덕션이 하위 AEM 환경에서 명시적으로 검증되지 않은 외부 서비스의 프로덕션 끝점과 통합되는 경우 유용합니다.
카나리아 배포는 실제 사용자 트래픽을 이전 릴리스에서 새 릴리스로 이동하는 것이 아니라 내부 유효성 검사를 위한 것입니다. 실제 사용자 트래픽은 카나리아 인스턴스로 자동으로 라우팅되지 않습니다.
카나리아 배포 프로세스 how-canary-deployments-work
카나리아 배포가 활성화된 전체 스택 파이프라인을 실행하면 Cloud Manager은 안정적인 인스턴스가 사용자에게 서비스를 제공하는 동안 새 빌드에 대해 별도의 카나리아 인스턴스 세트를 시작합니다. 프로세스는 다음 단계를 따릅니다.
- 카나리아 배포가 활성화된 전체 스택 배포 파이프라인, 스테이지 또는 프로덕션을 실행합니다.
파이프라인 실행 및 카나리아 배포 사용을 참조하세요. - 배포 단계에서 Cloud Manager은 새 버전의 코드를 실행하는 카나리아 인스턴스를 시작합니다.
- 기존의 안정적인 인스턴스는 라이브 트래픽을 계속 제공합니다.
- 카나리아 요청 헤더를 추가하여 새 버전에 선택적으로 도달할 수 있습니다. 카나리아 릴리스 액세스를 참조하세요.
- 유효성 검사 기간 동안 카나리아 릴리스를 모든 트래픽으로 프로모션하거나 취소합니다. 확인 및 승격 또는 취소를 참조하세요.
카나리아 배포 활성화 enable-canary-deployments
전체 스택 파이프라인에서 카나리아 배포를 활성화합니다. 카나리아 배포는 단계 및 프로덕션 환경에서만 지원됩니다. 스테이지와 프로덕션 모두에 배포하도록 구성된 파이프라인은 아래에 표시된 대로 프로덕션에서만 카나리아 배포를 실행합니다.
파이프라인 유형별 카나리아 배포 동작
카나리아 배포가 실행되는 위치는 파이프라인 유형에 따라 다릅니다.
카나리아 배포를 사용하려면:
-
Cloud Manager에서 단계 또는 프로덕션 환경에 전체 스택 코드를 배포하는 새 파이프라인을 추가하거나 기존 파이프라인을 편집합니다.
-
프로덕션 파이프라인 편집 대화 상자에서 Source 코드 탭을 클릭합니다.
-
파이프라인 섹션의 프로덕션 배포 옵션 제목 아래에서 카나리아 배포(베타)를 클릭합니다.
-
파이프라인 활성화를 완료하려면 업데이트를 클릭하십시오.
유효성 검사 기간 동안 카나리아 헤더를 포함하는 요청만 새로 배포된 릴리스에 도달합니다. 다른 모든 요청은 안정적인 릴리스에 계속 도달합니다.
카나리아 릴리스 액세스 access-the-canary-release
Cloud Manager이 카나리아 인스턴스를 시작하면 요청에 HTTP 헤더를 추가하여 새 버전에 도달합니다. 안정적인 버전은 헤더 없이 요청을 계속 처리합니다.
카나리아 릴리스에 요청을 보내려면 다음 헤더를 포함합니다.
X-Aem-Canary: true
유효성 검사 및 승격 또는 취소 validate-and-promote-or-cancel
카나리아 인스턴스가 준비되면 새 버전을 테스트할 수 있는 유효성 검사 창이 열립니다. Cloud Manager은 프로덕션에 배포 섹션에 프로덕션으로 승격 및 배포 취소 옵션을 표시합니다.
준비 카나리아 릴리스에 대한 배포 취소 및 프로덕션으로 승격 작업을 표시하는
카나리아 릴리스 홍보 promote-the-canary-release
모든 라이브 트래픽을 새 버전으로 라우팅하려면 프로덕션으로 승격을 클릭하세요. 카나리아 릴리스를 프로모션할 때:
- 카나리아 버전이 안정된 새로운 릴리스가 됩니다.
- Cloud Manager은 모든 라이브 트래픽을 새 버전으로 라우팅합니다.
- 롤백을 더 이상 사용할 수 없습니다.
카나리아 배포 취소 cancel-the-canary-deployment
유효성 검사 기간 중에 문제가 발견되면 배포 취소를 클릭하십시오. 카나리아 배포를 취소하는 경우:
- Cloud Manager은 카나리아 릴리스를 중단하고 카나리아 인스턴스를 제거합니다.
- 이전의 안정적인 버전은 계속해서 트래픽을 처리합니다.
- 취소는 검증 기간 동안에만 가능합니다.
범위 및 제한 사항 scope-and-limitations
카나리아 배포를 사용할 때는 다음 범위 및 제한을 고려하십시오.
- 카나리아 배포는 게시 계층에만 적용됩니다. 작성자 계층은 카나리아 유효성 검사 중에 안정적인 버전에 남아 있습니다.
- 카나리아 게시 인스턴스가 기존 콘텐츠 구조를 제공할 수 있도록 변경 사항은 이전 버전과 호환되어야 합니다.
- 릴리스의 변경 가능한 콘텐츠 변경 사항은 카나리아 릴리스를 프로모션한 후에 적용됩니다. 유효성 검사 중에는 카나리아 인스턴스에서 이러한 변경 사항을 사용할 수 없습니다.