비프로덕션 파이프라인 구성

프로덕션 환경에 배포하기 전에 비프로덕션 파이프라인을 구성하여 코드 품질을 테스트하는 방법을 알아봅니다.

비프로덕션 파이프라인

스테이지 및 프로덕션 환경에 배포하는 프로덕션 파이프라인 외에 비프로덕션 파이프라인을 설정하여 코드를 검증할 수도 있습니다.

비프로덕션 파이프라인에는 두 가지 유형이 있습니다.

코드 품질 파이프라인 - git 분기의 코드에 대해 코드 품질 스캔을 실행하고 빌드 및 코드 품질 단계를 실행합니다.
배포 파이프라인 - 이러한 파이프라인은 코드 품질 파이프라인과 같은 빌드 및 코드 품질 단계를 실행하는 것 외에도 코드를 비프로덕션 환경에 배포합니다.

노트

초기 설정 후에 파이프라인 설정을 편집할 수 있습니다.

새 비프로덕션 파이프라인 추가

프로그램을 설정하고 Cloud Manager UI를 사용하는 환경이 하나 이상 있는 경우 다음 단계에 따라 비프로덕션 파이프라인을 추가할 준비가 된 것입니다.

my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직과 프로그램을 선택합니다.
Cloud Manager 홈 화면에서 파이프라인 카드에 액세스합니다. +추가를 클릭하고 비프로덕션 파이프라인 추가를 선택합니다.
비프로덕션 파이프라인 추가 대화 상자의 구성 탭에서 추가할 비프로덕션 파이프라인 유형을 선택합니다.
- 코드 품질 파이프라인 - 코드를 빌드하고, 단위 테스트를 실행하고, 코드 품질을 평가하지만 배포하지는 않는 파이프라인을 만듭니다.
- 배포 파이프라인 - 코드를 빌드하고, 단위 테스트를 실행하고, 코드 품질을 평가하고, 환경에 배포하는 파이프라인을 만듭니다.
파이프라인을 식별할 수 있도록 다음 추가 정보와 함께 비프로덕션 파이프라인 이름을 입력합니다.
- 배포 트리거 - 다음과 같은 옵션을 사용하여 배포 트리거를 정의하여 파이프라인을 시작할 수 있습니다.
  - 수동 - 파이프라인을 수동으로 시작하려면 이 옵션을 사용합니다.
  - Git 변경 시 - 이 옵션은 구성된 git 분기에 커밋이 추가될 때마다 CI/CD 파이프라인을 시작합니다. 이 옵션을 사용하면 필요에 따라 파이프라인을 수동으로 시작할 수 있습니다.
배포 파이프라인을 만드는 경우, 중요 지표 실패 비헤이비어도 정의해야 합니다.
- 매번 묻기 - 이 비헤이비어는 기본 설정이며 중요한 장애에 대해 수동 개입이 필요합니다.
- 즉시 실패 - 이 옵션을 선택하면 중요한 오류가 발생할 때마다 파이프라인이 취소됩니다. 이는 본질적으로 각 실패를 수동으로 거부하는 사용자를 에뮬레이션하는 것입니다.
- 즉시 계속 - 이 옵션을 선택하면 중요한 오류가 발생할 때마다 파이프라인이 자동으로 계속됩니다. 이는 본질적으로 각 실패를 수동으로 승인하는 사용자를 에뮬레이션하는 것입니다.
계속을 클릭합니다.
비프로덕션 파이프라인 추가 대화 상자의 소스 코드 탭에서 파이프라인이 처리해야 하는 코드 유형을 선택해야 합니다.
- 프론트엔드 코드
- 전체 스택 코드
- 웹 계층 구성

비프로덕션 파이프라인 생성을 완료하는 단계는 선택한 소스 코드 옵션에 따라 다릅니다. 파이프라인 구성을 완료할 수 있도록 위의 링크를 따라 이 문서의 다음 섹션으로 이동합니다.

프론트엔드 코드

프론트엔드 코드 파이프라인은 하나 이상의 클라이언트측 UI 애플리케이션을 포함하는 프론트엔드 코드 빌드를 배포합니다. 이 파이프라인 유형에 대한 자세한 내용은 CI/CD 파이프라인 문서를 참조하십시오.

프론트엔드 코드 비프로덕션 파이프라인의 구성을 완료하려면 다음 단계를 따릅니다.

소스 코드 탭에서 다음 옵션을 정의해야 합니다.
- 적합한 배포 환경 - 파이프라인이 배포 파이프라인인 경우 배포할 환경을 선택해야 합니다.
- 저장소 - 이 옵션은 파이프라인에서 코드를 검색해야 하는 git 저장소를 정의합니다.
팁

Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.
- Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
  - 분기 이름의 처음 몇 글자와 이 필드의 자동 완성 기능을 입력합니다. 선택할 수 있는 일치하는 분기를 찾습니다.
- 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.
저장을 클릭합니다.

