构建环境

了解 Cloud Manager 的构建环境以及它如何构建和测试您的代码。

构建环境详细信息

Cloud Manager 使用专门的构建环境构建和测试代码。

• 构建环境基于 Linux，并派生自 Ubuntu 18.04。

• 安装 Apache Maven 3.6.0。

• 安装的 Java 版本是 Oracle JDK 8u202 和 Oracle JDK 11.0.2。

• 默认情况下，JAVA_HOME 环境变量设置为 /usr/lib/jvm/jdk1.8.0_202，其中包含 Oracle JDK 8u202。有关更多详细信息，请参阅替代 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

• 使用 settings.xml 文件在系统级别配置 Maven，并将自动包含使用名为 adobe-public 的配置文件的公共 Adobe 构件存储库。（有关更多详细信息，请参阅 Adobe 公共 Maven 存储库）。

使用特定的 Java 版本

默认情况下，项目通过使用 Oracle 8 JDK 的 Cloud Manager 构建过程构建。 希望使用替代 JDK 的客户有两种选择。

• 适用 Maven 工具链。
• 为整个 Maven 执行过程选择替代 JDK 版本。

Maven 工具链

Maven 工具链插件允许项目选择特定的 JDK（或工具链）以在工具链感知的 Maven 插件的上下文中使用。 通过在项目的 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 版本将不起作用，并且不得使用此类插件。

当前可用的供应商/版本组合是：

此表代表产品版本号。 Java 内部版本号或安装路径可能反映旧的 Java 版本惯例，如 Java 8 的 1.8 版本。

替代 Maven 执行 JDK 版本

也可以选择 Java 8 或 Java 11 作为整个 Maven 执行的 JDK。 与工具链选项不同，除非也设置了工具链配置（在此情况下，工具链配置仍适用于工具链感知的 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 会为每个执行将这些标准环境变量添加到构建容器中。

管道变量

您的构建过程可能取决于特定的配置变量，这些变量不适合放置在 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 脚本，因此需要安装适当的语言解释程序。 可以通过在 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 包。

Business.Adobe.com 资源