ECE-Tools リリースノート

OpenSearch - Adobe Commerce バージョン 2.4.4、2.4.3-p2、および2.3.7-p3のOpenSearchのサポートを追加しました。

PHP - PHP 8.1のサポートを追加しました。

symfony/process - symfony/process ^5.3.との互換性を追加しました

消費者の複数のプロセス - multiple_processes オプションを追加して、消費者ごとに生成するプロセスの数を指定できるようにしました。 変数のデプロイ ​.の「CRON_CONSUMERS_RUNNER変数の説明」を参照してください

OpenSearch スキームと完全なホストパス - Elasticsearch スキームと完全なホストパスを設定する機能を追加しました。

AWS S3 - AWS S3のイネーブルメントの方式を変更しました。

Fix driver_options reader – バリデータ用にece-toolsがenv.php ファイルからDB接続のdriver_options設定を読み取れるようにしました。

Composer 2.0のサポートを追加しました。

次のエラーでdi:compile コマンドが失敗した問題を修正するために、symphony/console​のコンポーザー要件を更新しました。symphony/console パッケージのECE-Tools composer.json バージョン要件を更新しました：Incompatible argument type: Required type: int. Actual type: string

Elasticsearch 7.9.x.が含まれるように、提供終了のソフトウェアチェック （eol.yaml）を更新しました

Redis認証資格情報 - デプロイフェーズ中にrelationships プロパティからRedis認証資格情報を読み取る機能を追加しました。

Elasticsearch認証資格情報 - デプロイフェーズ中にrelationships プロパティからElasticsearch認証資格情報を読み取る機能を追加しました。

専用セッションストレージサービス - セッションストレージの2番目のオプションとしてredis-sessionを追加しました。 redis-session サービスを使用してセッション情報を保存し、キャッシュにredis サービスを使用してパフォーマンスを向上させることができます。

非推奨のSPLIT_DB メッセージ - Adobe Commerce 2.4.2の非推奨SPLIT_DB オプションと、Adobe Commerce 2.5.0での削除に関するバリデーター警告とクリティカルメッセージを追加しました。

関係​からのElasticsearch バージョン – 修正されたサービス バリデーターを使用して、Cloud Dockerおよび統合環境のrelationships プロパティから正しいバージョンのElasticsearchを取得します。

柔軟なRedis ポート検証 - Redisは、server URLからカスタムキャッシュ接続でポートを検証できるようになりました。 例えば、次のようにサーバーURLにポート番号を追加できます：server: 'tcp://rfs-store-simple-page-cache:26379'。 これにより、port オプションが見つからないか正しくない検証エラーを防ぐことができます。

Adobe Commerce 2.4.2​へのアップグレード - Adobe Commerce 2.4.2にアップグレードした後、サイトを稼働させるためにbin/magento setup:upgradeを手動で実行する必要がある問題を修正しました。

リモートストレージ - AWS S3などのストレージサービスを使用してメディアファイルをリモートストレージするためにCloud Projectsを有効にするREMOTE_STORAGE環境変数を追加しました。 このコンフィギュレーション オプションはECE-Tools パッケージの一部ですが、Adobe Commerce クラウド インフラストラクチャではサポートされていません。

新しいcloud:config:validate コマンド - リモート クラウド環境に変更をプッシュする前に.magento.env.yaml設定を検証するコマンド php vendor/bin/ece-tools cloud:config:validateを追加しました。

opcache​のフラッシュ – デプロイフックを実行する前にOPcacheをフラッシュするopcache.enable_cli PHP オプションのサポートを追加しました。 この構成は、現在の構成設定が各デプロイメントに適用されるように、キャッシュ設定をリセットします。

Aurora DB​の検証 – Aurora データベースと互換性があるようにデータベースサービスの検証を更新しました。

新しいSCD_NO_PARENT環境変数 – 親テーマの静的コンテンツの生成を管理するためにSCD_NO_PARENT環境変数（Adobe Commerce >=2.4.2）を追加しました。

を修正​メモリ制限とコマンド - cloud.log ファイルのサイズがPHP memory_limitを超えると、php vendor/bin/ece-tools コマンドが機能しない問題を修正しました。 cloud.log ファイル全体をメモリに読み込む代わりに、ログファイルからより小さなデータのサブセットのみを読み取るようになりました。

