설명서AEM as a Cloud Service사용 안내서

비프로덕션 파이프라인 구성 configuring-non-production-pipelines

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 개발자

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

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

비프로덕션 파이프라인 non-production-pipelines

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

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

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

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

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

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

  2. 내 프로그램 콘솔에서 프로그램을 선택합니다.

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

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

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

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

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

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

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

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

  6. 배포 파이프라인 ​을 만드는 경우, 중요 지표 실패 비헤이비어 ​도 정의해야 합니다.

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

  7. 계속 ​을 클릭합니다.

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

파이프라인 유형에 대한 자세한 내용은 CI/CD 파이프라인을 참조하십시오.

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

전체 스택 코드 full-stack-code

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

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

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

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

    • 적합한 배포 환경 - 파이프라인이 배포 파이프라인인 경우 배포할 환경을 선택해야 합니다.
    • 저장소 - 이 옵션은 파이프라인에서 코드를 검색해야 하는 git 저장소를 정의합니다.
    note tip
    TIP
    Cloud Manager에서 저장소를 추가하고 관리하는 방법은 저장소 추가 및 관리를 참조하십시오.

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

      • 분기 이름의 처음 몇 글자와 이 필드의 자동 완성 기능을 입력합니다. 선택할 수 있는 일치하는 분기를 찾는 데 유용합니다.

    • 웹 계층 구성 무시 - 이 옵션을 선택하면 파이프라인이 웹 계층 구성을 배포하지 않습니다.

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

    전체 스택 파이프라인

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

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

대상 배포 targeted-deployment

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

  • 구성 - AEM 환경의 다양한 기능에 대한 설정을 구성합니다.

    • 로그 전달, 제거 관련 유지 관리 작업 및 다양한 CDN 구성을 포함하여 지원되는 구성 목록을 보고 저장소에서 이를 관리하여 올바르게 배포하려면 구성 파이프라인 사용 문서를 참조하십시오.
    • 타깃팅된 배포 파이프라인을 실행할 때 구성이 파이프라인에 정의된 환경, 저장소 및 분기에 저장되면 배포됩니다.
    • 언제든지 환경당 하나의 구성 파이프라인만 있을 수 있습니다.

  • 프론트엔드 코드 - AEM 애플리케이션의 프론트엔드에 맞게 JavaScript 및 CSS를 구성합니다.

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

  • 웹 계층 구성 - 웹 페이지를 저장, 처리 및 클라이언트에 전달하도록 Dispatcher 속성을 구성합니다.

    • 자세한 내용은 CI/CD 파이프라인 문서를 참조하십시오.
    • 선택한 환경에 대한 웹 계층 코드 파이프라인이 있는 경우, 이 선택이 비활성화됩니다.
    • 기존 전체 스택 파이프라인이 환경에 배포되어 있는 경우 동일한 환경에 대한 웹 계층 구성 파이프라인을 생성하면 전체 스택 파이프라인의 기존 웹 계층 구성이 무시됩니다.
NOTE
웹 계층 및 구성 파이프라인은 비공개 저장소에서 지원되지 않습니다. 자세한 내용과 제한 사항 전체 목록은 Cloud Manager에서 비공개 저장소 추가 문서를 참조하십시오.

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

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

타깃팅된 배포 옵션

  1. 적합한 배포 환경 ​을(를) 정의합니다.

    • 파이프라인이 배포 파이프라인인 경우 배포할 환경을 선택해야 합니다.

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

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

    파이프라인 구성

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

    • 경험 감사 ​를 사용하도록 설정한 경우 구성 방법에 대한 자세한 내용은 경험 감사 문서를 참조하십시오.
    • 그렇지 않은 경우 이 단계를 건너뜁니다.

  4. 저장 ​을 탭하거나 클릭하여 파이프라인을 저장합니다.

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

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