文件CommerceCommerce KB

僅限PaaS

Adobe Commerce部署疑難排解員

最後更新： 2025年5月5日
  • 主題：
  • 建置
  • 部署

建立對象：

  • 開發人員

Adobe Commerce上的停滯部署和失敗部署可以使用Deployment Troubleshooter工具來解決。 按一下每個問題以顯示疑難排解員每個步驟的答案。

步驟1 — 確認服務執行中

雲端基礎結構服務上的Adobe Commerce是否正常運作？

停滯部署 — 雲端基礎結構服務上的Adobe Commerce是否正常運作？ 檢查Adobe Commerce Cloud。

a.是 — 繼續進行步驟2。
b.否 — 維護或全球中斷。 檢查估計持續時間和更新。

步驟2 — 檢查其他環境中的部署

其他環境中是否有部署會封鎖現有環境中的部署？

若要取得進行中活動的清單，請使用magento-cloud CLI執行以下命令（如果您只新增到一個雲端專案）。 注意：請檢查您是否使用最新版的magento-cloud CLI。 如需相關步驟，請參閱Commerce on Cloud Infrastructure指南中的更新CLI。

magento-cloud --state=in_progress

若要取得進行中活動的清單，請使用magento-cloud CLI執行以下命令（如果您已新增至多個專案）：

magento-cloud -p <project-id or project-url> --state=in_progress

若要尋找現有部署活動的相關資訊(請參閱如果雲端UI有「記錄片段」錯誤，請檢查部署記錄
如需詳細資訊)，您可以執行此命令來取得該活動的執行記錄檔：

magento-cloud activity:log <activity-id> [OPTIONAL: <-p project-id or project-url>]

a.是 — 疑難排解現有環境中封鎖部署的其他環境。 繼續進行步驟3。

b.否 — 疑難排解目前的環境。 繼續進行步驟3。

步驟3 — 驗證所有節點上的SSH

所有節點<>SSH成功？
a.是 — 繼續進行步驟4。
b.否 — 提交支援票證。

步驟4 — 確認所有服務都在執行中

所有服務都在執行中？
a.是 — 繼續進行步驟5。
b.否 — 提交支援票證。

步驟5 — 驗證Bitbucket執行中

使用Bitbucket？
a.是 — 檢查status.bitbucket.com。
b.否 — 檢查建置和部署記錄中的部署記錄錯誤。 繼續進行步驟6。

步驟6 — 檢查錯誤代碼

回報的錯誤碼？
a.是 — 繼續進行步驟7。
b.否 — 繼續進行步驟8。

步驟7 - 403禁止的錯誤

403禁止存取？
a.是 — 繼續進行步驟16。
b.否 — 繼續進行步驟9。

步驟8 — 驗證cron工作是否執行

目前是否在執行cron工作？<>在分支上透過ssh登入並執行ps aufxx |grep cron。
a.是 — 透過ssh在受影響的分支（例如主要）上登入。 終止和解鎖cron工作。 這將終止cron作業並重設狀態。 執行php vendor/bin/ece-tools cron:kill，然後執行php vendor/bin/ece-tools cron:unlock。 如果您正在將一個環境合併到另一個環境的過程中，請檢查這兩個環境是否正在執行cron。
b.否 — 繼續執行步驟17。

步驟9 — 可部署至遠端叢集的應用程式錯誤

無法將應用程式上傳到遠端叢集錯誤？
a.是 — 繼續進行步驟10。
b.否 — 繼續執行步驟11。

步驟10 — 檢查足夠的儲存空間

可用儲存空間還好嗎？
a.是 — 繼續步驟11。
b.否 — 檢閱管理磁碟空間。

步驟11 — 驗證磁碟空間

無法寫入<>檔案警告<>？
a.是 — 請在.magento.app.yaml中增加磁碟值，然後重新部署。 如果這個方法無法運作，請提交支援票證。
b.否 — 繼續進行步驟12。

步驟12 — 環境重新部署失敗錯誤

環境重新部署失敗錯誤？
a.是 — 繼續步驟13。
b.否 — 繼續進行步驟8。

步驟13 — 檢查Elasticsearch升級是否失敗

正在升級或部署的Elasticsearch？
a.是 — Elasticsearch升級步驟失敗。 請參閱Elasticsearch軟體相容性。 如果Elasticsearch升級仍無法運作，請提交支援票證。 注意：在雲端基礎結構上的Adobe Commerce上，請注意，若未提前48個營業時間通知我們的基礎結構團隊，服務升級就無法推送至生產環境。 這是必要措施，因為我們需要確保我們有一位基礎建設支援工程師在所需時間範圍內更新您的設定，將生產環境的停機時間降到最低。 因此，在變更需要投入生產前48小時，提交支援票證，詳細說明您需要的服務升級，並陳述您想要啟動升級程式的時間。
b.否 — 繼續執行步驟14。

步驟14 — 檢查空間限制

檔案系統用完inode或空間？
a.是 — 請參閱管理磁碟空間。
b.否 — 繼續執行步驟15。

步驟15 - Elasticsearch版本錯誤

有關Elasticseach版本的錯誤？
a.是 — 繼續進行步驟16。
b.否 — 繼續執行步驟21。

步驟16 — 驗證撰寫器設定

Composer設定是否正確？
a.是 — 繼續進行步驟10。
b.否 — 檢閱Composer疑難排解員網頁。

步驟17 — 檢查長時間執行的程式

個長時間執行的處理序？

a.是 — 識別長時間執行的處理作業，然後終止處理作業：

  1. 在終端機中執行以下命令： ps aufx。
  2. 找出長期執行程式的PID。
  3. 使用kill -9 <PID>終止處理序。

監控部署是否重新發生。

b.否 — 繼續執行步驟18。

步驟18 — 檢查後掛接失敗

後掛接失敗/擱置？
a.是 — 資料庫： 可用磁碟空間，損毀，不完整/損毀的資料表。
b.否 — 繼續執行步驟19。

步驟19 — 檢查協力廠商擴充功能是否封鎖部署

使用協力廠商擴充功能？
a.是 — 嘗試停用協力廠商擴充功能並執行部署（檢視問題是否起因），尤其是當任何錯誤中有擴充功能名稱時。
b.否 — 繼續執行步驟20。

步驟20 — 檢查緩慢查詢

長時間執行查詢？

檢查慢速查詢記錄檔和MySQL顯示處理清單。

a.是 — 刪除任何長時間執行的查詢。 檢閱MySQL Kill語法。
b.否 — 提交支援票證。

步驟21 — 降級Elasticsearch版本

正在降級Elasticsearch版本？
a.是 — 無法透過設定完成。 提交支援票證。
b.否 — 提交支援票證。

回到步驟1

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a