프로덕션 파이프라인 추가 configuring-production-pipelines

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

주제:
Cloud Manager

작성 대상:

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

Cloud Manager를 사용하여 코드를 배포할 프로덕션 파이프라인을 만들고 구성하는 방법에 대해 알아보십시오. 먼저 Cloud Manager에서 파이프라인이 작동하는 방식에 대한 보다 개념적인 개요를 원하는 경우 CI/CD 파이프라인 문서를 참조하십시오.

개요 overview

Cloud Manager의 파이프라인 설정 타일을 사용하여 두 가지 유형의 파이프라인을 만들 수 있습니다.

프로덕션 파이프라인 - 프로덕션 파이프라인은 Git 저장소에서 프로덕션으로 소스 코드를 가져오기 위한 일련의 조정된 단계로 구성되어 특별히 빌드된 파이프라인입니다.
비프로덕션 파이프라인 - 비프로덕션 파이프라인은 주로 코드 품질 검사를 실행하거나 소스 코드를 개발 환경에 배포하는 역할을 합니다.

이 문서는 프로덕션 파이프라인에 초점을 맞춥니다. 비프로덕션 파이프라인을 구성하는 방법에 대한 자세한 내용은 비프로덕션 파이프라인 구성 문서를 참조하십시오.

배포 관리자 역할은 파이프라인 설정을 담당합니다. 파이프라인 구성은 다음과 같이 구성됩니다.

파이프라인을 시작할 트리거를 정의합니다.
프로덕션 배포를 제어하는 매개변수를 정의합니다.
성능 테스트 매개변수를 구성합니다.

NOTE

연결된 Git 저장소에 분기가 하나 이상 있고 프로그램 설정이 완료될 때까지 파이프라인을 설정할 수 없습니다.

프로덕션 파이프라인 추가 adding-production-pipeline

Cloud Manager UI를 사용하여 프로그램을 설정하고 하나 이상의 환경을 구축했으면 프로덕션 파이프라인을 추가할 준비가 된 것입니다.

my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직과 프로그램을 선택합니다.
프로그램 개요 페이지에서 파이프라인 카드로 이동합니다.
+추가를 클릭하고 비프로덕션 파이프라인 추가를 선택합니다.

프로덕션 파이프라인 추가 대화 상자가 열리고 구성 탭이 나타나며, 이곳에서 파이프라인에 대한 여러 옵션을 정의해야 합니다. 이러한 옵션은 접을 수 있는 섹션으로 그룹화되며 다음 단계에서 설명합니다.

파이프라인 이름 필드에 파이프라인에 대한 설명적인 이름을 입력합니다.

환경 섹션에서 배포를 트리거하는 항목과 배포 환경별로 배포하는 방법을 정의합니다.

스테이지 섹션에서 파이프라인이 스테이징 환경으로 롤아웃되는 방법을 정의할 수 있습니다.

배포 트리거 - 다음과 같은 옵션을 사용하여 배포 트리거를 정의하여 파이프라인을 시작할 수 있습니다.
- 수동 - Cloud Manager UI를 사용하여 수동으로 파이프라인을 시작합니다.
- Git 변경 시 - 구성된 Git 분기에 커밋이 추가될 때마다 CI/CD 파이프라인을 시작합니다. 이 옵션을 사용하면 필요에 따라 파이프라인을 수동으로 시작할 수 있습니다.
중요한 지표 장애 비헤이비어 - 파이프라인 설정 또는 편집 중에 배포 관리자는 품질 게이트에서 중요한 장애가 발생했을 때 파이프라인의 비헤이비어를 정의할 수 있는 옵션을 제공합니다. 사용 가능한 옵션은 다음과 같습니다.
- 매번 묻기 - 이 설정은 기본 설정이며 중요한 장애에 대해 수동 개입이 필요합니다.
- 즉시 실패 - 중요한 오류가 발생할 때마다 파이프라인이 취소됩니다. 이는 각 실패를 수동으로 거부하는 사용자를 에뮬레이션하는 것입니다.
- 즉시 계속 - 중요한 오류가 발생할 때마다 파이프라인이 자동으로 계속됩니다. 이는 각 실패를 수동으로 승인하는 사용자를 에뮬레이션하는 것입니다.

배포 트리거

배포 옵션 - 특정 배포 작업을 가속화할 수 있습니다.
- 단계 배포 후 승인 - 이 승인은 스테이징 환경으로 배포한 후 테스트가 수행되기 전에 발생합니다. 그렇지 않으면 모든 테스트가 완료된 후 수행되는 프로덕션 배포 전에 승인이 발생합니다.
- 로드 밸런서 변경 건너뛰기 - 로드 밸런서는 변경되지 않습니다.

