クラウド固有の変数

最終更新日： 2026年6月2日

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

作成対象：

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

クラウドインフラストラクチャ上のAdobe Commerceに固有の環境変数では、MAGENTO_CLOUD_*接頭辞が使用されます。

変数

説明

MAGENTO_CLOUD_APP_DIR

アプリケーションディレクトリへの絶対パス。

MAGENTO_CLOUD_APPLICATION

アプリケーションを記述するbase64 エンコード JSON オブジェクト。これは.magento.app.yaml ファイルの内容にマッピングされ、サブキーを持ちます。

MAGENTO_CLOUD_APPLICATION_NAME

.magento.app.yaml ファイルで設定されたアプリケーションの名前。

MAGENTO_CLOUD_DOCUMENT_ROOT

Web ドキュメントのルートへの絶対パス（該当する場合）。

MAGENTO_CLOUD_ENVIRONMENT

環境ブランチの名前。

MAGENTO_CLOUD_PROJECT

プロジェクト ID。

MAGENTO_CLOUD_RELATIONSHIPS

キー（関係名）と値（関係ペアの配列）のエンドポイント定義を表す、base64 エンコードされたJSON オブジェクト。各関係エンドポイント定義は、URLの分解形式です。 scheme、a host、a port、およびオプションで、a username、password、path、および一部の追加情報がqueryにあります。

MAGENTO_CLOUD_ROUTES

環境.magento/routes.yaml ファイルで定義されたルートを記述します。

MAGENTO_CLOUD_TREE_ID

アプリケーションのツリーID。GitのツリーのSHAに対応します。

MAGENTO_CLOUD_VARIABLES

キーと値のペア（"key":"value"など）を持つbase64 エンコードされたJSON オブジェクト。

MAGENTO_CLOUD_LOCKS_DIR

クラウドインフラストラクチャ上のロックプロバイダーのマウントポイントへのパスを提供します。ロックプロバイダーは、重複したcron ジョブとcron グループの起動を防ぎます。

fileおよびdb ロックプロバイダーのみがサポートされています。

Proの実稼動環境とステージング環境は、file ロックプロバイダーにデフォルトで設定されています。この値は変更できません。

Pro統合およびスターター環境は、MAGENTO_CLOUD_LOCKS_DIR変数を使用しません。 db ロックプロバイダーはデフォルトで適用されます。 .magento.env.yaml ファイルの[LOCK_PROVIDER](variables-deploy.md#lock_provider環境デプロイ変数を更新することで、デフォルト値を変更できます。

WARNING

Cloud Consoleを使用して環境変数をオーバーライド構成設定に追加するには、次の例のように、変数名の前にenv:を付ける必要があります。

値は時間の経過とともに変化する可能性があるため、実行時に変数を検査し、それを使用してアプリケーションを設定するのが最善です。例えば、MAGENTO_CLOUD_RELATIONSHIPS変数を使用して、環境関連の関係を次のように取得します。

<?php
/**
  * Get relationships information from cloud environment variable.
  *
  * @return mixed
  */
    protected function getRelationships()
    {
        return json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"]), true);
    }

環境変数の表示

ece-tools パッケージ 🔗のからenv:config:show コマンドを使用して、現在の環境の変数のリストを表示できます。

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

variables オプションの出力例：

Magento Cloud Environment Variables:
+-----------------------------------+----------------------------------+
| Variable name                     | Value                            |
+-----------------------------------+----------------------------------+
| ADMIN_EMAIL                       | commerceadmin@company.com        |
| ADMIN_PASSWORD                    | 123123q                          |
+-----------------------------------+----------------------------------+

recommendation-more-help

commerce-on-cloud-help-cloud-guide