ドキュメントCommerceCommerce on Cloud

コンポーネントの障害からの復旧

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

作成対象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

このトピックでは、コンポーネントが適切にデプロイできない場合の回復方法について説明します。 一般的な例としては、互換性のない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-none 
    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 ヘルプセンター​のCommerce デプロイメントのトラブルシューティング ​を参照してください。
recommendation-more-help
commerce-on-cloud-help-cloud-guide