빌드 환경 build-environment

Cloud Manager 사용자가 코드를 빌드하고 테스트하기 위해 사용하는 특수한 빌드 환경에 대해 알아보십시오.

환경 세부 정보 details

Cloud Manager의 빌드 환경에는 다음과 같은 속성이 있습니다.

HTTPS Maven 저장소 https-maven

Cloud Manager 2023.10.0에서는 빌드 환경에 대한 롤링 업데이트(2023.12.0 릴리스로 완료)를 시작했으며, 여기에는 Maven 3.8.8 업데이트가 포함되어 있습니다. Maven 3.8.1에 도입된 주요 변경 사항은 잠재적인 취약점을 완화하기 위한 보안 강화 기능입니다. 구체적으로 Maven은 이제 Maven 릴리스 정보에 설명된 바와 같이 안전하지 않은 모든 http://* 미러를 기본적으로 비활성화합니다.

이러한 보안 강화로 인해 일부 사용자는 빌드 단계에서 문제에 직면할 수 있으며, 특히 안전하지 않은 HTTP 연결을 사용하는 Maven 저장소에서 아티팩트를 다운로드할 때 이와 같은 문제가 보다 빈번하게 발생할 수 있습니다.

업데이트된 버전을 원활하게 사용하기 위해 Adobe는 사용자가 HTTP 대신 HTTPS를 사용하도록 Maven 저장소를 업데이트할 것을 권장합니다. 이러한 조정은 업계에서 점점 더 보안 통신 프로토콜로 전환하는 추세에 맞춰 안전하고 안정적인 빌드 프로세스를 유지하는 데 도움이 될 것으로 기대합니다.

특정 Java 버전 사용 using-java-version

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

Maven 툴체인 maven-toolchains

Maven 툴체인 플러그인을 사용하면 프로젝트가 툴체인 인식 Maven 플러그인의 맥락에서 사용될 특정 JDK(또는 툴체인)를 선택할 수 있습니다. 공급업체 및 버전 값을 지정하여 프로젝트의 pom.xml 파일에서 이 프로세스를 수행합니다. 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 버전의 확인 또는 적용은 작동하지 않으며 이러한 플러그인은 사용해서는 안 됩니다.

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

대체 Maven 실행 JDK 버전 alternate-maven

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

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

환경 변수 environment-variables

표준 환경 변수 standard-environ-variables

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

예를 들어 JavaScript 최소화를 위해 gulp와 같은 도구를 사용하는 경우, 개발과 스테이징 및 프로덕션 환경에 대해 다른 최소화 수준을 선호할 수 있습니다.

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

표준 환경 변수 가용성 availability

표준 환경 변수는 여러 곳에서 사용할 수 있습니다.

작성, 미리보기 및 게시 환경 author-preview-publish

일반 환경 변수와 시크릿은 작성, 미리보기 및 게시 환경에서 사용할 수 있습니다.

Dispatcher dispatcher

Dispatcher에는 일반 환경 변수만 사용할 수 있습니다. 시크릿은 사용할 수 없습니다.

그러나 환경 변수는 IfDefine 지침에서 사용할 수 없습니다.

OSGi 구성 osgi

일반 환경 변수 및 시크릿 모두 OSGi 구성에서 사용할 수 있습니다.

파이프라인 변수 pipeline-variables

경우에 따라 빌드 프로세스가 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

변수는 특정 제한 사항을 준수해야 합니다.

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>

추가 시스템 패키지 설치 installing-additional-system-packages

완벽한 작동을 위해서는 일부 빌드에 추가 시스템 패키지를 설치해야 합니다. 예를 들어 빌드는 Python 또는 Ruby 스크립트를 호출할 수 있으며, 결과적으로 적절한 언어 인터프리터가 설치되어야 합니다. 이 시나리오는 APT를 호출하기 위해 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 Package에는 pip를 사용하는 것입니다.