코드 배포

마지막 업데이트: 2024년 10월 11일

작성 대상:

  • 관리자
  • 개발자

AEM as a Cloud Service에서 Cloud Manager 파이프라인을 사용하여 프로덕션에 코드를 배포하는 방법에 대해 알아봅니다.

프로덕션 파이프라인 다이어그램

코드를 스테이지에 원활하게 배포한 다음 프로덕션 파이프라인을 통해 프로덕션까지 배포합니다. 프로덕션 파이프라인 실행은 다음 두 가지 논리적 단계로 나뉩니다.

  1. 스테이징 환경에 배포 - 자동화된 기능 테스트, UI 테스트, 경험 감사 및 UAT(사용자 승인 테스트)를 위해 코드가 스테이징 환경에 빌드 및 배포됩니다.
  2. 프로덕션 환경에 배포 - 빌드가 스테이지에서 검증되고 프로덕션으로의 승격이 승인되면 동일한 빌드 아티팩트가 프로덕션 환경에 배포됩니다.

전체 스택 코드 파이프라인 유형만 코드 스캔, 기능 테스트, UI 테스트 및 경험 감사를 지원합니다.

배포 프로세스

모든 Cloud Service 배포는 롤링 프로세스를 통해 가동 중지 없이 구현됩니다. 자세한 내용은 롤링 배포 작동 방식을 참조하십시오.

NOTE
Dispatcher 캐시는 배포할 때마다 지워집니다. 이후 새 게시 노드가 트래픽을 수락하기 전에 "준비"됩니다.

AEM as a Cloud Service에서 Cloud Manager을 사용하여 코드 배포

저장소, 환경 및 테스트 환경을 포함하여 프로덕션 파이프라인을 구성했으면 코드를 배포할 준비가 된 것입니다.

  1. my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.

  2. 내 프로그램 콘솔에서 코드를 배포할 프로그램을 클릭합니다.

  3. 개요 페이지의 콜 투 액션 영역에서 배포 ​를 클릭합니다.

    CTA

  4. 프로덕션에 배포 페이지에서 빌드 ​를 클릭합니다.

    파이프라인 실행 화면

빌드 프로세스는 다음 세 가지 순서가 지정된 단계를 통해 코드를 배포합니다.

TIP
테스트 기준에 대한 로그를 보거나 결과를 검토하여 다양한 배포 프로세스의 단계를 검토할 수 있습니다.

스테이지 배포 단계

스테이지 배포 단계에는 다음 단계가 포함됩니다.

스테이지 배포 단계설명
유효성 검사파이프라인이 현재 사용 가능한 리소스를 사용하도록 구성되었는지 확인합니다. 예를 들어 구성된 분기가 존재하고 환경이 사용 가능한지를 테스트합니다.
빌드 및 단위 테스트컨테이너화된 빌드 프로세스를 실행합니다.빌드 환경에 대한 자세한 내용은
빌드 환경 세부 정보🔗를 참조하십시오.
코드 검색애플리케이션 코드의 품질을 평가합니다.
테스트 프로세스에 대한 자세한 내용은 코드 품질 테스트를 참조하십시오.
이미지 빌드이 프로세스는 빌드 단계의 콘텐츠와 Dispatcher 패키지를 도커 이미지로 변환합니다. 또한 해당 패키지를 기반으로 Kubernetes 구성을 생성합니다.
스테이지로 배포단계 테스트 단계를 준비하는 동안 이미지가 스테이징 환경에 배포됩니다.

스테이지 배포

스테이지 테스트 단계

스테이지 테스트 단계에는 다음 단계가 포함됩니다.

스테이지 테스트 단계설명
제품 기능 테스트Cloud Manager 파이프라인은 스테이지 환경에 대해 실행되는 테스트를 실행합니다.
제품 기능 테스트🔗도 참조하세요.
사용자 정의 기능 테스트파이프라인의 이 단계는 항상 실행되며 건너뛸 수 없습니다. 빌드가 테스트 JAR을 생성하지 않으면 테스트가 자동으로 통과됩니다.
사용자 지정 기능 테스트🔗도 참조하세요.
사용자 정의 UI 테스트사용자 정의 애플리케이션에 대해 생성된 UI 테스트를 자동으로 실행하는 선택적 기능입니다.
UI 테스트는 Selenium 기반이며 도커 이미지에 패키징되어 언어 및 프레임워크에 유연성을 제공합니다. 이 접근 방식을 사용하면 Java 및 Maven, Node 및 WebDriver.io 또는 Selenium 기반 프레임워크 또는 기술을 사용할 수 있습니다.
또한 사용자 지정 UI 테스트를 참조하십시오.
경험 감사

