ECE-Tools パッケージ

最終更新日： 2026年1月26日

トピック：
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

作成対象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

ECE-Tools パッケージは、Commerce アプリケーションを管理およびデプロイするために設計されたスクリプトとツールのセットです。 ece-tools パッケージは、cron ジョブの管理、プロジェクト設定の検証、Adobeのパッチとホットフィックスの適用など、多くのプロセスを簡素化します。 GitHub🔗でオープンソース ECE-Tools コードリポジトリを表示して貢献できます。

NOTE

ece-tools パッケージを含まないクラウドインフラストラクチャでAdobe Commerceのバージョンを使用する場合は、非推奨パッケージを削除するために、クラウドプロジェクトに1回アップグレードを実行する必要があります。現在ece-tools パッケージを使用しており、それを更新する必要がある場合は、ECE-Tools パッケージの更新を参照してください。

ece-tools パッケージは、バージョン 2.1.4以降のAdobe Commerceと互換性があり、コードの管理とプロジェクトの自動ビルドおよびデプロイに役立つスクリプトとAdobe Commerce on cloud infrastructure コマンドが含まれています。

使用可能なece-tools コマンドを次に示します。

php ./vendor/bin/ece-tools list

ビルドとデプロイ

ece-tools パッケージには、Adobe Commerce on cloud infrastructure アプリケーションを起動するビルド、デプロイ、デプロイ後の各ステージの操作を実行するコマンドが含まれています。例えば、php ./vendor/bin/ece-tools build コマンドは、アプリケーションのビルドプロセスを開始します。

デフォルトでは、これらのece-tools コマンドは.magento.app.yaml設定ファイルのhook プロパティにあります。

Docker設定ジェネレーター

ece-tools パッケージには、magento/magento-cloud-docker パッケージの依存関係が含まれています。このパッケージは、Docker イメージでAdobe CommerceのDocker開発環境をクラウドインフラストラクチャ上で起動するための機能と設定ファイルを提供します。また、Commerce用Cloud Dockerをスタンドアロンパッケージとして実行することもできます。 Docker開発を参照してください。

サービス、ルート、変数

ece-tools パッケージを使用すると、任意のCloud環境で使用されているBase64 エンコードされたCloud variablesに関する詳細情報を表示できます。次のコマンドは、すべてのサービス、ルートおよび変数を示します。

php ./vendor/bin/ece-tools env:config:show

特定の情報セットを表示するには、次の形式を使用します。

php ./vendor/bin/ece-tools env:config:show <option>

services - services.yaml ファイルで定義されているMAGENTO_CLOUD_RELATIONSHIPS環境変数の関係データを表示します。
routes - MAGENTO_CLOUD_ROUTES環境変数を使用してプロジェクトの設定済みルートを表示します。
variables - MAGENTO_CLOUD_VARIABLES環境変数を使用して、プロジェクトに設定された変数を表示します。

services オプションの出力例：

Magento Cloud Services:
+-----------------------------------+----------------------------------+
| Service Configuration             | Value                            |
+-----------------------------------+----------------------------------+
| database:                                                            |
+-----------------------------------+----------------------------------+
| host                              | 127.0.0.1                        |
| password                          | <password>                       |
| port                              | 3306                             |
+-----------------------------------+----------------------------------+
| opensearch:                                                          |
+-----------------------------------+----------------------------------+
| host                              | 127.0.0.1                        |
| port                              | 9200                             |
...

環境設定の確認

プロジェクトの設定を評価するのに役立つ確認コマンドのセットがあります。各ウィザードコマンドの詳細については、「デプロイメントの最適化」セクションの「スマートウィザード」を参照してください。 wizard:ideal-state コマンドは、ビルドフェーズ中に自動的に実行されます。プロジェクトの理想的な状態を確認するには：

php ./vendor/bin/ece-tools wizard:ideal-state

NOTE

リモートクラウド環境でwizard:ideal-state コマンドを実行する必要があります。このコマンドは、ローカル開発環境で実行すると、常にThe configured state is not ideal エラーを返します。

出力サンプル：

Ideal state is configured

ece-tools🔗のリリースノートを参照してください。

Adobeのパッチとカスタムパッチ

ece-tools パッケージには、magento/magento-cloud-patches パッケージの依存関係が含まれています。このパッケージは、Adobeのパッチとホットフィックスを提供し、すべてのAdobe Commerce バージョンとCloud環境の統合を向上させ、重要な修正の迅速な提供をサポートします。「」は、Adobe Commerce on cloud infrastructure プロジェクトに追加するカスタムパッチも提供します。パッチの適用を参照してください。

recommendation-more-help

commerce-on-cloud-help-cloud-guide