Cloud Manager 常見問題集

本文件為 AMS 客戶提供有關 Cloud Manager 最常見問題的解答。

是否可能將 Java 11 和 Cloud Manager 組建一起使用？

是。 您將需要使用 Java 11 的正確設定新增 maven-toolchains-plugin。

從 Java 8 切換到 Java 11 後，我的組建失敗並出現有關 maven-scr-plugin 的錯誤。該怎麼辦？

嘗試將組建從 Java 8 切換到 11 時，您的 AEM Cloud Manager 組建可能會失敗。如果您遇到下列錯誤，則需要移除 maven-scr-plugin 並將所有 OSGi 註解轉換成 OSGi R6 註解。

[main] [ERROR] Failed to execute goal org.apache.felix:maven-scr-plugin:1.26.4:scr (generate-scr-scrdescriptor) on project helloworld.core: /build_root/build/testsite/src/main/java/com/adobe/HelloWorldServiceImpl.java : Unable to load compiled class: com.adobe.HelloWorldServiceImpl: com/adobe/HelloWorldServiceImpl has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0 -> [Help 1]

如需有關如何移除此外掛程式的說明，請參閱此處。

從 Java 8 切換到 Java 11 後，我的組建失敗並出現有關 RequireJavaVersion 的錯誤。該怎麼辦？

對於 Cloud Manager 組建，maven-enforcer-plugin 可能由於此錯誤而失敗。

[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion

這是一個已知問題，原因在於 Cloud Manager 使用不同版本的 Java 來執行 maven 命令而不是編譯程式碼。只需忽略您的 maven-enforcer-plugin 設定中的 requireJavaVersion。

計劃碼品質檢查已失敗，我們的部署無法進行。是否有辦法略過這項檢查？

是。 除了安全評等之外，所有程式碼品質失敗都是非關鍵性量度，因此可透過擴展結果 UI 中的項目將其視為部署管道的一部分而略過。

具有部署管理員、專案管理員或企業所有者角色的使用者可覆寫此問題，這種情況下，管道會繼續進行，或者他們可接受此問題，這種情況下，管道會因失敗而停止。

如需更多詳細資料，請參閱以下文件：執行管道時的三層級閘道以及設定非生產管道。

Cloud Manager 部署在 Adobe Managed Services 環境中的效能測試步驟失敗。我們如何對此進行偵錯以傳遞關鍵性量度？

對於這個問題沒有單一解答。但是，您應該謹記以下有關效能測試步驟的一些要點：

  • 此步驟是網頁效能步驟，也就是使用網頁瀏覽器載入頁面的時間。
  • 在測試期間，結果 .csv 檔案中的 URL 清單會在 Cloud Manager 基礎結構的 Chrome 瀏覽器中載入。
  • 一個會失敗的常見量度是錯誤率。
    • 為了讓 URL 通過，主要 URL 必須以 200 狀態載入，並且必須在 20 秒內完成。
    • 載入時間超過 20 秒的頁面會被標示為 504 錯誤。
  • 如果您的網站要求使用者驗證，請參閱文件：了解您的測試結果，以設定驗證您的網站的測試。

如需有關品質檢查的詳細資訊，請參閱文件：了解測試結果。

我是否能將 SNAPSHOT 用於 Maven 專案的版本？

可以。 對於開發人員部署，Git 分支 pom.xml 檔案在 <version> 值的末尾必須包含 -SNAPSHOT。

這容許在版本未變更時仍可安裝後續部署。在開發人員部署中，不會為 Maven 組建新增或產生自動版本。

您還可以將版本設定為 -SNAPSHOT，以用於測試和生產組建或部署。Cloud Manager 會自動設定適當的版本編號並在 Git 中為您建立標記。如有需要，可在稍後參照此標記。

有關版本處理的進一步詳細資料在此處記錄。

套件和套裝的版本設定如何用於中繼和生產部署？

在中繼和生產部署中，會產生自動化版本，如此處的紀錄。

對於中繼和生產部署中的自訂版本設定，請設定適當的三部分 Maven 版本，例如 1.0.0。 每次部署到生產時，都需增加版本。

Cloud Manager 會自動將其版本新增到測試和生產組建，並建立 Git 分支。不需要特別設定。如果您並未依照之前的說明設定 Maven 版本，部署仍會成功，並會自動設定版本。

對於 Cloud Manager 部署，我的 Maven 組建失敗，但它在本機建置且沒有出現錯誤。有什麼問題嗎？

如需更多詳細資訊，請參閱此 Git 資源。

我無法使用 aio 命令設定變數。該怎麼辦？

嘗試透過 aio 命令列出或設定管道變數時，您可能會收到類似以下的 403 錯誤。

$ aio cloudmanager:list-pipeline-variables 222

Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-pipeline-variables 222 --variable TEST 1

Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-environment-variables 1755 --variable TEST 1

setting variables... !

Cannot set variables: https://cloudmanager.adobe.io/api/program/111/environment/222/variables (403 Forbidden)

這種情況下，需要將執行這些命令的使用者新增到 Admin Console 中的​部署管理員​角色。

如需更多詳細資訊，請參閱 API 權限。

本頁內容