스테이징 배포 옵션

Dispatcher 구성 - 배포 관리자 역할은 파이프라인이 실행될 때 AEM Dispatcher 캐시에서 무효화되거나 플러시되는 콘텐츠 경로 집합을 구성할 수 있습니다. 이러한 캐시 액션은 콘텐츠 패키지가 배포된 직후에 배포 파이프라인 단계의 일부로 수행됩니다. 이러한 설정은 표준 AEM Dispatcher 비헤이비어를 사용합니다. 구성하려면 다음 작업을 수행합니다.
1. 경로 아래에 콘텐츠 경로를 제공합니다.
2. 유형 아래에서 해당 경로에 대해 수행할 액션을 선택합니다.
  - 플러시 - 캐시 삭제를 수행합니다.
  - 무효화 - 저작 인스턴스에서 게시 인스턴스로 콘텐츠가 활성화된 경우와 유사하게 캐시 무효화를 수행합니다.
3. 경로 추가를 클릭하여 지정된 경로를 추가합니다. 환경당 최대 100개의 경로를 추가할 수 있습니다.

Dispatcher 구성

note tip
TIP
일반적으로 무효화 동작의 사용이 바람직하지만 특히 AEM HTML 클라이언트 라이브러리를 사용할 때 플러싱이 필요한 경우가 있을 수 있습니다.

프로덕션 섹션에서 파이프라인이 프로덕션 환경으로 롤아웃되는 방법을 정의할 수 있습니다.

배포 옵션 - 프로덕션 배포를 제어하는 매개변수를 정의할 수 있습니다.

실행 승인 사용 - Cloud Manager UI를 통해 비즈니스 소유자, 프로젝트 관리자 또는 배포 관리자 역할을 가진 사용자가 배포를 수동으로 승인해야 합니다.
예약됨 - 프로덕션 배포 전에 파이프라인을 중지하여 예약되도록 합니다. 이 옵션을 선택하면 스테이징 환경으로 배포한 후 파이프라인이 중지되고 사용자에게 수행할 액션을 묻는 메시지가 표시됩니다.
- Now - 즉시 프로덕션에 배포되어 파이프라인을 효과적으로 완료합니다.
- 날짜 - 배포를 완료해야 하는 시간을 예약할 수 있습니다.
- 실행 중지 - 프로덕션으로의 배포를 중단합니다.

note tip
TIP
배포 일정을 설정하거나 파이프라인을 즉시 실행하는 방법은 코드 배포를 참조하십시오.

CSE 감독 사용 - 이 옵션을 선택하면 CSE(고객 성공 엔지니어)가 실제 배포를 시작하는 데 사용됩니다. 이 옵션을 활성화할 때 파이프라인을 생성하거나 편집할 때 Deployment Manager 역할에는 다음과 같은 옵션이 있습니다.
- 모든 CSE - 사용 가능한 CSE가 배포를 시작할 수 있습니다.
- 내 CSE - 고객에게 할당된 특정 CSE만 배포를 시작할 수 있습니다. 이 옵션은 할당된 CSE를 사용할 수 없는 경우 CSE의 지정된 백업에도 적용됩니다.

프로덕션 배포 옵션

Dispatcher 구성 - 프로덕션 환경에 대한 Dispatcher 구성을 정의합니다. 이 옵션은 스테이징 환경에 대한 옵션과 동일합니다.

소스 리포지토리를 배포하고 구성할 코드 유형을 선택하는 Source 코드 탭으로 이동하려면 계속을 클릭합니다.
1. 배포할 코드 선택에서 배포 유형을 선택합니다.
  - 전체 스택 코드 - 전체 AEM 응용 프로그램의 코드입니다.
  - 웹 계층 구성 - 웹 페이지를 저장하고 처리하고 클라이언트에 전달하는 Dispatcher 속성입니다.
  이러한 배포 유형에 대한 자세한 내용은 CI/CD 파이프라인을 참조하십시오. 파이프라인 구성을 완료하는 나머지 단계는 선택한 유형에 따라 다릅니다. 위의 링크를 따라 이 문서의 관련 섹션으로 이동하십시오.

라이선스가 부여된 제품에 따라 AEM Sites 및 AEM Assets 성능 테스트를 구성할 수 있는 단계 테스트 탭으로 이동하려면 계속을 클릭합니다.

note tip
TIP
단계 테스트 탭에서 사용할 수 있는 옵션에 대한 자세한 내용은 코드 품질 테스트를 참조하십시오.

