코드 배포 code-deployment
코드를 배포하는 방법과 배포 시 Cloud Manager에서 어떤 일이 발생하는지 알아보십시오.
Cloud Manager로 코드 배포 deploying-code-with-cloud-manager
필요한 저장소 및 환경을 포함하여 프로덕션 파이프라인을 구성했으면 코드를 배포할 준비가 된 것입니다.
-
Cloud Manager에서 배포 를 클릭하여 배포 프로세스를 시작합니다.
-
파이프라인 실행 화면이 표시됩니다. 빌드 를 클릭하여 프로세스를 시작합니다.
빌드 프로세스는 다음 단계를 포함하여 코드 배포 프로세스를 시작합니다.
- 스테이지 배포
- 스테이지 테스트
- 프로덕션 배포
로그를 보거나 테스트 기준에 대한 결과를 검토하여 다양한 배포 프로세스의 단계를 검토할 수 있습니다.
배포 단계 deployment-steps
배포의 각 단계 동안 여러 가지 작업이 수행되며, 이는 이 섹션에서 설명합니다. 코드 자체가 백그라운드에서 어떻게 배포되는지에 대한 자세한 내용은 배포 프로세스 세부 정보를 참조하십시오.
스테이지 배포 단계 stage-deployment
스테이지 배포 단계에는 다음 작업이 포함됩니다.
스테이지 테스트 단계 stage-testing
스테이지 테스트 단계에는 다음 작업이 포함됩니다.
프로덕션 배포 단계 production-deployment
프로덕션 배포 단계에는 다음 작업이 포함됩니다.
-
승인 신청
- 이 옵션은 파이프라인을 구성하는 동안 활성화됩니다.
- 이 옵션을 사용하면 프로덕션 배포를 예약하거나 지금 을 클릭하여 프로덕션 배포를 즉시 실행할 수 있습니다.
-
프로덕션 배포 예약
-
이 옵션은 파이프라인을 구성하는 동안 활성화됩니다.
-
예약된 날짜 및 시간은 사용자의 표준 시간대로 지정됩니다.
-
-
CSE 지원(활성화된 경우)
-
프로덕션에 배포
배포가 완료되면 코드가 대상 환경에 있으며 로그를 볼 수 있습니다.
시간 초과 timeouts
사용자 피드백을 기다리는 동안 다음 단계가 시간 초과됩니다.
배포 프로세스 세부 정보 deployment-process
Cloud Manager는 빌드 프로세스에서 생성된 모든 대상/*.zip 파일을 스토리지 위치에 업로드합니다. 이러한 아티팩트는 파이프라인의 배포 단계 동안 이 위치에서 검색됩니다.
Cloud Manager가 비프로덕션 토폴로지에 배포하는 경우 가능한 한 빨리 배포를 완료하는 것이 목표이므로 다음과 같이 아티팩트가 모든 노드에 동시에 배포됩니다.
-
Cloud Manager은 각 아티팩트가 AEM 패키지인지 Dispatcher 패키지인지 결정합니다.
-
Cloud Manager는 배포 중에 환경을 격리하기 위해 로드 밸런서에서 모든 Dispatcher를 제거합니다.
- 달리 구성되지 않은 경우 개발 및 스테이징 배포에서 로드 밸런서 변경 사항을 건너뛸 수 있습니다. 즉, 개발 환경의 경우 비프로덕션 파이프라인의 분리 및 연결 단계, 스테이징 환경의 경우 프로덕션 파이프라인의 분리 및 연결 단계를 수행합니다.
note note NOTE 1-1-1 고객이 이 기능을 사용할 것으로 예상됩니다. -
각 AEM 아티팩트는 Package Manager API를 통해 각 AEM 인스턴스에 배포되며, 패키지 종속성이 배포 순서를 결정합니다.
- 패키지를 사용하여 새 기능을 설치하고 인스턴스 간에 콘텐츠를 전송하고 저장소 콘텐츠를 백업하는 방법에 대해 자세히 알아보십시오. 패키지 관리자를 참조하세요.
note note NOTE 모든 AEM 아티팩트는 작성자와 게시자 모두에게 배포됩니다. 노드별 구성이 필요한 경우 실행 모드를 활용해야 합니다. 실행 모드를 사용하여 특정 목적을 위해 AEM 인스턴스를 조정하는 방법에 대한 자세한 내용은 AEM as a Cloud Service에 배포🔗 문서의 실행 모드 섹션을 참조하십시오. -
Dispatcher 아티팩트는 다음과 같이 각 Dispatcher에 배포됩니다.
- 현재 구성이 백업되고 임시 위치에 복사됩니다.
- 변경 불가능한 파일을 제외한 모든 구성이 삭제됩니다. 자세한 내용은 Dispatcher 구성을 참조하십시오. 이 방법은 디렉토리를 지워 고립된 파일이 남지 않도록 합니다.
- 아티팩트가
httpd
디렉터리로 추출됩니다. 변경할 수 없는 파일은 덮어쓰지 않습니다. Git 저장소의 변경할 수 없는 파일에 대해 변경한 내용은 배포 시 무시됩니다. 이러한 파일은 AMS Dispatcher 프레임워크의 핵심이며 변경할 수 없습니다. - Apache는 구성 테스트를 수행합니다. 오류가 발견되지 않으면 서비스가 다시 로드됩니다. 오류가 발생하는 경우 구성이 백업에서 복원되고 서비스가 다시 로드되며 오류가 Cloud Manager에 다시 보고됩니다.
- 파이프라인 구성에 지정된 각 경로가 무효화되거나 Dispatcher 캐시에서 플러시됩니다.
note note NOTE Cloud Manager에서는 Dispatcher 아티팩트에 전체 파일 세트가 포함될 것으로 예상합니다. 모든 Dispatcher 구성 파일이 Git 저장소에 있어야 합니다. 파일 또는 폴더가 없으면 배포가 실패합니다. -
모든 AEM 및 Dispatcher 패키지를 모든 노드에 성공적으로 배포한 후 Dispatcher가 로드 밸런서에 다시 추가되고 배포가 완료됩니다.
note note NOTE 개발 및 스테이징 배포에서 로드 밸런서 변경 사항을 건너뛸 수 있습니다. 즉, 개발 환경의 경우 비프로덕션 파이프라인의 분리 및 연결 단계를 수행하고 스테이징 환경의 경우 프로덕션 파이프라인을 수행합니다.
프로덕션에 배포 단계 deployment-production-phase
프로덕션 토폴로지에 배포하는 프로세스는 AEM 사이트 방문자에 미치는 영향을 최소화하기 위해 약간 달라집니다.
프로덕션 배포는 일반적으로 위와 동일한 단계를 따르지만 롤링 방식으로 수행됩니다.
- AEM 패키지를 작성자에게 배포합니다.
- 로드 밸런서에서 dispatcher1을 분리합니다.
- AEM 패키지를 publish1에 배포하고 Dispatcher 패키지를 dispatcher1에 동시에 배포하고 Dispatcher 캐시를 플러시합니다.
- dispatcher1을 로드 밸런서에 다시 넣습니다.
- dispatcher1이 다시 작동하면 로드 밸런서에서 dispatcher2를 분리합니다.
- AEM 패키지를 publish2에 배포하고 동시에 Dispatcher 패키지를 dispatcher2에 배포하고 Dispatcher 캐시를 플러시합니다.
- dispatcher2를 로드 밸런서에 다시 넣습니다.
이 프로세스는 배포가 토폴로지의 모든 게시자 및 dispatcher에 도달할 때까지 계속됩니다.
긴급 파이프라인 실행 모드 emergency-pipeline
중요한 상황에서 Adobe Managed Services 고객은 코드 변경 사항을 스테이징 및 프로덕션 환경에 즉시 배포해야 할 수 있습니다. 이 기능을 사용하면 전체 Cloud Manager 테스트 주기를 우회할 수 있습니다.
이러한 상황을 해결하기 위해 Cloud Manager 프로덕션 파이프라인을 긴급 모드로 실행할 수 있습니다. 이 모드를 사용하면 보안 및 성능 테스트 단계가 실행되지 않습니다. 구성된 승인 단계를 포함한 다른 모든 단계는 일반 파이프라인 실행 모드와 마찬가지로 실행됩니다.
긴급 파이프라인 실행 모드 사용 using-emergency-pipeline
프로덕션 파이프라인 실행을 시작할 때 대화 상자에서 일반 모드와 긴급 모드 중 하나를 선택할 수 있습니다. 이 옵션은 프로그램에 대해 긴급 파이프라인 실행 모드 기능이 활성화된 경우 사용할 수 있습니다. 이 옵션은 기능이 활성화되면 사용할 수 있습니다.
긴급 모드에서 실행하는 경우 파이프라인 실행 세부 정보 페이지를 볼 때 화면 상단의 경로에는 파이프라인이 긴급 모드에서 실행 중이라는 표시기가 나타납니다.
긴급 모드에서 파이프라인을 실행하는 것은 Cloud Manager API 또는 CLI를 통해서도 가능합니다. 긴급 모드에서 실행을 시작하려면 쿼리 매개변수 ?pipelineExecutionMode=EMERGENCY
또는 CLI를 사용하여 파이프라인의 실행 엔드포인트에 PUT
요청을 제출합니다.
$ aio cloudmanager:pipeline:create-execution PIPELINE_ID --emergency
프로덕션 배포 재실행 reexecute-deployment
드문 경우지만 일시적인 이유로 프로덕션 배포 단계에 실패할 수 있습니다. 이러한 경우 성공, 취소 또는 실패 여부에 관계없이 프로덕션 배포 단계가 완료되면 다시 실행할 수 있습니다. 재실행은 다음 세 단계로 구성된 동일한 파이프라인을 사용하여 지원됩니다.
- 유효성 검사 단계 - 일반 파이프라인 실행 중에 발생하는 유효성 검사와 동일합니다.
- 빌드 단계 - 재실행의 맥락에서 빌드 단계는 실제로 새 빌드 프로세스를 실행하는 것이 아니라 아티팩트를 복사하는 것입니다.
- 프로덕션 배포 단계 - 일반 파이프라인 실행에서 프로덕션 배포 단계와 동일한 구성 및 옵션을 사용합니다.
재실행이 가능한 상황에서 프로덕션 파이프라인 상태 페이지는 일반적인 빌드 로그 다운로드 옵션 옆에 재실행 옵션을 제공합니다.
제한 사항 limitations
- 프로덕션 배포 단계를 재실행하는 것은 마지막 실행에서만 사용할 수 있습니다.
- 롤백 실행 또는 "푸시 업데이트" 실행은 재실행이 불가능합니다.
- 프로덕션 배포 단계 이전의 어느 시점에서 마지막 실행이 실패한 경우 재실행이 불가능합니다.
재실행 API reexecute-api
UI에서 사용할 수 있을 뿐만 아니라 Cloud Manager API를 사용하여 재실행을 트리거하고 재실행으로 트리거된 실행을 식별할 수 있습니다.
재실행 트리거 triggering
재실행을 트리거하려면 프로덕션 배포 단계 상태에서 HAL 링크 http://ns.adobe.com/adobecloud/rel/pipeline/reExecute
에 대해 PUT
요청을 수행해야 합니다.
- 이 링크가 있으면 해당 단계에서 재실행할 수 있습니다.
- 이 링크가 없으면 해당 단계에서 재실행할 수 없습니다.
이 링크는 프로덕션 배포 단계에서만 사용할 수 있습니다.
{
"_links": {
"http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
"templated": false
},
"http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
"href": "/api/program/4/pipeline/1/execution?stepId=2983530",
"templated": false
},
"http://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를 통해 일반 실행을 시작하는 것과 유사합니다.
재실행 식별 identifying
시스템은 트리거 필드의 값 RE_EXECUTE
을(를) 통해 재실행된 실행을 식별합니다.