프로덕션 파이프라인 구성

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

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

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

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

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

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

2. 프로그램 개요 페이지에서 파이프라인 카드로 이동하고 추가​를 클릭하고 프로덕션 파이프라인 추가​를 선택합니다.

   

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

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

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

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

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

   

4. 소스 코드 탭에서 파이프라인이 코드를 검색해야 하는 위치와 코드 유형을 정의해야 합니다.

   • 프론트엔드 코드
   • 전체 스택 코드
   • 웹 계층 구성

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

프론트엔드 코드

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

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

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

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

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

   • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
     • 분기 이름의 처음 몇 글자를 입력하면 이 필드의 자동 완성 기능이 일치하는 분기를 찾아 선택하는 데 도움이 됩니다.
   • 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.
   • 프로덕션에 배포 전 일시 중지 - 이 옵션은 프로덕션에 배포하기 전에 파이프라인을 일시 중지합니다.

   

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

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

전체 스택 코드

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

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

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

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

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

   • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
     • 분기 이름의 처음 몇 글자를 입력하면 이 필드의 자동 완성 기능이 일치하는 분기를 찾아 선택하는 데 도움이 됩니다.
   • 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.
   • 프로덕션에 배포 전 일시 중지 - 이 옵션은 프로덕션에 배포하기 전에 파이프라인을 일시 중지합니다.
   • 예약됨 - 이 옵션을 사용하면 예약된 프로덕션 배포를 활성화할 수 있습니다.

   

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

   

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

   • 페이지 경로는 /로 시작해야 합니다.
   • 예를 들어 경험 감사에 https://wknd.site/us/en/about-us.html을 포함하려면 /us/en/about-us.html 경로를 입력합니다.

   

4. 페이지 추가​를 클릭하면 환경 주소를 사용하여 경로가 자동으로 완료되고 경로 테이블에 추가됩니다.

   

5. 필요에 따라 앞의 두 단계를 반복하여 경로를 계속 추가합니다.

   • 최대 25개의 경로를 추가할 수 있습니다.
   • 경로를 정의하지 않으면 기본적으로 사이트의 홈페이지가 경험 감사에 포함됩니다.

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

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

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

웹 계층 구성

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

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

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

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

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

   • Git 분기 - 이 옵션은 선택한 파이프라인에서 코드를 검색해야 하는 분기를 정의합니다.
     • 분기 이름의 처음 몇 글자를 입력하면 이 필드의 자동 완성 기능이 일치하는 분기를 찾아 선택하는 데 도움이 됩니다.
   • 코드 위치 - 이 옵션은 파이프라인이 코드를 검색해야 하는 선택한 저장소 분기의 경로를 정의합니다.
     • 웹 계층 구성 파이프라인의 경우 일반적으로 conf.d, conf.dispatcher.d 및 opt-in 디렉터리가 포함된 경로입니다.
     • 예를 들어 프로젝트 구조가 AEM Project Archetype에서 생성된 경우 경로는 /dispatcher/src입니다.
   • 프로덕션에 배포 전 일시 중지 - 이 옵션은 프로덕션에 배포하기 전에 파이프라인을 일시 중지합니다.
   • 예약됨 - 이 옵션을 사용하면 예약된 프로덕션 배포를 활성화할 수 있습니다.

   

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

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

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

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

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

Dispatcher 패키지 건너뛰기

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

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

<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>

Business.Adobe.com 리소스