사이트 콘텐츠 게재/배포된 로드 가중치 섹션에서는 3개의 페이지 세트 중 페이지 요청의 가중치를 기준으로 사이트 성과 테스트를 구성합니다. 필요에 따라 페이지 세트를 활성화하거나 비활성화할 수 있습니다.
- 방문 빈도가 높은 라이브 페이지
- 기타 라이브 페이지
- 새 페이지
자산 성능 테스트 배포 섹션에서 이미지 및 PDF의 테스트 배포를 정의하고 자체 테스트 자산을 정의합니다.
- 이미지 - 슬라이더를 조정하여 이미지와 PDF 사이의 테스트 분할을 조정합니다.
- PDF - 슬라이더를 조정하여 이미지와 PDF 사이의 테스트 분할을 조정합니다.
- 업로드하여 사용자 정의 자산을 정의합니다.
  1. 포맷 - 사용자 정의 자산이 이미지의 PDF인지 여부를 선택합니다.
  2. 파일 이름 - 파일 브라우저 버튼을 사용하여 로컬 컴퓨터에서 이미지를 선택합니다.
  3. 테스트 파일 추가 - 선택한 자산을 업로드하려면 클릭합니다.

저장을 클릭하여 프로덕션 파이프라인 추가를 완료합니다.

전체 스택 코드 full-stack-code

전체 스택 코드 파이프라인은 HTTPD/Dispatcher 구성과 함께 백엔드 및 프론트엔드 코드 빌드를 배포합니다.

NOTE

전체 스택 프로덕션 파이프라인이 이미 있는 경우 이 선택이 비활성화됩니다.

전체 스택 코드 프로덕션 파이프라인을 구성하려면:

Source 코드 탭에서 다음 옵션을 정의합니다.

저장소 - 파이프라인에서 코드를 검색해야 하는 Git 저장소를 정의합니다.

note tip
TIP
Cloud Manager에서 저장소를 추가하고 관리하는 방법은 프로그램 설정 문서를 참조하십시오.

Git 분기 - 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
웹 계층 구성 무시 - 이 옵션을 선택하면 파이프라인이 웹 계층 구성을 배포하지 않습니다. 동일한 환경에 대한 웹 계층 구성 파이프라인이 이미 있는 경우 웹 계층 구성은 해당 파이프라인에서 관리되므로 이 확인란이 자동으로 선택되고 비활성화됩니다. 웹 계층 구성 파이프라인이 존재하지 않는 경우 이 옵션을 선택하거나 선택 취소하여 전체 스택 파이프라인이 Dispatcher 구성을 배포하는지 여부를 제어할 수 있습니다.

전체 스택 코드 원본

계속을 클릭하여 단계 테스트 탭으로 이동합니다. 자세한 내용은 스테이지 테스트를 참조하십시오.

웹 계층 구성 web-tier-config

웹 계층 구성 파이프라인은 HTTPD/Dispatcher 구성만 배포합니다. 이 파이프라인 유형에 대한 자세한 내용은 CI/CD 파이프라인을 참조하십시오.

NOTE

웹 계층 구성 프로덕션 파이프라인이 이미 있는 경우 이 선택이 비활성화됩니다.

기존 전체 스택 파이프라인이 있는 환경에 대한 웹 계층 구성 파이프라인을 만드는 경우 전체 스택 파이프라인의 웹 계층 구성이 무시됩니다. 이 변경 사항은 해당 환경의 웹 계층 구성에만 영향을 줍니다.

웹 계층 구성 프로덕션 파이프라인을 구성하려면:

Source 코드 탭에서 다음 옵션을 정의합니다.

저장소 - 드롭다운 목록에서 웹 계층 구성이 포함된 Git 저장소를 선택합니다.
Git 분기 - 선택한 저장소에서 Cloud Manager이 배포에 사용하는 분기를 선택합니다.
코드 위치 - 배포할 웹 계층 구성이 포함된 선택한 저장소의 경로를 입력하십시오. 기본 위치는 저장소 루트(/)입니다.

note
NOTE
코드 위치가 Dispatcher 코드 위치를 가리키지 않는 경우 추가 애플리케이션 코드를 아티팩트 패키지로 가져와 Dispatcher에 배포할 수 있으므로 재시작 시 Apache가 실패하고 파이프라인이 실패합니다. 저장소의 Dispatcher 파일에 대한 올바른 경로를 설정해야 합니다.

웹 계층 구성 원본

계속을 클릭하여 단계 테스트 탭으로 이동합니다. 자세한 내용은 스테이지 테스트를 참조하십시오.

프로덕션 파이프라인에서의 Smart Build 사용 정보 about-smart-build