파이프라인이 저장되고 이제 프로그램 개요 페이지의 파이프라인 카드에서 파이프라인을 관리할 수 있습니다.

전체 스택 코드

전체 스택 코드 파이프라인은 HTTPD/Dispatcher 구성과 함께 하나 이상의 AEM 서버 애플리케이션을 포함하는 백엔드 및 프론트엔드 코드 빌드를 동시에 배포합니다. 이 파이프라인 유형에 대한 자세한 내용은 CI/CD 파이프라인 문서를 참조하십시오.

노트

선택한 환경에 대한 전체 스택 코드 파이프라인이 있는 경우, 이 선택이 비활성화됩니다.

전체 스택 코드 비프로덕션 파이프라인의 구성을 완료하려면 다음 단계를 따릅니다.

소스 코드 탭에서 다음 옵션을 정의해야 합니다.
- 적합한 배포 환경 - 파이프라인이 배포 파이프라인인 경우 배포할 환경을 선택해야 합니다.
- 저장소 - 이 옵션은 파이프라인에서 코드를 검색해야 하는 git 저장소를 정의합니다.
팁

Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.
- Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
  - 분기 이름의 처음 몇 글자와 이 필드의 자동 완성 기능을 입력합니다. 선택할 수 있는 일치하는 분기를 찾는 데 유용합니다.
- 웹 계층 구성 무시 - 이 옵션을 선택하면 파이프라인이 웹 계층 구성을 배포하지 않습니다.
- 파이프라인 - 파이프라인이 배포 파이프라인인 경우 테스트 단계를 실행하도록 할 수 있습니다. 이 단계에서 활성화하려는 옵션을 확인합니다. 옵션을 선택하지 않으면 파이프라인 실행 중에 테스트 단계가 표시되지 않습니다.
  - 제품 기능 테스트 - 개발 환경에 대해 제품 기능 테스트를 실행합니다.
  - 사용자 정의 기능 테스트 - 개발 환경에 대해 사용자 정의 기능 테스트를 실행합니다.
  - 사용자 정의 UI 테스트 - 사용자 정의 애플리케이션에 대한 사용자 정의 UI 테스트를 실행합니다.
저장을 클릭합니다.

파이프라인이 저장되고 이제 프로그램 개요 페이지의 파이프라인 카드에서 파이프라인을 관리할 수 있습니다.

웹 계층 구성

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

노트

선택한 환경에 대한 웹 계층 코드 파이프라인이 있는 경우, 이 선택이 비활성화됩니다.

웹 계층 코드 비프로덕션 파이프라인의 구성을 완료하려면 다음 단계를 따릅니다.

소스 코드 탭에서 다음 옵션을 정의해야 합니다.
- 적합한 배포 환경 - 파이프라인이 배포 파이프라인인 경우 배포할 환경을 선택해야 합니다.
- 저장소 - 이 옵션은 파이프라인에서 코드를 검색해야 하는 git 저장소를 정의합니다.
팁

Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.
- Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
- 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.
  - 웹 계층 구성 파이프라인의 경우, 이 경로는 일반적으로 conf.d, conf.dispatcher.d 및 opt-in 디렉터리를 포함합니다.
  - 예를 들어 프로젝트 구조가 AEM Project Archetype에서 생성된 경우 경로는 /dispatcher/src입니다.
저장을 클릭합니다.

노트

기존 전체 스택 파이프라인이 환경에 배포되어 있는 경우 동일한 환경에 대한 웹 계층 구성 파이프라인을 생성하면 전체 스택 파이프라인의 기존 웹 계층 구성이 무시됩니다.

파이프라인이 저장되고 이제 프로그램 개요 페이지의 파이프라인 카드에서 파이프라인을 관리할 수 있습니다.

프론트엔드 파이프라인으로 Sites 개발

프론트엔드 파이프라인을 사용하면 프론트엔드 개발자에게 더 많은 독립성을 부여하고 개발 프로세스를 가속화할 수 있습니다.

이 프로세스의 잠재력을 최대한 활용하기 위해 알아야 할 몇 가지 고려 사항 및 이 프로세스가 작동하는 방식에 대한 자세한 내용은 프론트엔드 파이프라인으로 Sites 개발 문서를 참조하십시오.

Dispatcher 패키지 건너뛰기

Dispatcher 패키지를 파이프라인의 일부로 빌드하고 싶지만 스토리지를 빌드하기 위해 게시하지 않으려는 경우, 게시를 비활성화하면 파이프라인 실행 기간이 단축될 수 있습니다.

Dispatcher 패키지 게시를 비활성화하려면 프로젝트 pom.xml 파일을 통해 다음 구성을 추가해야 합니다. 이는 환경 변수를 기반으로 하며, Cloud Manager 빌드 컨테이너에서 Dispatcher 패키지를 무시해야 하는 시기를 정의할 때 설정할 수 있는 플래그 역할을 합니다.

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>

비프로덕션 파이프라인 구성