ドキュメントCommerceCommerce on Cloud

環境の復元

最終更新日： 2025年10月14日

作成対象：

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

統合環境で問題が発生し、有効なバックアップ ​がない場合、または環境を空白のスレートにリセットする場合は、次のいずれかの方法で環境を復元またはリセットできます。

  • Git ブランチのコードをリセットまたは元に戻す
  • Commerce アプリケーションのアンインストール
  • 再展開の強制
  • データベースを手動でリセット
TIP
デプロイメントが停止している場合は、Adobe Commerce ヘルプセンター​のCommerce デプロイメントのトラブルシューティング ​を参照してください。

Git ブランチをリセットする

Git ブランチをリセットすると、コードは以前の安定した状態に戻ります。

ブランチをリセットするには:

  1. ローカル ワークステーションで、プロジェクト ディレクトリに移動します。

  2. Git コミット履歴を確認します。 --onelineを使用して、1行に省略されたコミットを表示します。

    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
commerce-on-cloud-help-cloud-guide