파이프라인의 이 단계는 항상 실행되며 건너뛸 수 없습니다. 프로덕션 파이프라인이 실행되면 검사를 실행하는 사용자 정의 기능 테스트 후 경험 감사 단계가 포함됩니다.

  • 구성된 페이지는 서비스에 제출되고 평가됩니다.
  • 결과는 정보 제공용이며 점수, 현재 점수와 이전 점수 간의 변화를 보여 줍니다.
  • 이 인사이트는 현재 배포에 도입될 회귀가 있는지 확인하는 데 유용합니다.

경험 감사 결과 이해를 참조하십시오.

스테이지 테스트

프로덕션 배포 단계

프로덕션 토폴로지에 배포하는 프로세스는 AEM 사이트 방문자에게 미치는 영향을 최소화하기 위해 약간 달라집니다.

프로덕션 배포는 일반적으로 이전에 설명한 것과 동일한 단계를 따르지만 롤링 방식으로 수행됩니다. 이러한 단계에는 다음이 포함됩니다.

  1. AEM 패키지를 작성자에게 배포합니다.
  2. 부하 분산 장치에서 dispatcher1을(를) 분리합니다.
  3. AEM 패키지를 publish1에 배포하고 Dispatcher 패키지를 dispatcher1에 배포하고 Dispatcher 캐시를 플러시합니다.
  4. dispatcher1을(를) 부하 분산 장치에 다시 넣으십시오.
  5. dispatcher1이(가) 다시 작동하면 로드 밸런서에서 dispatcher2을(를) 분리합니다.
  6. AEM 패키지를 publish2에 배포하고 Dispatcher 패키지를 dispatcher2에 배포하고 Dispatcher 캐시를 플러시합니다.
  7. dispatcher2을(를) 부하 분산 장치에 다시 넣으십시오.

이 프로세스는 배포가 토폴로지의 모든 게시자 및 Dispatcher에 도달할 때까지 계속됩니다.

프로덕션 배포 단계

배포 중 시간 초과

다음 단계는 배포 중 사용자 피드백을 기다리는 동안 남아 있는 경우 시간 초과됩니다.

단계시간 초과
코드 품질 테스트14일
보안 테스트14일
성능 테스트14일
승인 신청14일
프로덕션 배포 예약14일
CSE 지원14일

프로덕션 배포 재실행

드문 경우지만 일시적인 이유로 프로덕션 배포 단계에 실패할 수 있습니다. 이러한 경우 완료 유형(예: 취소 또는 실패)에 관계없이 프로덕션 배포 단계가 완료된 한 프로덕션 배포 단계의 재실행이 지원됩니다. 재실행은 다음 세 단계로 구성된 동일한 파이프라인을 사용하여 새 실행을 만듭니다.

  1. 유효성 검사 - 일반 파이프라인 실행 중에 발생하는 유효성 검사와 동일합니다.
  2. 빌드 - 재실행의 맥락에서 빌드 단계는 실제로 새 빌드 프로세스를 실행하지 않고 아티팩트를 복사합니다.
  3. 프로덕션 배포 - 일반 파이프라인 실행에서 프로덕션 배포 단계와 동일한 구성 및 옵션을 사용합니다.

재실행이 가능한 상황에서 프로덕션 파이프라인 상태 페이지는 일반적인 빌드 로그 다운로드 옵션 옆에 재실행 옵션을 제공합니다.

파이프라인 개요 창의 재실행 옵션

NOTE
재실행에서 빌드 단계는 재빌드가 아니라 아티팩트를 복사하는 것임을 나타내기 위해 UI에 레이블이 지정됩니다.

제한 사항

  • 프로덕션 배포 단계를 재실행하는 것은 마지막 실행에서만 사용할 수 있습니다.
  • 푸시 업데이트 실행은 재실행이 불가능합니다. 마지막 실행이 푸시 업데이트 실행인 경우 재실행이 불가능합니다.
  • 프로덕션 배포 단계 이전의 어느 시점에서 마지막 실행이 실패한 경우 재실행이 불가능합니다.

재실행 API

UI에서 사용할 수 있으며, Cloud Manager 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를 통해 일반 실행을 시작하는 것과 유사합니다.

재실행 식별

시스템은 trigger 필드를 RE_EXECUTE 값으로 설정하여 재실행을 식별합니다.

Experience Manager