빌드 환경

Cloud Manager의 빌드 환경과 코드 빌드 및 테스트 방법에 대해 알아봅니다.

빌드 환경 세부 정보

Cloud Manager는 특수 빌드 환경을 사용하여 코드를 빌드하고 테스트합니다.

  • 빌드 환경은 Linux 기반이며, Ubuntu 18.04에서 파생되었습니다.

  • Apache Maven 3.6.0이 설치되어 있습니다.

  • 설치된 Java 버전은 Oracle JDK 8u202 및 Oracle JDK 11.0.2입니다.

  • 기본적으로 JAVA_HOME 환경 변수는 Oracle JDK 8u202를 포함하는 /usr/lib/jvm/jdk1.8.0_202로 설정됩니다. 자세한 내용은 대체 Maven 실행 JDK 버전 섹션을 참조하십시오.

  • 필요한 몇 가지 추가 시스템 패키지가 설치되어 있습니다.

    • bzip2
    • unzip
    • libpng
    • imagemagick
    • graphicsmagick
  • 추가 시스템 패키지 설치 섹션에 설명된 대로 빌드 시 다른 패키지를 설치할 수 있습니다.

  • 모든 빌드는 깨끗한 환경에서 수행되며, 빌드 컨테이너는 실행 사이에 어떤 상태도 유지하지 않습니다.

  • Maven은 항상 다음 세 가지 명령을 사용하여 실행됩니다.

  • mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins

  • mvn --batch-mode org.apache.maven.plugins:maven-clean-plugin:3.1.0:clean -Dmaven.clean.failOnError=false

  • mvn --batch-mode org.jacoco:jacoco-maven-plugin:prepare-agent package

  • Maven은 adobe-public이라는 프로필을 사용하여 자동으로 공개 Adobe 아티팩트 저장소를 포함하는 settings.xml 파일로 시스템 수준에서 구성됩니다. 자세한 내용은 Adobe 공개 Maven 저장소를 참조하십시오.

노트

Cloud Manager에서는 jacoco-maven-plugin의 특정 버전을 정의하지는 않지만 사용되는 버전은 0.7.5.201505241946 이상이어야 합니다.

특정 Java 버전 사용

기본적으로 프로젝트는 Oracle 8 JDK를 사용하여 Cloud Manager 빌드 프로세스를 통해 구축됩니다. 대체 JDK를 사용하려는 고객은 두 가지 옵션이 있습니다.

Maven 툴체인

Maven 툴체인 플러그인을 사용하면 프로젝트가 툴체인 인식 Maven 플러그인의 맥락에서 사용될 특정 JDK(또는 툴체인)를 선택할 수 있습니다. 공급업체 및 버전 값을 지정하여 프로젝트의 pom.xml 파일에서 이 작업을 수행합니다.

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-toolchains-plugin</artifactId>
    <version>1.1</version>
    <executions>
        <execution>
            <goals>
                <goal>toolchain</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <toolchains>
            <jdk>
                <version>11</version>
                <vendor>oracle</vendor>
            </jdk>
        </toolchains>
    </configuration>
</plugin>

그러면 모든 툴체인 인식 Maven 플러그인이 Oracle JDK 버전 11을 사용하게 됩니다.

이 방법을 사용하면 Maven 자체는 기본 JDK(Oracle 8)를 사용하여 계속 실행되며 JAVA_HOME 환경 변수는 변경되지 않습니다. 따라서 Apache Maven Enforcer 플러그인과 같은 플러그인을 통해 Java 버전의 확인 또는 적용은 작동하지 않으며 이러한 플러그인은 사용해서는 안 됩니다.

현재 사용 가능한 공급업체/버전 조합은 다음과 같습니다.

공급업체 버전
oracle 8
oracle 11
sun 8
sun 11

이 표에는 제품 버전 번호가 나와 있습니다. Java 빌드 번호 또는 설치 경로는 Java 8용 1.8과 같은 이전 Java 버전 규칙을 반영할 수 있습니다.

노트

2022년 4월부터 Oracle JDK는 AEM 애플리케이션의 개발과 운영을 위한 기본 JDK가 될 것입니다. Cloud Manager의 빌드 프로세스는 Maven 툴체인에 대체 옵션이 명시적으로 선택되어 있더라도 Oracle JDK를 사용하는 것으로 자동 전환됩니다. 자세한 내용은 4월 릴리스 정보가 게시되면 이를 참조하십시오.

대체 Maven 실행 JDK 버전

전체 Maven 실행에 대한 JDK로 Java 8 또는 Java 11을 선택할 수도 있습니다. 툴체인 옵션과 달리 툴체인 구성이 툴체인 인식 Maven 플러그인에 여전히 적용되는 경우 툴체인 구성도 설정되어 있지 않는 한 모든 플러그인에 사용되는 JDK가 변경됩니다. 따라서 Apache Maven Enforcer 플러그인을 사용한 Java 버전 확인 및 시행이 작동합니다.

이렇게 하려면 파이프라인에서 사용하는 git 저장소 분기에 .cloudmanager/java-version이라는 파일을 생성합니다. 이 파일은 콘텐츠 11 또는 8을 가질 수 있습니다. 다른 모든 값은 무시됩니다. 11을 지정하면 Oracle 11이 사용되고 JAVA_HOME 환경 변수가 /usr/lib/jvm/jdk-11.0.2로 설정됩니다. 8을 지정하면 Oracle 8이 사용되고 JAVA_HOME 환경 변수가 /usr/lib/jvm/jdk1.8.0_202로 설정됩니다.

