Cloud Manager的組建環境 build-environment
了解 Cloud Manager 的構建環境以及它如何構建和測試您的程式碼。
建置環境詳細資訊 build-environment-details
Cloud Manager 使用專門的構建環境構建和測試您的程式碼。
- 建置環境以 Linux 為基礎，衍生自 Ubuntu 22.04。
- 已安裝 Apache Maven 3.9.4。
- Adobe 建議使用者更新其 Maven 存放庫以使用 HTTPS 而非 HTTP。
- 已安裝的Java版本為Oracle JDK 11.0.22、Oracle JDK 17.0.10和Oracle JDK 21.0.4。
-
重要：依預設，
JAVA_HOME環境變數設為/usr/lib/jvm/jdk1.8.0_401，其中包含Oracle JDK 8u401。 覆寫AEM Cloud專案的此預設為使用JDK 21 （偏好設定）、17或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的特定版本，但所需版本取決於專案的Java版本。 對於Java 8，外掛程式版本必須至少為0.7.5.201505241946，而較新的Java版本需要較新的版本。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建置流程預設會使用Oracle 8 JDK建置專案，但AEM Cloud Service客戶將Maven執行JDK版本設為21 （偏好設定）、17或11。
設定Maven JDK版本 alternate-maven-jdk-version
若要設定Maven執行JDK，請在管道使用的Git存放庫分支中建立名為.cloudmanager/java-version的檔案。 編輯檔案，使其僅包含文字21或17。 雖然Cloud Manager也接受8的值，但AEM Cloud Service專案不再支援此版本。 任何其他值會受到忽略。 指定21或17時，會使用Oracle Java 21或Oracle Java 17。
移轉至使用Java 21或Java 17建置的先決條件 prereq-for-building
為了使用Java 21或Java 17進行建置，Cloud Manager現在使用SonarQube 9.9，其與這些Java版本相容。 此變更已在Cloud Manager 2025.1.0版中引入。 升級SonarQube不需要客戶採取任何動作。 如需詳細資訊及瞭解變更，請參閱Cloud Manager 2025.1.0發行說明。
將應用程式移轉至新的Java組建版本和執行階段版本時，請先在開發和測試環境中徹底測試，然後再部署到生產環境。
Adobe建議下列部署策略：
- 使用Java 21執行您的本機SDK （可從https://experience.adobe.com/#/downloads下載）、將您的應用程式部署到該應用程式，以及驗證其功能。 若要確保沒有錯誤（表示類別載入或位元組碼編排發生問題），請檢查記錄。
- 若要使用Java 21做為建置時間Java版本，請在Cloud Manager存放庫中設定分支、設定開發管道以使用此分支，然後執行管道。 執行驗證測試。
- 如果使用Java 21作為建置時間Java版本時，結果令人滿意，請設定您的階段/生產管道並執行管道。
翻譯功能 translation-features
以下功能在Java 21執行階段上部署時無法正常運作，Adobe預計可在2025年初解決這些問題：
- 使用人工翻譯時，
XLIFF（XML本地化交換檔案格式）失敗。 I18n（國際化）無法正確處理希伯來文(he)、印尼(in)和意第緒文(yi)的語言環境，因為較新Java版本中的Locale建構函式已變更。
執行階段需求 runtime-requirements
Java 21執行階段已套用至所有符合資格的環境，這些是AEM發行說17098或更新版本中符合以下條件的環境。 如果環境不符合條件，請務必進行調整，以確保效能、可用性和安全性。
-
ASM的最低版本：
將Java套件org.objectweb.asm（通常整合在org.ow2.asm.*成品中）的使用更新至9.5版或更新版本，以確保支援較新的JVM執行階段。 -
Groovy的最低版本：
將Java套件org.apache.groovy或org.codehaus.groovy的使用更新至4.0.22版或更新版本，以確保支援較新的JVM執行階段。新增第三方相依性 (例如 AEM Groovy 主控台) 可以間接包含此搭售方案。
-
Aries SPIFly的最低版本：
將Java套件org.apache.aries.spifly.dynamic.bundle的使用更新至1.3.6版或更新版本，以確保支援更新的JVM執行階段。
AEM Cloud Service SDK支援Java 21，讓您在執行Cloud Manager管道之前，先驗證專案與Java 21的相容性。
-
編輯執行階段引數：
使用Java 21在本機執行AEM時，由於MaxPermSize引數，啟動指令碼（crx-quickstart/bin/start或crx-quickstart/bin/start.bat）會失敗。 或者，從指令碼移除-XX:MaxPermSize=256M或定義環境變數CQ_JVM_OPTS，將其設定為-Xmx1024m -Djava.awt.headless=true。AEM Cloud Service SDK版本19149和更新版本可解決此問題。
.cloudmanager/java-version設定為21或17來設定此專案。 如有疑問，請連絡Adobe： aemcs-java-adopter@adobe.com。建置時間需求 build-time-reqs
需要進行下列調整，才能使用Java 21和Java 17建置專案。 甚至在您執行Java 21和Java 17之前，這些檔案就已經可以更新了，因為它們與舊版Java相容。
AEM Cloud Service客戶建議儘早使用Java 21建置專案，以運用新的語言功能。
-
最低版本
bnd-maven-plugin：
將bnd-maven-plugin的使用更新至6.4.0版，以確保支援較新的JVM執行階段。版本7或更新版本與Java 11或更低版本不相容，因此不建議升級至該版本。
-
最低版本
aemanalyser-maven-plugin：
將aemanalyser-maven-plugin的使用更新至1.6.16版或更新版本，以確保支援較新的JVM執行階段。 -
最低版本
maven-bundle-plugin：
將maven-bundle-plugin的使用更新至5.1.5版或更新版本，以確保支援較新的JVM執行階段。版本6或更高版本與Java 11或更低版本不相容，因此不建議升級至該版本。
-
在
maven-scr-plugin中更新相依性：maven-scr-plugin與Java 21或Java 17不直接相容。 不過，可以透過更新外掛程式組態中的ASM相依性版本來產生描述項檔案，如下列範例所示：
<project>
...
<build>
...
<plugins>
...
<plugin>
<groupId>org.apache.felix</groupId>
<artifactId>maven-scr-plugin</artifactId>
<version>1.26.4</version>
<executions>
<execution>
<id>generate-scr-scrdescriptor</id>
<goals>
<goal>scr</goal>
</goals>
</execution>
</executions>
<dependencies>
<dependency>
<groupId>org.ow2.asm</groupId>
<artifactId>asm-analysis</artifactId>
<version>9.7.1</version>
<scope>compile</scope>
</dependency>
</dependencies>
</plugin>
...
</plugins>
...
</build>
...
</project>
環境變數 — 標準 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 套件。