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

コンポーネント障害からのリカバリ

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • 開発者

このトピックでは、コンポーネントの適切なデプロイに失敗した場合の回復方法について説明します。 一般的な例としては、互換性のない PHP バージョンなど、リモート環境で満たされない依存関係を持つコンポーネントが挙げられます。

デプロイメントの失敗から回復するには、次のいずれかの方法があります。

クリーンアップ、削除、および再デプロイ

以前のデプロイメントからクリーンアップするには、追加または更新されたコンポーネントを特定して削除します。 まず、リモート環境にログインし、var ディレクトリの内容を手動で消去します。 次に、composer.json ファイルからコンポーネントを削除し、環境を再デプロイします。

var ディレクトリをクリーンアップするには:

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

  2. SSH を使用してリモート環境にログインします。

    code language-bash 
    magento-cloud ssh

  3. var ディレクトリをクリアします。

    code language-shell 
    rm -rf var/*

  4. ログアウトします。

コンポーネントを削除するには:

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

  2. キャッシュをクリアします。

    code language-bash 
    composer clear-cache

  3. composer.json ファイルからコンポーネントを削除します。

    code language-bash 
    composer remove <component-name>:<version>

    次のメッセージが表示された場合は、それ以上何もする必要はありません。

    code language-terminal 
    Package "<name>:<version>" listed for update is not installed. Ignoring.

  4. 依存関係を更新しています。しばらくお待ちください。

  5. コードの変更を追加、コミットおよびプッシュします。

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "<message>"
    code language-bash 
    git push origin <environment-ID>
WARNING
デプロイメントプロセスは、環境のマージ、プッシュまたは同期化を実行するとき、または Commerce アプリケーションがメンテナンスモードである場合に手動で再デプロイをトリガーするときに開始されます。 実稼動環境の場合、Adobeは、サービスが中断されないように、この作業をピーク外の時間に完了することをお勧めします。

バックアップを使用しない環境の復元について詳しくは、 環境の復元を参照してください。

TIP
スタックしたデプロイメントのヘルプについては、Adobe Commerce ヘルプセンターの {0🔗Commerce デプロイメントのトラブルシューティングツール を参照してください。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26