构建环境 build-environment
了解 Cloud Manager 的构建环境以及它如何构建和测试您的代码。
构建环境详细信息 build-environment-details
Cloud Manager 使用专门的构建环境构建和测试代码。
-
该构建环境基于 Linux，并派生自 Ubuntu 22.04。
-
安装了 Apache Maven 3.9.4。
- Adobe 建议用户更新其 Maven 存储库以使用 HTTPS 代替 HTTP。
-
安装的Java版本为OracleJDK 11.0.22和OracleJDK 8u401。
-
重要信息：默认情况下，
JAVA_HOME环境变量设置为/usr/lib/jvm/jdk1.8.0_401，其中包含OracleJDK 8u401。 AEM Cloud Projects应覆盖此默认值以使用JDK 11。 有关更多详细信息，请参阅设置Maven JDK版本部分。 -
安装了一些其他的必要系统包。
bzip2unziplibpngimagemagickgraphicsmagick
-
可以在构建时安装其他包，如安装其他系统包部分中所述。
-
每个构建都在干净的环境中运行，并且构建容器在执行之间不保留任何状态。
-
Maven 始终通过以下三条命令运行。
mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-pluginsmvn --batch-mode org.apache.maven.plugins:maven-clean-plugin:3.1.0:clean -Dmaven.clean.failOnError=falsemvn --batch-mode org.jacoco:jacoco-maven-plugin:prepare-agent package
-
使用
settings.xml文件在系统级别配置 Maven，并将自动包含使用名为adobe-public的配置文件的公共 Adobe 构件存储库。（有关更多详细信息，请参阅 Adobe 公共 Maven 存储库）。
jacoco-maven-plugin 的具体版本，但使用的版本必须至少为 0.7.5.201505241946。HTTPS Maven 存储库 https-maven
Cloud Manager 版本 2023.10.0 开始了对构建环境的一项滚动更新（在推出版本 2023.12.0 时完成更新），其中包括对 Maven 3.8.8 的更新。Maven 3.8.1 中引入的一项重大更改是旨在减少潜在漏洞的一项安全增强。具体来说，Maven 现在默认禁用所有不安全的 http://* 镜像，如 Maven 发行说明中所述。
此安全增强导致某些用户可能在构建步骤中遇到问题，尤其是从使用不安全 HTTP 连接的 Maven 存储库下载工件时。
为了确保更新版本的流畅体验，Adobe 建议用户更新其 Maven 存储库以使用 HTTPS 代替 HTTP。此调整与行业日益转向安全通信协议的趋势一致，并有助于构建过程保持安全可靠。
使用特定的Java版本 using-java-support
默认情况下，Cloud Manager构建过程使用Oracle8 JDK构建项目，但AEM Cloud Service客户应将Maven执行JDK版本设置为11。
设置Maven JDK版本 alternate-maven-jdk-version
Adobe建议在.cloudmanager/java-version文件中将整个Maven执行的JDK版本设置为11。
为此，请在管道使用的Git存储库分支中创建一个名为.cloudmanager/java-version的文件。 编辑文件，使其仅包含文本11。 虽然Cloud Manager也接受值8，但AEM Cloud Service项目不再支持此版本。 任何其他值将被忽略。 当指定11时，使用Oracle11，并且JAVA_HOME环境变量设置为/usr/lib/jvm/jdk-11.0.22。
环境变量 — 标准 environment-variables
您可能会发现必须根据项目或管道的相关信息来更改构建过程。
例如，如果在构建时使用gulp等工具进行JavaScript缩小，则不同环境可能首选不同的缩小级别。 与暂存和生产版本相比，开发版本可能使用更轻的缩小级别。
为此，Cloud Manager 会为每个执行将这些标准环境变量添加到构建容器中。
CM_BUILDtrueBRANCHCM_PIPELINE_IDCM_PIPELINE_NAMECM_PROGRAM_IDCM_PROGRAM_NAMEARTIFACTS_VERSIONCM_AEM_PRODUCT_VERSION环境变量 — 管道 pipeline-variables
您的构建过程可能需要特定的配置变量，这些变量不应存储在Git存储库中。 此外，您可能需要在使用同一分支的管道执行之间调整这些变量。
有关详细信息，另请参阅配置管道变量。
安装其他系统包 installing-additional-system-packages
一些构建需要其他系统包才能完全运行。 例如，内部版本可能会调用Python或Ruby脚本，并且必须安装适当的语言解释程序。 可以通过在pom.xml中调用exec-maven-plugin以调用APT来管理此安装过程。 此执行通常应封装在特定于 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>
可使用相同的方法安装语言特定的包，例如，使用 gem 安装 RubyGems 包或使用 pip 安装 Python 包。