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

마지막 업데이트: 2024-01-25

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

사용자에게 다음이 있어야 합니다. 배포 관리자 비프로덕션 파이프라인을 구성하는 역할입니다.

비프로덕션 파이프라인

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

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

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

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

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

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

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

다음에서 내 프로그램 화면에서 프로그램을 선택합니다.

  1. Cloud Manager 홈 화면에서 파이프라인 카드에 액세스합니다. +추가​를 클릭하고 비프로덕션 파이프라인 추가​를 선택합니다.

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

  2. 비프로덕션 파이프라인 추가 대화 상자의 구성 탭에서 추가할 비프로덕션 파이프라인 유형을 선택합니다.

    • 코드 품질 파이프라인 - 코드를 빌드하고, 단위 테스트를 실행하고, 코드 품질을 평가하지만 배포하지는 않는 파이프라인을 만듭니다.
    • 배포 파이프라인 - 코드를 빌드하고, 단위 테스트를 실행하고, 코드 품질을 평가하고, 환경에 배포하는 파이프라인을 만듭니다.

    비프로덕션 파이프라인 추가 대화 상자

  3. 파이프라인을 식별할 수 있도록 다음 추가 정보와 함께 비프로덕션 파이프라인 이름​을 입력합니다.

    • 배포 트리거 - 다음과 같은 옵션을 사용하여 배포 트리거를 정의하여 파이프라인을 시작할 수 있습니다.

      • 수동 - 파이프라인을 수동으로 시작하려면 이 옵션을 사용합니다.
      • Git 변경 시 - 이 옵션은 구성된 git 분기에 커밋이 추가될 때마다 CI/CD 파이프라인을 시작합니다. 이 옵션을 사용하면 필요에 따라 파이프라인을 수동으로 시작할 수 있습니다.
  4. 배포 파이프라인​을 만드는 경우, 중요 지표 실패 비헤이비어​도 정의해야 합니다.

    • 매번 묻기 - 이 비헤이비어는 기본 설정이며 중요한 장애에 대해 수동 개입이 필요합니다.
    • 즉시 실패 - 이 옵션을 선택하면 중요한 오류가 발생할 때마다 파이프라인이 취소됩니다. 이는 본질적으로 각 실패를 수동으로 거부하는 사용자를 에뮬레이션하는 것입니다.
    • 즉시 계속 - 이 옵션을 선택하면 중요한 오류가 발생할 때마다 파이프라인이 자동으로 계속됩니다. 이는 본질적으로 각 실패를 수동으로 승인하는 사용자를 에뮬레이션하는 것입니다.
  5. 계속​을 클릭합니다.

  6. 비프로덕션 파이프라인 추가 대화 상자의 소스 코드 탭에서 파이프라인이 처리해야 하는 코드 유형을 선택해야 합니다.

다음을 참조하십시오 CI/CD 파이프라인 파이프라인 유형에 대한 자세한 정보입니다.

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

전체 스택 코드

전체 스택 코드 파이프라인은 HTTPD/Dispatcher 구성과 함께 하나 이상의 AEM 서버 애플리케이션을 포함하는 백엔드 및 프론트엔드 코드 빌드를 동시에 배포합니다.

노트

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

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

  1. 소스 코드 탭에서 다음 옵션을 정의해야 합니다.

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

    Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.

    • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.

      • 분기 이름의 처음 몇 글자와 이 필드의 자동 완성 기능을 입력합니다. 선택할 수 있는 일치하는 분기를 찾는 데 유용합니다.
    • 웹 계층 구성 무시 - 이 옵션을 선택하면 파이프라인이 웹 계층 구성을 배포하지 않습니다.

    • 파이프라인 - 파이프라인이 배포 파이프라인인 경우 테스트 단계를 실행하도록 할 수 있습니다. 이 단계에서 활성화하려는 옵션을 확인합니다. 옵션을 선택하지 않으면 파이프라인 실행 중에 테스트 단계가 표시되지 않습니다.

    전체 스택 파이프라인

  2. 저장​을 클릭합니다.

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

타깃팅된 배포

타깃팅된 배포는 AEM 애플리케이션의 선택한 부분에 대해서만 코드를 배포합니다. 이러한 배포에서는 다음을 선택할 수 있습니다. 포함 다음 코드 유형 중 하나:

  • 구성 - AEM 환경에서 트래픽 필터 규칙에 대한 설정을 구성합니다.
    • 문서 보기 WAF 규칙을 포함한 트래픽 필터 규칙 저장소 내 트래픽 필터 규칙을 관리하여 올바르게 배포하는 방법에 대해 알아봅니다.
    • 타깃팅된 배포 파이프라인을 실행할 때 구성 WAF 구성 등 파이프라인에서 정의한 환경, 저장소 및 분기에 저장된 경우 배포됩니다.
    • 언제든지 환경당 하나의 구성 파이프라인만 있을 수 있습니다.
  • 프론트엔드 코드 - AEM 애플리케이션의 프런트 엔드에 대한 JavaScript 및 CSS를 구성합니다.
    • 프론트엔드 파이프라인을 사용하면 프론트엔드 개발자에게 더 많은 독립성을 부여하고 개발 프로세스를 가속화할 수 있습니다.
    • 이 프로세스의 잠재력을 최대한 활용하기 위해 알아야 할 몇 가지 고려 사항 및 이 프로세스가 작동하는 방식에 대한 자세한 내용은 프론트엔드 파이프라인으로 Sites 개발 문서를 참조하십시오.
  • 웹 계층 구성 - 웹 페이지를 저장, 처리 및 클라이언트에 전달하도록 Dispatcher 속성을 구성합니다.
    • 문서 보기 CI/CD 파이프라인 을 참조하십시오.
    • 선택한 환경에 대한 웹 계층 코드 파이프라인이 있는 경우, 이 선택이 비활성화됩니다.
    • 기존 전체 스택 파이프라인이 환경에 배포되어 있는 경우 동일한 환경에 대한 웹 계층 구성 파이프라인을 생성하면 전체 스택 파이프라인의 기존 웹 계층 구성이 무시됩니다.

배포 유형을 선택하면 비프로덕션 대상 배포 파이프라인의 생성을 완료하는 단계가 동일합니다.

  1. 필요한 배포 유형을 선택합니다.

타깃팅된 배포 옵션

  1. 다음을 정의합니다. 적합한 배포 환경.

    • 파이프라인이 배포 파이프라인인 경우 배포할 환경을 선택해야 합니다.
  2. 아래 소스 코드, 다음 옵션을 정의합니다.

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

    Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.

    • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
      • 분기 이름의 처음 몇 글자와 이 필드의 자동 완성 기능을 입력합니다. 선택할 수 있는 일치하는 분기를 찾습니다.
    • 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.

    파이프라인 구성

  3. 저장​을 클릭합니다.

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

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>

이 페이지에서는