환경 변수

표준 환경 변수

프로그램 또는 파이프라인에 대한 정보를 기반으로 빌드 프로세스를 변경해야 할 수도 있습니다.

예를 들어 작성 시간 JavaScript 축소가 gulp와 같은 도구를 통해 이루어진다면 스테이징과 프로덕션을 위한 빌드가 아닌 개발 환경을 위한 빌드를 만들 때 다른 축소 수준을 사용하려는 욕구가 있을 수 있습니다.

이를 지원하기 위해 Cloud Manager는 모든 실행 시 빌드 컨테이너에 이러한 표준 환경 변수를 추가합니다.

변수 이름 정의
CM_BUILD 항상 true로 설정
BRANCH 실행에 대해 구성된 분기
CM_PIPELINE_ID 숫자 파이프라인 식별자
CM_PIPELINE_NAME 파이프라인 이름
CM_PROGRAM_ID 숫자 프로그램 식별자
CM_PROGRAM_NAME 프로그램 이름
ARTIFACTS_VERSION 스테이징 또는 프로덕션 파이프라인의 경우 Cloud Manager에서 생성된 통합 버전
CM_AEM_PRODUCT_VERSION 릴리스 버전

파이프라인 변수

빌드 프로세스가 git 저장소에 배치하기에 부적절하거나 동일한 분기를 사용하는 파이프라인 실행 간에 달라져야 하는 특정 구성 변수에 따라 달라질 수 있습니다.

Cloud Manager를 사용하면 파이프라인 단위로 Cloud Manager API 또는 Cloud Manager CLI를 통해 이러한 변수를 구성할 수 있습니다. 변수는 일반 텍스트로 저장되거나 사용하지 않을 때 암호화될 수 있습니다. 두 경우 모두 pom.xml 파일 또는 다른 빌드 스크립트 내에서 참조할 수 있는 환경 변수로 빌드 환경 내에서 변수를 사용할 수 있습니다.

이 CLI 명령은 변수를 설정합니다.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

이 명령은 변수를 나열합니다.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

변수 이름은 다음 규칙을 준수해야 합니다.

  • 변수에는 영숫자와 밑줄(_)만 포함될 수 있습니다.
  • 이름은 모두 대문자로 해야 합니다.
  • 파이프라인당 200개의 변수 제한이 있습니다.
  • 각 이름은 100자 미만이어야 합니다.
  • string 변수 값은 2048자 미만이어야 합니다.
  • secretString 유형의 변수 값은 500자 미만이어야 합니다.

Maven pom.xml 파일 내에서 사용할 경우, 일반적으로 다음과 유사한 구문을 사용하여 이러한 변수를 Maven 속성에 매핑하는 것이 유용합니다.

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>

추가 시스템 패키지 설치

완벽한 작동을 위해서는 일부 빌드에 추가 시스템 패키지를 설치해야 합니다. 예를 들어 빌드는 Python 또는 Ruby 스크립트를 호출할 수 있으며 적절한 언어 인터프리터가 설치되어야 합니다. 이 작업은 APT를 호출하기 위해 pom.xml에서 exec-maven-plugin를 호출하여 수행할 수 있습니다. 이 실행은 일반적으로 Cloud Manager 전용 Maven 프로필로 래핑해야 합니다. 이 예에서는 Python을 설치합니다.

        <profile>
            <id>install-python</id>
            <activation>
                <property>
                        <name>env.CM_BUILD</name>
                </property>
            </activation>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.codehaus.mojo</groupId>
                        <artifactId>exec-maven-plugin</artifactId>
                        <version>1.6.0</version>
                        <executions>
                            <execution>
                                <id>apt-get-update</id>
                                <phase>validate</phase>
                                <goals>
                                    <goal>exec</goal>
                                </goals>
                                <configuration>
                                    <executable>apt-get</executable>
                                    <arguments>
                                        <argument>update</argument>
                                    </arguments>
                                </configuration>
                            </execution>
                            <execution>
                                <id>install-python</id>
                                <phase>validate</phase>
                                <goals>
                                    <goal>exec</goal>
                                </goals>
                                <configuration>
                                    <executable>apt-get</executable>
                                    <arguments>
                                        <argument>install</argument>
                                        <argument>-y</argument>
                                        <argument>--no-install-recommends</argument>
                                        <argument>python</argument>
                                    </arguments>
                                </configuration>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
        </profile>

이와 동일한 기술을 사용하여 언어별 패키지를 설치할 수 있습니다. 예를 들어 RubyGems의 경우 gem 또는 Python 패키지의 경우 pip를 사용할 수 있습니다.

노트

이 방법으로 시스템 패키지를 설치하면 Adobe Experience Manager 실행에 사용되는 런타임 환경에 설치되지 않습니다. AEM 환경에 시스템 패키지를 설치해야 하는 경우 Adobe 담당자에게 문의하십시오.

프론트엔드 빌드 환경에 대한 자세한 내용은 프론트엔드 파이프라인으로 Sites 개발을 참조하십시오.

이 페이지에서는