文件Commerce雲端基礎結構上的 Commerce 指南

還原環境

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員

如果您在整合環境中遇到問題，而且沒有有效的備份，或是想要將環境重設為空白狀態，您可以使用下列其中一種方法來還原/重設環境：

  • 重設或還原Git分支中的程式碼
  • 解除安裝Commerce應用程式
  • 強制重新部署
  • 手動重設資料庫
TIP
若要取得停滯部署的協助，請使用​_Adobe Commerce說明中心_​中的Commerce部署疑難排解員。

重設Git分支

重設您的Git分支會將程式碼回復到過去的穩定狀態。

若要重設您的分支：

  1. 在本機工作站上，變更至專案目錄。

  2. 檢閱Git認可歷史記錄。 使用--oneline在一行中顯示縮寫的認可：

    code language-bash 
    git log --oneline

    範例回應：

    code language-none 
    6bf9f45 (HEAD -> master, magento/master, magento/develop, magento/HEAD, develop) Create composer.lock
34d7434 2.4.6 upgrade
b69803c Update composer.lock
c1bca24 Add sample data
ec604c3 Update magento/ece-tools
...

  3. 選擇代表程式碼最後已知穩定狀態的認可雜湊。

    若要將分支重設為原始初始化狀態，請尋找建立分支的第一個認可。 您可以使用--reverse以反向時間順序顯示歷史記錄。

  4. 使用硬重設選項來重設您的分支。 使用此命令時請小心，因為它會捨棄自選取認可後所做的所有變更。

    code language-bash 
    git reset --hard <commit>

  5. 推送您的變更以觸發重新部署，並重新安裝Adobe Commerce。

    code language-bash 
    git push --force <origin> <branch>

解除安裝Commerce

解除安裝Commerce應用程式會還原資料庫、移除部署組態並清除var/子目錄，讓您的環境回到原始狀態。 本指引也會將您的Git分支重設為先前的穩定狀態。 如果您最近沒有備份，但可以使用SSH存取遠端環境，請依照下列步驟還原您的環境：

  • 停用設定管理
  • 解除安裝Adobe Commerce
  • 重設Git分支

解除安裝Adobe Commerce軟體會捨棄並還原資料庫、移除部署設定，以及清除var/子目錄。 請務必停用組態管理，這樣它就不會在下次部署期間自動套用先前的組態設定。 確定您的app/etc/目錄不包含config.php檔案。

若要解除安裝Adobe Commerce軟體：

  1. 在本機工作站上，變更至專案目錄。

  2. 使用SSH登入遠端環境。

    code language-bash 
    magento-cloud ssh

  3. 移除組態檔。

    • 對於Adobe Commerce 2.2和更新版本：

      code language-bash 
      rm app/etc/config.php

    • 若為Adobe Commerce 2.1：

      code language-bash 
      rm app/etc/config.local.php

  4. 解除安裝Adobe Commerce應用程式。

    code language-bash 
    php bin/magento setup:uninstall -n

  5. 確認Adobe Commerce已成功解除安裝。

    系統會顯示下列訊息，確認解除安裝成功：

    code language-none 
    [SUCCESS]: Magento uninstallation complete.

  6. 清除var/子目錄。

    code language-bash 
    rm -rf var/*

  7. 登出。

TIP
或者，這是清理組建快取的良好做法。
code language-bash 
magento-cloud project:clear-build-cache

強制重新部署

如果您嘗試解除安裝Adobe Commerce，但部署持續失敗，您可以嘗試手動強制重新部署。

git commit --allow-empty -m "<message>" && git push <origin> <branch>

重設資料庫

如果您嘗試解除安裝Adobe Commerce，但命令失敗或無法完成，您可以手動重設資料庫。

要重設資料庫：

  1. 在本機工作站上，變更至專案目錄。

  2. 使用SSH登入遠端環境。

    code language-bash 
    magento-cloud ssh

  3. 連線到資料庫。

    code language-bash 
    mysql -h database.internal

  4. 卸除main資料庫。

    code language-shell 
    drop database main;

  5. 建立空的main資料庫。

    code language-shell 
    create database main;

  6. 刪除下列組態檔。

    • config.php
    • config.php.bak
    • env.php
    • env.php.bak

  7. 登出並觸發重新部署。

    code language-bash 
    magento-cloud environment:redeploy
WARNING
當您執行環境的合併、推播或同步處理時，或當您觸發手動重新部署時（期間的Commerce應用程式處於維護模式），部署程式即會開始。 在生產環境中，Adobe建議您在離峰時間完成這項工作，以避免服務中斷。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26