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 scheme and full host path—Elasticsearchスキームとフルホストパスを設定する機能が追加されました。

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

Fix driver_options reader—env.php ファイルから DB 接続用の driver_options 設定を読み取り、バリデータを ece-tools び出す機能を追加しました。

Composer 2.0. のサポートを追加

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

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

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 ポート検証—server URL からカスタムキャッシュ接続のポートを検証できるようになりました。 例えば、server: 'tcp://rfs-store-simple-page-cache:26379' のようにポート番号をサーバー URL に追加できます。 これは、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 validation—Adobe Commerce 2.3.6-p1. の MariaDB 10.3 の検証を修正しました。

Cache:flush logging—cache:flush のステップの開始と終了を示すようにログ・エントリを改善しました。

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

今後のAdobe Commerce リリースとの互換性のために、Elasticsearch 7.9 および Redis 6 のサポートを追加。

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

検索エンジンの検証が追加され、Cloud Infrastructure 2.4 以降のAdobe Commerceに対して elasticsearch が設定されていることを確認できるようになりました。 検証に失敗した場合、デプロイメントは停止され、問題の修正を示唆する重要なエラーメッセージが表示されます。 重大なエラー、デプロイステージを参照してください。

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

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

無効な MAGE_MODE 環境変数の設定に対する警告エラー 2026 と 2027 を追加しました。 有効な値は 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_ENVIRONMENT PATCH変数を追加し、デプロイメントプロセス中に適用する 1 つ以上のクオリティパッチを指定しました。 ビルド変数を参照してください。

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

• ログの改善 – 重要なデプロイ・エラーに終了コードを割り当て、エラー・メッセージ通知とログ・イベントに終了コードを公開することで、ログ追跡機能を向上しました。 ece-tools のエラーメッセージのリファレンスを参照してください 。

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

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

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

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

サービスのアップデート—

• PHP 7.4 および MariaDB 10.4. のサポートを追加

環境変数の更新—

• クラウドインフラストラクチャー上のAdobe Commerceのビルドプロセス中にJavaScriptのバンドル用に Baler モジュールを有効にするための SCD_USE_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 フレームワークの依存関係の検証を追加—Laminas プロジェクトに移行した Zend フレームワークのコンポーザーの依存関係の検証を追加しました。 必要な依存関係が見つからない場合は、ビルドプロセス中に次のエラーメッセージが表示されます。

  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.