ECE-Tools リリースノート

OpenSearch—Adobe Commerce バージョン 2.4.4、2.4.3-p2 および 2.3.7-p3 の OpenSearch がサポートされるようになりました。

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

交信/プロセス— symfony/process ^5.3 との互換性を追加しました。

コンシューマーの複数のプロセス – が追加されました multiple_processes 各コンシューマーに対して発生するプロセスの数を指定できるオプション。 を参照してください。 CRON_CONSUMERS_RUNNER での変数の説明 変数のデプロイ.

OpenSearch スキームと完全なホスト パス—Elasticsearchスキームとフルホストパスを設定する機能が追加されました。

AWS S3—AWS S3 有効化の手法を変更しました。

driver_options リーダーの修正 – から DB 接続のための driver_options 設定の読み込みを追加しました。 env.php ファイル作成者 ece-tools （バリデーター用）。

Composer 2.0 がサポートされるようになりました。

のコンポーザー要件を更新しましたsymphony/console— ECE ツールを更新しました。 composer.json のバージョン要件 symphony/console の原因となった問題を修正するパッケージ di:compile 次のエラーで失敗するコマンド： Incompatible argument type: Required type: int. Actual type: string

サポート終了のソフトウェアチェック （eol.yaml）を選択して、Elasticsearch 7.9.x を含めます。

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

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

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

非推奨の SPLIT_DB メッセージ – 非推奨のについて、バリデーターの警告と重要なメッセージを追加しました SPLIT_DB Adobe Commerce 2.4.2 のオプションとAdobe Commerce 2.5.0 での削除。

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

柔軟な Redis ポート検証— Redis は、からカスタム キャッシュ接続のポートを検証できるようになりました。 server URL。 例えば、次のようにポート番号をサーバー URL に追加できます。 server: 'tcp://rfs-store-simple-page-cache:26379'. これは、以下の場所で検証エラーが発生するのを防ぐのに役立ちます port オプションがないか、間違っています。

Adobe Commerce 2.4.2 へのアップグレード – ユーザーが手動で実行する必要があった問題を修正しました bin/magento setup:upgrade Adobe Commerce 2.4.2 へのアップグレード後にサイトを使用可能にする場合

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

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

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

Aurora DB の検証- Aurora データベースと互換性を持つように、データベースサービスの検証を更新しました。

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

メモリ制限とコマンド – 問題を修正しました。 php vendor/bin/ece-tools のサイズがの場合、コマンドが機能しない cloud.log ファイルが PHP の memory_limit を超えました。 全体を読む代わりに cloud.log ファイルをメモリに読み込む場合、ログファイルから読み取られるデータは、比較的小さくなっています。

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

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

MariaDB 10.3 検証- Adobe Commerce 2.3.6-p1 の MariaDB 10.3 の検証を修正しました。

キャッシュ：フラッシュ ログ – の開始と終了を示すログエントリを改善しました。 cache:flush ステップ。

読み取り専用のの ECE ツールのサポートを追加 pub/static ビルドステージで静的コンテンツがデプロイされるように設定されている場合のディレクトリ。

今後のAdobe Commerce リリースとの互換性のために、Elasticsearch 7.9 および Redis 6 がサポートされるようになりました。

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

を確認するための検索エンジン検証を追加しました elasticsearch は、cloud infrastructure 2.4 以降のAdobe Commerce用に設定されています。 検証に失敗した場合、デプロイメントは停止され、問題の修正を示唆する重要なエラーメッセージが表示されます。 参照： 重大なエラー、展開ステージ.

ElasticsearchサービスのバージョンとAdobe Commerceのバージョンの間のElasticsearchを確認するための互換性の検証が追加されました。

Adobe Commerce Elasticsearchモジュールと互換性のあるElasticsearchのバージョンを示すように、Elasticsearch互換性エラーメッセージを更新しました。 お使いのバージョンのAdobe Commerceで使用されているElasticsearchモジュールと互換性を持たせるために、エラーメッセージに、クラウドインフラストラクチャにインストールする具体的なElasticsearchバージョンが表示されるようになりました。 参照： 警告エラー、ステージのデプロイ.

警告エラーを追加しました 2026 および 2027 無効の MAGE_MODE 環境変数の設定 有効な値はのみです。 production. この修正の前に、 MAGE_MODE はに設定できます。 developer 配置エラーがない場合は、読み取り専用ファイルに書き込もうとした後でエラーが発生する場合にのみ使用します。 参照： 警告エラー.

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

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

さんがを追加しました schema.error.yaml ビルド、デプロイ、デプロイ後のプロセス中に発生する可能性のあるすべてのエラーおよび警告通知と、エラーを解決するための提案を含むファイルです。 このファイル内の情報は、 Commerceのクラウドガイド. 参照： ece-tools のエラーメッセージ参照.

クラウドエラーログ（/var/log/cloud.error.log） エントリを JSON 形式に変換して、ログをプログラムで解析しやすくします。

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

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

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

• エラーコード 102 – が env.php ファイルは書き込み可能ではありません

さんがを追加しました QUALITY_PATCH 環境変数。デプロイメントプロセス中に適用する 1 つ以上の品質向上パッチを指定します。 参照： ビルド変数.

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

• ログの改善 – 重要なデプロイ・エラーに終了コードを割り当て、エラー・メッセージ通知とログ・イベントに終了コードを公開することで、ログ・トラッキング機能を向上させます。 参照： ece-tools のエラーメッセージ参照.

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

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

• が更新されました generate.xml パッチを適用するためのシナリオ作成ワークフローを作成します。 Adobe Commerceを更新して、 di:compile および module:refresh 失敗する手順。

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

サービスの更新—

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

環境変数の更新—

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

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

CLI コマンドの更新—

• より詳細なログを記録するためのオプションを追加して、次の CLI コマンドを更新しました。

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

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

検証の改善—

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

• サービスバージョンと EOL 検証チェックを更新しました – インストールされているサービスバージョンをAdobe Commerce 2.4 の要件と照合するように検証を更新しました。

• 検証の問題を修正して、デプロイ後の警告メッセージが post-deploy にフック設定がありません .magento.app.yaml ファイル：

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

• Zend フレームワークの依存関係の検証を追加しました- Laminas プロジェクトに移行した Zend フレームワークに composer 依存関係の検証を追加しました。 必要な依存関係が見つからない場合は、ビルドプロセス中に次のエラーメッセージが表示されます。

  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 フレームワークの依存関係の検証.

• の検証を追加しました 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.

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

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

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

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

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

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

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

サービスの更新—

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

• RabbitMQ 3.8 がサポートされるようになりました。

• 各サービスの EOL 日付に対してインストール済みサービスバージョンを確認するための検証を追加しました。 現在は、サービスのバージョンが提供終了（EOL）日から 3 か月以内の場合は通知が届き、提供終了（EOL）日が過去の場合は警告が届きます。

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

環境変数の更新—

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

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

• がを削除しました SCD_EXCLUDE_THEMES, STATIC_CONTENT_THREADS,DO_DEPLOY_STATIC_CONTENT、および STATIC_CONTENT_SYMLINK 環境変数。 参照： 後方互換性のない変更.

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

CLI コマンドの更新—

• 新しい cron コマンド – クラウドインフラストラクチャ上のAdobe Commerceで、を使用して、cron 処理を手動で管理できるようになりました cron:disable および cron:enable コマンド。 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 ファイルは空です。