Cloud Manager의 스마트 빌드는 프로덕션 파이프라인에 최적화된 빌드 전략입니다. 스마트 빌드는 모듈을 캐시하고 마지막으로 성공한 실행 이후 변경된 모듈만 다시 빌드하여 빌드 시간을 줄입니다. 변경되지 않은 모듈은 캐시에서 재사용되는 반면 수정된 모듈 및 그 의존성만 재구축되므로 반복적인 개발 워크플로의 효율성을 향상시킵니다.

스마트 빌드는 현재 다음에 사용할 수 있습니다.

코드 품질 파이프라인.
개발, 스테이징 및 프로덕션 전체 스택 배포 파이프라인.

NOTE

Smart Build를 활성화한 후 첫 번째 실행은 캐시가 비어 있으므로 전체 빌드와 같이 작동합니다.

다음과 같은 경우에는 스마트 빌드를 사용하는 것이 좋습니다.

빈번한 증분 변경을 적극적으로 개발하고 커밋하고 있습니다.
프로젝트에 여러 Maven 모듈이 포함되어 있습니다.
전체 빌드는 시간이 오래 걸립니다.

다음과 같은 경우에는 스마트 빌드가 항상 이상적이지 않습니다.

빌드는 Maven의 종속성 그래프 외부에서 작업을 수행하는 플러그인에 크게 의존합니다.
모든 실행 시 전체 재구축 유효성 검사가 필요합니다.

빌드 성능 이해 smart-build-performance

Smart Build를 사용하여 얻을 수 있는 성능 이익은 다음을 포함한 몇 가지 요인에 따라 달라집니다.

프로젝트의 모듈 수입니다.
코드 변경 빈도 및 범위입니다.
모듈 간 종속성 분포.

일반적으로 많은 독립 모듈이 있는 프로젝트는 가장 큰 개선 효과를 볼 수 있습니다.

모듈별 캐시 옵트아웃 smart-build-cache-optout

Smart Build에서는 특정 모듈에 대한 캐싱을 비활성화할 수 있는 세분화된 제어를 제공합니다. 이 기능은 특정 모듈이 다음과 같은 경우 유용합니다.

exec-maven-plugin 또는 maven-antrun-plugin과(와) 같은 플러그인을 사용합니다.
Maven 종속성으로 추적되지 않는 파일 작업을 수행합니다.
캐시될 때 일관되지 않은 결과를 생성합니다.

모듈에 대한 캐싱 비활성화 smart-build-disable-caching

영향을 받는 모듈의 pom.xml에 다음 속성을 추가할 수 있습니다.

<properties>
  <maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>

이 구문은 모듈이 모든 파이프라인 실행에 대해 다시 빌드되도록 하는 반면 다른 모듈은 캐싱의 이점을 계속 사용합니다.

Smart Build 사용 시 제한 사항 및 고려 사항 smart-build-limitations

Smart Build를 사용할 때는 다음 사항에 유의하십시오.

Smart Build는 Maven 종속성 분석을 사용합니다.
종속성 그래프 외부의 변경 사항은 재빌드를 트리거하지 않을 수 있습니다.
일부 플러그인은 캐싱과 완전히 호환되지 않을 수 있습니다.
비프로덕션 파이프라인을 편집하여 언제든지 전체 빌드(으)로 다시 전환할 수 있습니다.

예기치 않은 빌드 동작이 발생하면 특정 모듈에 대해 캐싱을 사용하지 않도록 설정하거나 빌드 전략을 전체 빌드(으)로 일시적으로 전환해 보십시오.

스마트 빌드 문제 해결 smart-build-troubleshoot

문제

제안된 해결 방법

빌드 결과가 일관되지 않음

· 영향을 받는 모듈에 대한 캐싱을 비활성화합니다.
· 플러그 인 동작(특히 exec/antrun 플러그 인)을 확인합니다.

성능 향상 없음

· 여러 번 실행되었는지 확인합니다(캐시 준비).
· 대부분의 모듈이 자주 변경되는지 확인합니다.

예기치 않은 아티팩트 또는 누락된 변경 사항

· 변경 내용이 Maven 종속성 추적을 벗어나는지 확인하십시오.
· 확인에는 전체 빌드를 사용하십시오.

스마트 빌드를 사용하려면 프로덕션 파이프라인 추가를 참조하십시오.

다음 단계 the-next-steps

파이프라인을 구성한 후 코드를 배포해야 합니다. 자세한 내용은 코드 배포를 참조하십시오.

비디오 튜토리얼 video-tutorial-one

이 비디오에서는 이 문서에 자세히 설명된 파이프라인 생성 프로세스에 대한 개요를 제공합니다.

https://video.tv.adobe.com/v/327606?captions=kor&learn=on

recommendation-more-help

experience-manager-cloud-manager-help-main-toc