프로덕션 파이프라인 구성 configure-production-pipeline

코드를 빌드하고 프로덕션 환경에 배포하기 위해 프로덕션 파이프라인을 구성하는 방법을 알아봅니다. 프로덕션 파이프라인은 먼저 코드를 스테이징 환경에 배포하고 승인 시 동일한 코드를 프로덕션 환경에 배포합니다.

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

NOTE
프로그램 생성이 완료되고 git 저장소에 분기가 하나 이상 있으며 프로덕션 및 스테이징 환경 세트가 생성될 때까지 프로덕션 파이프라인을 설정할 수 없습니다.

코드 배포를 시작하기 전에 Cloud Manager에서 파이프라인 설정을 구성해야 합니다.

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

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

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

TIP
프론트엔드 파이프라인을 구성하기 전에 AEM 빠른 사이트 생성 여정에서 사용하기 쉬운 AEM 빠른 사이트 생성 도구에 대한 안내서를 참조하십시오. 이 여정을 통해 AEM Site의 프론트엔드 개발을 간소화하여 백엔드 AEM에 대한 백엔드 지식 없이 사이트를 빠르게 사용자 정의할 수 있습니다.
  1. 에서 Cloud Manager에 로그인합니다. my.cloudmanager.adobe.com 적절한 조직 선택

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

  3. 다음 위치로 이동 파이프라인 다음에서 카드 프로그램 개요 페이지 및 클릭 추가 선택 프로덕션 파이프라인 추가.

    프로그램 관리자의 파이프라인 카드 개요

  4. 프로덕션 파이프라인 추가 대화 상자가 표시됩니다. 파이프라인을 식별할 수 있도록 다음 옵션과 함께 파이프라인 이름 ​을 입력합니다. 계속 ​을 클릭합니다.

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

    • 수동 - 파이프라인을 수동으로 시작하려면 이 옵션을 사용합니다.
    • Git 변경 시 - 이 옵션은 구성된 git 분기에 커밋이 추가될 때마다 CI/CD 파이프라인을 시작합니다. 이 옵션을 사용하면 필요에 따라 파이프라인을 수동으로 시작할 수 있습니다.

    중요한 지표 장애 비헤이비어 - 파이프라인 설정 또는 편집 중에 배포 관리자 ​는 품질 게이트에서 중요한 장애가 발생했을 때 파이프라인의 비헤이비어를 정의할 수 있는 옵션을 제공합니다. 사용 가능한 옵션은 다음과 같습니다.

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

    프로덕션 파이프라인 구성

  5. 다음에서 소스 코드 탭 파이프라인에서 처리할 코드 유형을 선택해야 합니다.

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

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

전체 스택 코드 full-stack-code

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

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

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

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

    • 저장소 - 이 옵션은 파이프라인에서 코드를 검색해야 하는 git 저장소를 정의합니다.
    note tip
    TIP
    Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리 문서를 참조하십시오.
    • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
      • 분기 이름의 처음 몇 글자를 입력하면 이 필드의 자동 완성 기능이 일치하는 분기를 찾아 선택하는 데 도움이 됩니다.
    • 웹 계층 구성 무시 - 이 옵션을 선택하면 파이프라인이 웹 계층 구성을 배포하지 않습니다.
    • 프로덕션에 배포 전 일시 중지 - 이 옵션은 프로덕션에 배포하기 전에 파이프라인을 일시 중지합니다.
    • 예약됨 - 이 옵션을 사용하면 예약된 프로덕션 배포를 활성화할 수 있습니다.

    전체 스택 코드

  2. 탭 또는 클릭 계속 로 이동 경험 감사 경험 감사에 항상 포함되어야 하는 경로를 정의할 수 있는 탭입니다.

    경험 감사 추가

  3. 경험 감사에 포함될 경로를 제공합니다.

  4. 파이프라인을 저장하려면 저장 ​을 클릭합니다.

경험 감사를 위해 구성된 경로는 파이프라인이 실행될 때 성능, 접근성, SEO(검색 엔진 최적화), 모범 사례 및 PWA(점진적 웹 앱) 테스트에 따라 서비스에 제출되고 평가됩니다. 자세한 내용은 경험 감사 결과 이해를 참조하십시오.

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

대상 배포 targeted-deployment

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

  • 구성 - AEM 환경에서 트래픽 필터 규칙에 대한 설정을 구성합니다.

    • 문서 보기 WAF 규칙을 포함한 트래픽 필터 규칙 저장소 구성을 관리하여 올바로 배포하는 방법에 대해 알아봅니다.
    • 타깃팅된 배포 파이프라인을 실행할 때 WAF 구성 파이프라인에서 정의한 환경, 저장소 및 분기에 저장된 경우 배포됩니다.
    • 언제든지 환경당 하나의 구성 파이프라인만 있을 수 있습니다.
  • 프론트엔드 코드 - AEM 애플리케이션의 프런트 엔드에 대한 JavaScript 및 CSS를 구성합니다.

    • 프론트엔드 파이프라인을 사용하면 프론트엔드 개발자에게 더 많은 독립성을 부여하고 개발 프로세스를 가속화할 수 있습니다.
    • 이 프로세스의 잠재력을 최대한 활용하기 위해 알아야 할 몇 가지 고려 사항 및 이 프로세스가 작동하는 방식에 대한 자세한 내용은 프론트엔드 파이프라인으로 Sites 개발 문서를 참조하십시오.
  • 웹 계층 구성 - 웹 페이지를 저장, 처리 및 클라이언트에 전달하도록 Dispatcher 속성을 구성합니다.

    • 문서 보기 CI/CD 파이프라인 을 참조하십시오.
    • 선택한 환경에 대한 웹 계층 코드 파이프라인이 있는 경우, 이 선택이 비활성화됩니다.
    • 기존 전체 스택 파이프라인이 환경에 배포되어 있는 경우 동일한 환경에 대한 웹 계층 구성 파이프라인을 생성하면 전체 스택 파이프라인의 기존 웹 계층 구성이 무시됩니다.

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

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

타깃팅된 배포 옵션

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

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

    • 저장소 - 이 옵션은 파이프라인에서 코드를 검색해야 하는 git 저장소를 정의합니다.
    note tip
    TIP
    Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.
    • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
      • 분기 이름의 처음 몇 글자와 이 필드의 자동 완성 기능을 입력합니다. 선택할 수 있는 일치하는 분기를 찾습니다.
    • 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.
    • 프로덕션에 배포 전 일시 중지 - 이 옵션은 프로덕션에 배포하기 전에 파이프라인을 일시 중지합니다.
    • 예약됨 - 이 옵션을 사용하면 예약된 프로덕션 배포를 활성화할 수 있습니다. 웹 계층 대상 배포에만 사용할 수 있습니다.

    파이프라인 구성

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

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

Dispatcher 패키지 건너뛰기 skip-dispatcher-packages

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>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab