빌드 환경 build-environment

Cloud Manager이 코드를 빌드하고 테스트하는 데 사용하는 특수한 빌드 환경에 대해 알아봅니다.

환경 세부 정보 details

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

HTTPS Maven 저장소 https-maven

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

일부 사용자는 빌드 단계에서 비보안 HTTP 연결을 사용하는 Maven 저장소에서 아티팩트를 다운로드할 때 문제가 발생합니다.

업데이트된 버전을 원활하게 사용하기 위해 Adobe는 사용자가 HTTP 대신 HTTPS를 사용하도록 Maven 저장소를 업데이트할 것을 권장합니다. 이러한 조정은 보안 통신 프로토콜로의 산업 전환을 지원하고 안전하고 신뢰할 수 있는 빌드 프로세스를 유지한다.

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

기본적으로 프로젝트는 Oracle 8 JDK를 사용하여 Cloud Manager 빌드 프로세스를 통해 구축됩니다. 대체 JDK를 사용하려는 고객은 전체 Maven 실행 프로세스에 대한 대체 JDK 버전을 선택할 수 있습니다.

대체 Maven 실행 JDK 버전 alternate-maven

전체 Maven 실행에 대한 JDK로 Oracle 8 또는 Oracle 11을 선택할 수 있습니다. 이 방법은 모든 플러그인에 사용되는 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 패키지의 경우 pip을(를) 사용합니다.