Adobe Commerce部署疑難排解員

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

說明 description

環境

雲端基礎結構上的Adobe Commerce

問題/症狀

  • 部署在環境中停滯或失敗
  • 由於其他環境中的持續活動而封鎖部署
  • 節點的SSH存取問題
  • 服務未執行(例如Elasticsearch、cron、Composer相關)
  • 磁碟空間不足或索引節點限制
  • 403/Elasticsearch版本/設定錯誤
  • 遠端叢集上載失敗或重新部署錯誤
  • 長期執行的程式、掛接後失敗或第三方擴充功能衝突
  • 查詢速度緩慢和資料庫端問題(MySQL)
  • Composer設定問題或修補限制

解決方法 resolution

步驟1 — 確認服務執行中

雲端基礎結構上的Adobe Commerce是否可正常運作?

停滯部署 — 雲端基礎結構服務上的Adobe Commerce是否正常運作? 檢查Adobe Commerce Cloud (在 Experience Cloud狀態 頁面上的Adobe下)。

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

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

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

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

code language-none
magento-cloud --state=in_progress

若要取得進行中活動的清單,請使用magento-cloud執行以下命令(如果您已新增至多個專案):

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

若要尋找現有部署活動的相關資訊(請參閱如果雲端UI有「登入已送出」錯誤,請檢查部署記錄以取得詳細資料),您可以執行此命令以取得該活動的執行記錄。

code language-none
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • 是 — 疑難排解其他環境封鎖部署。 繼續進行步驟3。
  • 否 — 疑難排解目前的環境。 繼續進行步驟3。

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

是否對所有節點成功執行SSH?

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

所有服務都在執行中?

步驟5 — 驗證Bitbucket執行中

使用Bitbucket?

步驟6 — 檢查錯誤代碼

回報的錯誤碼?
  • 是 — 繼續進行步驟7。
  • 否 — 繼續進行步驟8。

步驟7 - 403禁止的錯誤

403禁止存取?
  • 是 — 繼續進行步驟16。
  • 否 — 繼續步驟9。

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

cron工作目前正在執行嗎? 透過SSH登入分支並執行:
code language-none
ps aufxx | grep cron
  • 是 — 終止和解鎖cron工作:

    code language-none
    php vendor/bin/ece-tools cron:kill
    

    php vendor/bin/ece-tools cron:unlock

  • 否 — 繼續步驟17。

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

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

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

可用的儲存空間還好嗎?

步驟11 — 驗證磁碟空間

無法寫入檔案警告?
  • 是 —

    • 對於整合/入門環境:在.magento.app.yaml中增加磁碟值並重新部署。 如果這個方法無法運作,請提交支援票證。 或者,刪除大型記錄檔:
    code language-none
    ls -la var/log
    
  • 否 — 繼續進行步驟12。

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

環境重新部署失敗錯誤?
  • 是 — 繼續進行步驟13。
  • 否 — 繼續進行步驟8。

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

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

步驟14 — 檢查空間限制

檔案系統是否用完inode或空間?

步驟15 - Elasticsearch版本錯誤

Elasticsearch版本相關錯誤?
  • 是 — 繼續進行步驟16。
  • 否 — 繼續步驟21。

步驟16 — 驗證撰寫器設定

Composer設定是否正確?

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

長時間執行的程式?
  • 是 — 終止處理序:

    1. 執行: ps aufx
    2. 找出PID
    3. 終止: kill -9 <PID>
  • 否 — 繼續步驟18。

步驟18 — 檢查後掛接失敗

掛接後失敗/掛起?
  • 是 — 資料庫:可用磁碟空間、損毀、不完整/損毀的資料表。
  • 否 — 繼續步驟19。

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

使用協力廠商擴充功能?

步驟20 — 檢查緩慢查詢

長時間執行查詢?

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

步驟21 — 降級Elasticsearch版本

是否要降級Elasticsearch版本?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f