建置環境 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雲端專案應覆寫此預設以使用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建議您將整個Maven執行的JDK版本設定為.cloudmanager/java-version檔案中的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 套件。