文件 Experience Cloud KCS

當預覽Dispatcher未準備就緒時，Cloud Manager管道會停止並失敗

最後更新： 2026年8月6日

本文說明如何解決持續處於開始狀態數小時，然後在預覽Dispatcher未及時就緒時失敗的AEM as a Cloud Service部署管道。

說明 description

環境

Adobe Experience Manager (AEM) as a Cloud Service
Cloud Manager部署管道使用Dispatcher設定及受管理的重寫圖

問題/症狀

部署管道在失敗之前會維持很長一段時間的開始或預熱狀態。
在與content/dam/rewrites/redirects相關的記錄中看到Dispatcher啟動和準備程度檢查失敗。
Cloud Manager會在長時間延遲後顯示一般部署失敗訊息。

The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.

建置和程式碼品質步驟已成功完成，但部署之後未正常進行。
即使先前執行中成功部署相同分支或程式碼，也可能發生問題。
當專案使用受管理的重寫對應並預覽Dispatcher啟動延遲時，就更有可能發生這種情況。

重製條件

嘗試使用Cloud Manager將程式碼（甚至先前成功的程式碼）部署到開發環境。
預覽Dispatcher或相關的預覽服務在預期的時間範圍內未正常運作。
管道在長時間等待後失敗，或成功完成，但具有異常長的執行時間。

原因

部署管道會擱置，並最終失敗，因為預覽Dispatcher容器未達到就緒狀態，導致Cloud Manager等候逾時。更新Dispatcher YAML設定以將等待旗標設定為false可讓預覽Dispatcher啟動，而不會封鎖管道。

解決方法 resolution

若要修復預覽Dispatcher啟動封鎖所導致的管道延遲和失敗，請按照以下步驟操作：

確認所有預覽服務（包括Dispatcher）皆已正確設定，並且可以正確啟動，沒有錯誤。檢查Cloud Manager記錄檔，瞭解與預覽Dispatcher相關的任何整備情況或健康情況檢查失敗。
編輯Dispatcher設定YAML檔案，例如rewrite-maps.yaml或managed-rewrite-maps.yaml。檢閱檔案中可能封鎖啟動的對映專案，並確定所有對應專案的wait旗標皆設為false。例如：

maps:
        - name: redirects-301.map
        path: /content/dam/rewrites/redirects-301.txt
        ttl: 300
        wait: false
        - name: redirects-302.map
        path: /content/dam/rewrites/redirects-302.txt
        ttl: 300
        wait: false

儲存變更並將其提交到您的存放庫，然後在Cloud Manager中重新執行管道。
監視管道執行，以確認預覽Dispatcher和相關服務及時達到健康狀態，而不是保持長時間啟動或預熱狀態。
成功部署後，請確認Dispatcher程式碼已按預期部署。
如果管道仍然需要比預期更長的時間或失敗，請檢視Dispatcher並預覽服務日誌，以瞭解其他準備情況、健康檢查或啟動問題。

recommendation-more-help

experience-cloud-kcs-help-kbarticles