カスタムデータベース接続 - DATABASE_CONFIGURATIONに対して定義されたカスタムデータベース接続が使用されなかった.magento.env.yaml設定の問題を修正しました。 接続設定がapp/etc/env.phpに追加されませんでした。

空のエラーログ - cloud.error.logが空の場合にデプロイメントが失敗する問題を修正しました。

MariaDB 10.3検証—Adobe Commerce 2.3.6-p1に対するMariaDB 10.3の検証を修正しました。

キャッシュ :flush ログ - ログ エントリを改善して、cache:flush ステップの開始と終了を示しました。

静的コンテンツがビルド段階でデプロイするように設定されている場合に、読み取り専用pub/static ディレクトリに対するECE-Tools サポートを追加しました。

今後のAdobe Commerce リリースとの互換性を保つため、Elasticsearch 7.9とRedis 6のサポートが追加されました。

ECE-Tools composer.jsonを更新して、品質パッチツールに必要な依存関係を追加しました。 これにより、ECE-Tools パッケージとmagento-cloud-patches パッケージの間に存在していた循環依存関係が修正されます。

クラウドインフラストラクチャ 2.4以降でelasticsearchがAdobe Commerce用に設定されていることを確認するために、検索エンジンの検証を追加しました。 検証が失敗した場合、デプロイメントは停止され、問題の修正を示唆する重要なエラーメッセージが表示されます。 ​ クリティカルエラー、デプロイステージ ​を参照してください。

Elasticsearch サービス版とAdobe Commerce版の互換性を確認するためのElasticsearch検証を追加しました。

Adobe Commerce Elasticsearch モジュールと互換性のあるElasticsearchのバージョンを表示するように、Elasticsearchの互換性に関するエラーメッセージを更新しました。 これで、お使いのバージョンのAdobe Commerceで使用されているElasticsearch モジュールと互換性を持つように、クラウドインフラストラクチャにインストールする特定のElasticsearch バージョンがエラーメッセージに表示されました。 警告エラー、デプロイステージ ​を参照してください。

無効なMAGE_MODE環境変数設定に対する警告エラー2026と2027を追加しました。 有効な値はproductionのみです。 この修正を行う前は、デプロイメントエラーなしでMAGE_MODEをdeveloperに設定できましたが、読み取り専用ファイルへの書き込み時に後でエラーが発生する可能性がありました。 警告エラーを参照してください。

これらのバージョンがAdobe Commerce バージョンと互換性があることを確認するために、Redis、RabbitMQ、およびMySQL サービスの検証を修正しました。 これらのサービスの有効なバージョンがcloud.log.に書き込まれるようになりました

キャッシュ ウォームアップ中にリクエストを送信するための同時要求の制限を含めるようにcloud.logを更新しました。 この値は、WARM_UP_CONCURRENCYのデプロイ後の変数で設定されます。

ビルド、デプロイ、デプロイ後のプロセス中に発生する可能性のあるすべてのエラーと警告の通知と、エラーを解決するための提案を含むschema.error.yaml ファイルを追加しました。 このファイルの情報は、Commerce向けクラウドガイド​でも入手できます。 e-tools🔗の エラーメッセージ参照を参照してください。

Cloud エラーログ （/var/log/cloud.error.log）のエントリをJSON形式に変更し、ログをプログラムで解析しやすくしました。

処理のビルド、デプロイ、デプロイ後に追加のエラーチェックを追加し、既存のチェックを改善しました。

• エラーコード 2026：ビルド フェーズで生成された一部のデータをマウントされたディレクトリに復元できませんでした

• エラーコード 3004 - バックアップ ファイルを作成できません

• エラーコード 102 - env.php ファイルが書き込み可能でない場合に発生する問題を確認するための追加チェックを追加しました

QUALITY_PATCHES​環境変数を追加して、デプロイメントプロセス中に適用する1つ以上の品質パッチを指定しました。 ​ ビルド変数を参照してください。

インフラストラクチャの更新—

