グローバル変数

グローバル変数は、デプロイメントプロセス Commerceの各フェーズ（ビルド、デプロイ、デプロイ後）でのアクションを制御します。 グローバル変数は各フェーズに影響を与えるため、.magento.env.yaml ファイルのglobal ステージで設定する必要があります。

stage:
  global:
    GLOBAL_VARIABLE_NAME: value

ビルドおよびデプロイプロセスのカスタマイズについて詳しくは、次を参照してください。

ENABLE_EVENTING

trueに設定すると、cronでメッセージキューコンシューマーを実行できるようになります。 Adobe I/O Events for Adobe Commerceでは、メッセージキューを使用して、重要なイベントの配信を迅速化します。

Adobeでは、cron_runがtrueに設定された.magento.env.yaml ファイルのdeploy ステージにCRON_CONSUMERS_RUNNER変数を追加することをお勧めします。

次の例は、完全に設定されたENABLE_EVENTING変数を示しています。

stage:
  global:
    ENABLE_EVENTING: true
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 0
      consumers: []

ENABLE_WEBHOOKS

trueに設定すると、CommerceのWebhookを有効にします。 Webhookは、App Builder ランタイムアクションやサードパーティの在庫管理システムなどの外部エンドポイントで実行されます。 Webhook ガイドでは、この機能について詳しく説明しています。

stage:
  global:
    ENABLE_WEBHOOKS: true

MIN_LOGGING_LEVEL

コードを変更することなく、すべての出力ストリームの最小ログレベルを上書きします。これは、デプロイメントに関する問題のトラブルシューティングに役立ちます。 例えば、デプロイメントに失敗した場合、この変数を使用して、ログの精度をグローバルに増やすことができます。 ​ ログレベル ​を参照してください。 Logging ハンドラーのmin_level値は、この設定を上書きします。

stage:
  global:
    MIN_LOGGING_LEVEL: debug

SCD_ON_DEMAND

ユーザー（SCD）から要求されたときに、静的コンテンツの生成を有効にします。 静的なオンデマンド型コンテンツは、デプロイメント時間を短縮するため、開発やテストのワークフローに最適です。

post_deploy フック ​を使用してキャッシュを事前に読み込むと、サイトのダウンタイムが短縮されます。 キャッシュ ウォーミングは、Cloud Consoleのステージング環境と実稼動環境を含むPro プロジェクトとスタータープロジェクトでのみ使用できます。 SCD_ON_DEMAND環境変数を.magento.env.yaml ファイルのglobal ステージに追加します。

stage:
  global:
    SCD_ON_DEMAND: true

SCD_ON_DEMAND変数は、SCDを両方のフェーズ（ビルドとデプロイ）でスキップし、pub/staticおよびvar/view_preprocessed フォルダーをクリアし、次の内容をapp/etc/env.php ファイルに書き込みます。

return array(
   ...
   'static_content_on_demand_in_production' => 1,
   ...
);

SCD_MAX_EXECUTION_TIME

静的コンテンツのデプロイメントで想定される最大実行時間を増やすことができます。

デフォルトでは、Adobe Commerceは想定される最大実行時間を900秒に設定しますが、一部のシナリオでは、Cloud プロジェクトの静的コンテンツのデプロイメントを完了するのに多くの時間が必要になる場合があります。

stage:
  global:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_NO_PARENT

ビルドおよびデプロイメントフェーズで親テーマの静的コンテンツを生成しないようにするには、trueに設定します。 このオプションをtrueに設定すると、より少ない静的コンテンツが生成されるので、全体的なビルドとデプロイメントの時間が短縮されます。

stage:
  global:
    SCD_NO_PARENT: true

SCD_USE_BALER

Balerは、生成されたJavaScript コードをスキャンし、最適化されたJavaScript バンドルを作成するモジュールです。 最適化されたバンドルをサイトにデプロイすると、サイトの読み込み時のネットワークリクエストの数を減らし、ページの読み込み時間を短縮できます。

静的コンテンツのデプロイメントを実行した後にBalerを実行するには、trueに設定します。

stage:
  build:
    SCD_USE_BALER: true

SKIP_HTML_MINIFICATION

ビルド ステージの最後にある<magento_root>/init/ ディレクトリへの静的ビューファイルのコピーを有効または無効にします。 trueに設定されている場合、ファイルはコピーされず、HTMLの縮小はリクエストに応じて利用できます。 この値をtrueに設定すると、ステージング環境と実稼動環境にデプロイする際のダウンタイムが短縮されます。

SKIP_HTML_MINIFICATION環境変数を.magento.env.yaml ファイルのglobal ステージに追加します。

stage:
  global:
    SKIP_HTML_MINIFICATION: true

X_FRAME_CONFIGURATION

Adobe Commerce サイトのX-Frame-Options ヘッダー設定を変更するには、X_FRAME_CONFIGURATION変数を使用します。 この設定は、ブラウザーが<frame>、<iframe>、または<object>でページをレンダリングする方法を制御します。 次のいずれかのオプションを使用します。

X_FRAME_CONFIGURATION環境変数を.magento.env.yaml ファイルのglobal ステージに追加します。

stage:
  global:
    X_FRAME_CONFIGURATION: SAMEORIGIN