文件Experience Cloud KCS

AEM解決方案，用於略過Cloud Manager中由於Docker內容封存封裝錯誤而造成的自訂UI測試

最後更新： 2026年7月8日

如果Cloud Manager跳過自訂UI測試，即使您的測試在本機執行，生成的UI測試Docker上下文封存可能會與上層目錄中的所需檔案一起封裝，而不是在封存根目錄中。 驗證封存結構並更新Maven元件設定會還原Cloud Manager中的測試偵測。

說明 description

環境

Adobe Experience Manager as a Cloud Service

問題/症狀

當Cloud Manager無法在生成的Docker上下文封存中檢測到UI測試選擇加入檔案時，通常會出現此問題。

  • 「自訂UI測試」步驟會顯示類似於「已略過UI測試」的訊息，因為在原始程式碼存放庫中找不到測試。
  • 您的Playwright、Cypress、Selenium或其他支援的UI測試會在本機執行，但Cloud Manager中不會顯示任何UI測試執行。
  • testing.properties檔案存在於存放庫中，但Cloud Manager仍會略過測試。
  • 您可以建立UI測試模組，並檢查testing.properties儲存在所產生*-ui-test-docker-context.tar.gz檔案中的哪個位置，以確認問題。 執行tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties。 如果結果顯示路徑，例如some-folder/testing.properties，而不是只有testing.properties，封存就未正確封裝。
  • 您也可以檢查是否已將testing.properties儲存在UI測試模組的pom.xml檔案旁邊，且其中剛好包含ui-tests.version=1，以確認組態。

解決方法 resolution

請嘗試下列步驟來解決問題：

  1. 確認管道正在將正確的Git分支用於UI測試模組。 管道應使用包含ui.tests模組和testing.properties的分支。 在管道設定和下一個管道執行摘要中確認此專案。
  2. 檢查UI測試模組pom.xml檔案旁是否存在testing.properties，而且恰好包含ui-tests.version=1。 您應該會在正確模組中看到具有所需值的檔案。 直接在存放庫中確認。
  3. 在本機建立UI測試模組，以產生Docker上下文封存。 您應該會在模組target目錄中看到以-ui-test-docker-context.tar.gz結尾的檔案。 確認產生的封存使用ui-test-docker-context分類器。
  4. 檢查產生的封存，並執行tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties以檢查testing.properties是否儲存在封存根目錄中。 您應該只會看到沒有上層資料夾首碼的testing.properties。 如果輸出顯示路徑，例如some-folder/testing.properties，則封存封裝不正確。 繼續下一個步驟。
  5. 更新assembly-ui-test-docker-context.xml以將Docker內容封裝在封存根目錄下。 請確定元件保留<includeBaseDirectory>false</includeBaseDirectory>並包含根層級檔案的testing.properties，例如Dockerfile和wait-for-grid.sh。 您應該會看到儲存於封存最上層（而非包裝函式目錄）的必要檔案。 重建模組並重複封存檢查，直到根目錄出現testing.properties為止，以確認此專案。
  6. 認可封裝變更，將其推送到管道使用的分支，然後再次執行管道。 Custom UI Testing步驟應該執行，而非顯示略過訊息。 在管道執行詳細資料中確認這一點，並檢查UI測試記錄是否可用。
  7. 如果現在檢測到測試但在執行期間失敗，請檢視管道執行的UI測試記錄，並更正測試或框架特定的錯誤。 Cloud Manager應該會成功偵測並執行測試影像。 透過檢查管道顯示實際UI測試執行而不是跳過的步驟來確認這一點。

如果發生下列症狀且疑難排解步驟產生下列結果，請將票證提交至Adobe支援：封存在根目錄顯示testing.properties、管道使用正確的分支，而Cloud Manager仍會報告找不到任何UI測試。

當您聯絡支援時，包含封存清單、assembly-ui-test-docker-context.xml檔案、UI測試模組pom.xml以及管道執行URL。

recommendation-more-help
experience-cloud-kcs-help-kbarticles