Cloud Infrastructure上のAdobe CommerceのリモートリポジトリからPub/errors ファイルが同期されない

Cloud Infrastructure上のAdobe Commerceでは、ステージングインスタンスと実稼動インスタンス上のパブ/エラーファイルは、リモートリポジトリの最新バージョンを反映しません。 この問題は、デプロイメントプロセスが環境のビルド中にファイルを復元または上書きする場合に発生します。これにより、クラウドインスタンスに直接ファイルの変更が保持されません。 これを修正するには、サポートされているパッチベースのデプロイメントフローを使用して、これらのファイルを正しく同期する必要があります。

説明 description

環境

Adobe Commerce on Cloud Infrastructure

問題/症状

  • Cloud Infrastructure インスタンス上のAdobe Commerceのpub/errorsにあるファイルは、リモートリポジトリの最新バージョンを反映していません。
  • SSH上のファイル内容を比較すると、ステージングまたは実稼動環境のpub/errors ファイルがGitのファイルと異なることが示されます。
  • インスタンス上のpub/errors ファイルに直接行ったカスタマイズは、デプロイメントごとに失われるか、元に戻されます。

原因

Adobe Commerce Cloudでは、一部のファイルは、カスタムモジュールやテーマと同じ方法でプロジェクト所有されていません。 Adobe Commerceの基本パッケージ、Composerで管理される依存関係、デプロイメント時のツールは、これらのファイルを提供し、クラウドデプロイメントは、それらを再作成または上書きできます。

デプロイメント時に、Adobe Commerce Cloudは、CommerceのCloud PatchesとQuality Patches Toolと共にece-toolsを使用して、コードベースを構築および準備します。 保留中のパッチは、次の順序で適用されます。

  • Cloud Patches for Commerceから必要なCommerce パッチ
  • 品質パッチツールから選択したオプションのパッチ
  • m2-hotfixesのカスタムパッチ、パッチ名でアルファベット順に適用

その結果、デプロイメントでは、Adobe Commerce パッケージまたはComposerで管理される依存関係によって提供されるファイルを復元、再構築、またはオーバーレイできます。 サポートされているパッチフロー以外でこれらのファイルをカスタマイズすると、次のデプロイメントがこれらの変更に代わります。

解決策 resolution

デプロイメント時に、Adobe Commerce on Cloud Infrastructureは、定義された順序でパッチを適用します。 必要なCommerceのパッチと選択したオプションのパッチが処理されると、デプロイメントはm2-hotfixes ディレクトリからカスタムパッチを適用します。 このプロセスにより、あらゆるデプロイメントで一貫してカスタマイズを再適用できます。

Adobe Commerceで管理されるファイルまたはComposerで管理されるファイルへの変更を保持するには、次の手順に従います。

  1. 必要な変更のカスタムパッチを作成します。
  2. パッチをm2-hotfixesにプロジェクトのルートに配置します。
  3. パッチファイルをコミットしてプッシュします。
  4. 環境を再デプロイします。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles