ドキュメント

クラウドインフラストラクチャー上のAdobe Commerceのバージョンの不一致を解決

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

ステージング環境でのAdobe Commerceのバージョンが実稼動環境よりも古い場合、ステージング環境から実稼動環境へのデプロイメントが失敗します。 この不一致により、トリガーの互換性の問題が発生し、デプロイメントがブロックされる場合があります。 環境のバージョンを調整したり、実稼動をリセットしたりすると、問題が解決し、スムーズにデプロイメントできるようになります。

説明 description

環境

  • クラウドインフラストラクチャー上のAdobe Commerce
  • ステージング環境/実稼動環境クラスター

問題/症状

  • コードをステージング環境から実稼動環境にプッシュすると、デプロイメントパイプラインが失敗します。
  • ログは、実稼動環境でAdobe Commerceのバージョンをダウングレードしようとすることが原因でエラーが発生したことを示します。
  • ステージング環境と実稼動環境でバージョンが異なるので、互換性の問題が発生します。

解決策 resolution

メモ：
環境のリセットやデータベースの変更を行う前に、実稼動環境の完全で検証済みのバックアップがあることを確認します。 ​ スナップショット機能 ​ を使用して、バックアップを安全に作成および管理できます。

この問題を解決するには、すべての環境が実稼動環境と同じクラウドインフラストラクチャバージョンのAdobe Commerceに関連付けられていることを確認します。 次の手順に従います。

  1. 実稼動環境で使用されているバージョンに合わせてステージング環境をアップグレードします。 これにより、環境間の一貫性が確保され、デプロイメントの失敗が防がれます。 詳しくは、「Commerceのバージョンをアップグレード ​」を参照してください。
  2. ステージングをアップグレードできない場合は、ステージングと一致するように実稼動環境をリセットすることを検討してください。 続行する前に、バックアップが既に実行されていることを確認してください。 必要に応じて、既存の実稼動データベースを削除する権限を取得します。 詳しくは、​ クラウドインフラストラクチャー上のAdobe Commerceで環境をリセット ​ を参照してください。
  3. 設定ファイル（config.php）を一時的にリポジトリから削除します。
  4. setup:uninstall コマンドを使用して、Adobe Commerce ソフトウェアをアンインストールします。
  5. バージョンを調整するか環境をリセットした後で、コードベースを再デプロイします。
    • 適切な依存関係管理のために、composer.lock をリポジトリコミットに含めます。
  6. すべての変更が正常に適用されることを確認し、デプロイメント後に機能を確認します。

すべての環境で一貫したバージョンを維持したり、互換性のない設定をリセットしたりすることで、互換性の問題に遭遇することなく、スムーズなデプロイメントを確保できます。

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f