코드 배포 deploy-your-code
AEM as a Cloud Service에서 Cloud Manager 파이프라인을 사용하여 프로덕션에 코드를 배포하는 방법에 대해 알아봅니다.
코드를 스테이지에 원활하게 배포한 다음 프로덕션 파이프라인을 통해 프로덕션까지 배포합니다. 프로덕션 파이프라인 실행은 다음 두 가지 논리적 단계로 나뉩니다.
- 스테이징 환경에 배포 - 자동화된 기능 테스트, UI 테스트, 경험 감사 및 UAT(사용자 승인 테스트)를 위해 코드가 스테이징 환경에 빌드 및 배포됩니다.
- 프로덕션 환경에 배포 - 빌드가 스테이지에서 검증되고 프로덕션으로의 승격이 승인되면 동일한 빌드 아티팩트가 프로덕션 환경에 배포됩니다.
전체 스택 코드 파이프라인 유형만 코드 스캔, 기능 테스트, UI 테스트 및 경험 감사를 지원합니다.
배포 프로세스 deployment-process
모든 Cloud Service 배포는 롤링 프로세스를 통해 가동 중지 없이 구현됩니다. 자세한 내용은 롤링 배포 작동 방식을 참조하십시오.
AEM as a Cloud Service에서 Cloud Manager을 사용하여 코드 배포 deploying-code-with-cloud-manager
저장소, 환경 및 테스트 환경을 포함하여 프로덕션 파이프라인을 구성했으면 코드를 배포할 준비가 된 것입니다.
-
my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.
-
내 프로그램 콘솔에서 코드를 배포할 프로그램을 클릭합니다.
-
개요 페이지의 콜 투 액션 영역에서 배포 를 클릭합니다.
-
프로덕션에 배포 페이지에서 빌드 를 클릭합니다.
빌드 프로세스는 다음 세 가지 순서가 지정된 단계를 통해 코드를 배포합니다.
스테이지 배포 단계 stage-deployment
스테이지 배포 단계에는 다음 단계가 포함됩니다.
빌드 환경 세부 정보🔗를 참조하십시오.
테스트 프로세스에 대한 자세한 내용은 코드 품질 테스트를 참조하십시오.
스테이지 테스트 단계 stage-testing
스테이지 테스트 단계에는 다음 단계가 포함됩니다.
제품 기능 테스트🔗도 참조하세요.
사용자 지정 기능 테스트🔗도 참조하세요.
UI 테스트는 Selenium 기반이며 도커 이미지에 패키징되어 언어 및 프레임워크에 유연성을 제공합니다. 이 접근 방식을 사용하면 Java 및 Maven, Node 및 WebDriver.io 또는 Selenium 기반 프레임워크 또는 기술을 사용할 수 있습니다.
또한 사용자 지정 UI 테스트를 참조하십시오.
파이프라인의 이 단계는 항상 실행되며 건너뛸 수 없습니다. 프로덕션 파이프라인이 실행되면 검사를 실행하는 사용자 정의 기능 테스트 후 경험 감사 단계가 포함됩니다.
- 구성된 페이지는 서비스에 제출되고 평가됩니다.
- 결과는 정보 제공용이며 점수, 현재 점수와 이전 점수 간의 변화를 보여 줍니다.
- 이 인사이트는 현재 배포에 도입될 회귀가 있는지 확인하는 데 유용합니다.
경험 감사 결과 이해를 참조하십시오.
프로덕션 배포 단계 production-deployment
프로덕션 토폴로지에 배포하는 프로세스는 AEM 사이트 방문자에게 미치는 영향을 최소화하기 위해 약간 달라집니다.
프로덕션 배포는 일반적으로 이전에 설명한 것과 동일한 단계를 따르지만 롤링 방식으로 수행됩니다. 이러한 단계에는 다음이 포함됩니다.
- AEM 패키지를 작성자에게 배포합니다.
- 부하 분산 장치에서
dispatcher1
을(를) 분리합니다. - AEM 패키지를
publish1
에 배포하고 Dispatcher 패키지를dispatcher1
에 배포하고 Dispatcher 캐시를 플러시합니다. dispatcher1
을(를) 부하 분산 장치에 다시 넣으십시오.dispatcher1
이(가) 다시 작동하면 로드 밸런서에서dispatcher2
을(를) 분리합니다.- AEM 패키지를
publish2
에 배포하고 Dispatcher 패키지를dispatcher2
에 배포하고 Dispatcher 캐시를 플러시합니다. dispatcher2
을(를) 부하 분산 장치에 다시 넣으십시오.
이 프로세스는 배포가 토폴로지의 모든 게시자 및 Dispatcher에 도달할 때까지 계속됩니다.
배포 중 시간 초과 timeouts
다음 단계는 배포 중 사용자 피드백을 기다리는 동안 남아 있는 경우 시간 초과됩니다.
프로덕션 배포 재실행 reexecute-deployment
드문 경우지만 일시적인 이유로 프로덕션 배포 단계에 실패할 수 있습니다. 이러한 경우 완료 유형(예: 취소 또는 실패)에 관계없이 프로덕션 배포 단계가 완료된 한 프로덕션 배포 단계의 재실행이 지원됩니다. 재실행은 다음 세 단계로 구성된 동일한 파이프라인을 사용하여 새 실행을 만듭니다.
- 유효성 검사 - 일반 파이프라인 실행 중에 발생하는 유효성 검사와 동일합니다.
- 빌드 - 재실행의 맥락에서 빌드 단계는 실제로 새 빌드 프로세스를 실행하지 않고 아티팩트를 복사합니다.
- 프로덕션 배포 - 일반 파이프라인 실행에서 프로덕션 배포 단계와 동일한 구성 및 옵션을 사용합니다.
재실행이 가능한 상황에서 프로덕션 파이프라인 상태 페이지는 일반적인 빌드 로그 다운로드 옵션 옆에 재실행 옵션을 제공합니다.
제한 사항 limitations
- 프로덕션 배포 단계를 재실행하는 것은 마지막 실행에서만 사용할 수 있습니다.
- 푸시 업데이트 실행은 재실행이 불가능합니다. 마지막 실행이 푸시 업데이트 실행인 경우 재실행이 불가능합니다.
- 프로덕션 배포 단계 이전의 어느 시점에서 마지막 실행이 실패한 경우 재실행이 불가능합니다.
재실행 API reexecute-API
UI에서 사용할 수 있으며, Cloud Manager API를 사용하여 재실행을 트리거하고 재실행으로 트리거된 실행을 식별할 수도 있습니다.
재실행 트리거 reexecute-deployment-api
재실행을 트리거하려면 프로덕션 배포 단계 상태에서 HAL 링크(https://ns.adobe.com/adobecloud/rel/pipeline/reExecute
)에 대해 PUT 요청을 수행해야 합니다.
- 이 링크가 있으면 해당 단계에서 재실행할 수 있습니다.
- 이 링크가 없으면 해당 단계에서 재실행할 수 없습니다.
이 링크는 프로덕션 배포 단계에서만 사용할 수 있습니다.
{
"_links": {
"https://ns.adobe.com/adobecloud/rel/pipeline/logs": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
"templated": false
},
"https://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
"href": "/api/program/4/pipeline/1/execution?stepId=2983530",
"templated": false
},
"https://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
"templated": false
},
"self": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
"templated": false
}
},
"id": "6187842",
"stepId": "2983530",
"phaseId": "1575676",
"action": "deploy",
"environment": "weretail-global-b75-prod",
"environmentType": "prod",
"environmentId": "59254",
"startedAt": "2022-01-20T14:47:41.247+0000",
"finishedAt": "2022-01-20T15:06:19.885+0000",
"updatedAt": "2022-01-20T15:06:20.803+0000",
"details": {
},
"status": "FINISHED"
HAL 링크의 href 값 구문은 예시일 뿐입니다. 실제 값은 항상 HAL 링크에서 읽어야 하며 생성되지 않아야 합니다.
이 끝점에 PUT 요청을 제출하면 성공 시 201 응답이 발생하고 응답 본문은 새 실행을 나타냅니다. 이 워크플로우는 API를 통해 일반 실행을 시작하는 것과 유사합니다.
재실행 식별 identify-reexecution
시스템은 trigger
필드를 RE_EXECUTE
값으로 설정하여 재실행을 식별합니다.