ドキュメントCommerceクラウドインフラストラクチャー上の Commerce に関するガイド

環境の復元

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

作成対象：

  • 開発者

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

  • Git ブランチのコードをリセットまたは元に戻します
  • Commerce アプリケーションをアンインストールします
  • 再デプロイメントを強制的に実行
  • データベースを手動でリセット
TIP
スタックしたデプロイメントのヘルプについては、Adobe Commerce ヘルプセンターの {0🔗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
05f2f56e-ac5d-4931-8cdb-764e60e16f26