• 改善のログ記録 – 終了コードを重大なデプロイエラーに割り当て、エラーメッセージ通知とログイベントで終了コードを公開することで、ログ追跡機能を改善しました。 e-tools🔗の エラーメッセージ参照を参照してください。

• データベース ダンプ （vendor/bin/ece-tools db-dump）のプロセスを改善し、ログ メッセージを更新して、データベース ダンプ操作がアプリケーションをメンテナンスモードに切り替え、コンシューマーのキュー処理を停止し、ダンプが開始される前にcron ジョブを無効にすることを明確にしました。

• ステージング環境と実稼動環境にデプロイする際に、プロジェクト URLが正しく更新されるように問題を修正しました。 現在、ece-toolsは、プロジェクトのルート設定でprimary:true属性が設定されたルートのURLを使用しています。 変数のデプロイ ​を参照してください。

• パッチを適用するためのgenerate.xml ビルドシナリオワークフローを更新しました。 Adobe Commerceを更新して、di:compileとmodule:refreshの手順が失敗する可能性がある問題を修正するには、パッチを早めに適用する必要があります。

• インストールプロセスで、Crypt key missing エラーが誤って返される問題を修正しました。 crypt/key値は、インストール中に自動的に生成されます。

サービスの更新—

• PHP 7.4およびMariaDB 10.4のサポートを追加しました。

環境変数の更新—

• SCD_USE_BALER​変数を追加して、Adobe Commerce on cloud インフラストラクチャのビルドプロセス中にJavaScript バンドル用のBaler モジュールを有効にしました。 ​ ビルド変数の変数の説明を参照してください。

• Adobe Commerce 2.3.5以降のRedis キャッシュ用のRedis バックエンドモデルを設定するために、REDIS_BACKEND​環境変数を追加しました。 変数の説明については、変数のデプロイ ​を参照してください。

CLI コマンドの更新—

• 次のCLI コマンドを、詳細なログ記録のオプション付きで更新しました。

  • app:config:dump
  • app:config:import
  • module:enable

  各呼び出しのログレベルは、.magento.env.yaml ファイルのVERBOSE_COMMANDS変数の設定によって決まります。

検証の改善—

• Elasticsearch 7.xの互換性チェック - Elasticsearch 7.x ソフトウェアの互換性チェック用のElasticsearch検証を更新しました。

• サービスのバージョンとEOL検証チェック​を更新しました。インストール済みのサービスのバージョンをAdobe Commerce 2.4に照らし合わせてチェックするための検証を更新しました。 要件。

• 次のデプロイ後の警告メッセージが.magento.app.yaml ファイルにpost-deploy フック設定がない場合にのみ表示されるように、検証の問題を修正しました。

  code language-text
  Your application does not have the "post_deploy" hook enabled.

• Zend Framework依存関係の検証を追加 - Laminas プロジェクトに移行したZend Frameworkのコンポーザー依存関係の検証を追加しました。 必要な依存関係がない場合は、ビルドプロセス中に次のエラーメッセージが表示されます。

  code language-text
  Required configuration is missing from the autoload section of the composer.json file. Add ("Laminas\Mvc\Controller\Zend\": "setupsrc/ Zend/Mvc/Controller/") to the `autoload -> psr-4` section. Then, re-run the "composer update" command locally, and commit the updated composer.json and composer.lock files.

  Zend Frameworkの依存関係の確認を参照してください。

• 追加されたenv.php ファイルとデータ​の検証 – インストールおよびアップグレードのプロセス中にenv.php ファイルとデータのチェックを追加しました。

  • インストールにenv.php ファイルが見つからず、crypt/key値が.magento.app.yaml ファイルで指定されていない場合、デプロイメントは次の通知で失敗します。

    code language-text
    The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable``Missing crypt key for upgrading Magento`.

  • インストールにenv.php ファイルが含まれていない場合、または設定に1つのキャッシュの種類しか含まれていない場合は、cron:enable コマンドがアップグレードプロセス中に実行され、すべてのcache_typesを含むファイルが復元されます。 次の通知がログに追加されます。

    code language-text
    Magento state indicated as installed but configuration file app/etc/env.php was empty or did not exist. Required data will be restored from environment configurations and from the .magento.env.yaml file.

インフラストラクチャの更新—

• Commerce用Cloud Docker用の個別のパッケージを追加しました - Docker パッケージをece-tools パッケージから切り離して、コードの品質を維持し、独立したリリースを提供しました。 ece-toolsに関連する更新と修正は、magento-cloud-docker GitHub リポジトリから管理されます。

• パッチ機能を更新 - パッチ機能をECE-Tools パッケージから別のmagento-cloud-patches パッケージに移動しました。 デプロイメント中、ece-toolsは新しいパッケージを使用してパッチを適用します。 Cloud パッチリリースノート ​を参照してください。

• Composerの依存関係​を更新 – magento/magento-cloud-docker パッケージの依存関係を持つクラウドインフラストラクチャ上のAdobe Commerceのcomposer.json ファイルを更新しました。 現在、ece-toolsには、Cloud Tools Suite for Commerce内のすべてのパッケージの依存関係が含まれています。 これらのパッケージは、ece-toolsをインストールまたは更新すると、自動的にインストールおよび更新されます。

シナリオベースのデプロイメントのサポート—

• XML設定ファイルを使用して、ビルド、デプロイ、デプロイ後のプロセスをカスタマイズし、デフォルト設定を上書きまたはカスタマイズできるようになりました。

• .magento.app.yaml​のhooks設定を変更しました。シナリオベースのデプロイメントをサポートするようにhooks設定形式を更新しました。 以前のECE-Tools 2002.0.x リリースの従来の形式は、引き続きサポートされています。 ただし、シナリオベースのデプロイメント機能を使用するには、新しい形式に更新する必要があります。 ​ シナリオベースのデプロイメント ​を参照してください。

サービスの更新—

• PHP 7.3のサポートを追加しました。

• RabbitMQ 3.8.のサポートを追加しました

• 各サービスのインストール済みサービスのバージョンをEOL日に照らし合わせて確認するための検証を追加しました。 現在、サービスのバージョンが終了日から3か月以内の場合は通知が表示され、終了日が過去の場合は警告が表示されます。

• Elasticsearchの設定に関する問題を修正し、すべての環境で正しいElasticsearch設定が行われるようにしました。

環境変数の更新—

• 特定の製品ページのキャッシュのプリロードをサポートするために、WARM_UP_PAGES環境変数の機能を拡張しました。 展開された定義については、展開した後の変数 トピックを参照してください。

• <magento_root>/var/report/ ディレクトリのエラーレポート データ管理を簡素化するために、ERROR_REPORT_DIR_NESTING_LEVEL環境変数を追加しました。 ​ ビルド変数 トピックの変数の説明を参照してください。

• SCD_EXCLUDE_THEMES、STATIC_CONTENT_THREADS、DO_DEPLOY_STATIC_CONTENTおよびSTATIC_CONTENT_SYMLINK環境変数を削除しました。 下位互換性のない変更を参照してください。

• _merge オプションを使用せずにELASTICSUITE_CONFIGURATION デプロイ変数を設定すると、デフォルト設定が期待どおりに上書きされるように、Elastic Suite設定プロセスの問題を修正しました。

CLI コマンドの更新—

• 新しいcron コマンド - cron:disableおよびcron:enable コマンドを使用して、Adobe Commerce on cloud infrastructure environmentでcron処理を手動で管理できるようになりました。 disable コマンドを使用して、アクティブなすべてのcron プロセスを停止し、すべてのcron ジョブを無効にします。 準備ができたら、enable コマンドを使用してcron ジョブを再度有効にします。 「cron ジョブを無効にする」を参照してください。

• エラーレポートの改善 - ECE-Tools処理中に発生するCLI コマンドのエラーに関するログの改善が追加されました。

• 非推奨のビルドコマンドを削除 – 次のビルドコマンドを削除しました：m2-ece-build、m2-ece-deploy、m2-ece-scd-dump、およびece-tools docker コマンドの名前をece-dockerに変更しました。 下位互換性のない変更を参照してください

非推奨のbuild_options.ini ファイルを削除し、ファイルが存在する場合にビルドを失敗する検証を追加しました。 ビルドオプションを設定するには、.magento.env.yaml ファイルを使用します。

config.php ファイルが空の場合にビルド プロセスが失敗する問題を修正しました。