ドキュメントCommerceCommerce on Cloud

ビルド変数

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

作成対象：

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

次の​ ビルド ​変数は、ビルド フェーズのアクションを制御し、​ グローバル変数から値を継承して上書きできます。 これらの変数を.magento.env.yaml ファイルのbuild ステージに挿入します。

stage:
  build:
    BUILD_VARIABLE_NAME: value

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

v2.2では、次の変数が削除されました。

  • skip_di_clearing
  • skip_di_compilation

ERROR_REPORT_DIR_NESTING_LEVEL

  • Default—1
  • バージョン - Adobe Commerce 2.1.4以降

エラーレポートファイルを保存するためのディレクトリネストのレベルを設定して、レポートディレクトリに数万ファイルを入力しないようにします。これにより、データの管理とレビューが困難になる可能性があります。 この設定はデフォルトで1です。 通常、<magento_root>/var/report/ ディレクトリでのエラーレポートファイルの管理に問題がある場合を除き、デフォルト値を変更する必要はありません。

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

  • 既定—設定なし
  • バージョン - Adobe Commerce 2.1.4以降

デプロイメント時に適用するAdobe Commerce品質パッチのリストを指定します。

stage:
  build:
    QUALITY_PATCHES: [ ]

次の例では、デプロイメント時に適用する3つのパッチを指定します。

stage:
  build:
    QUALITY_PATCHES:
      - MC-31387
      - MDVA-4567
      - MC-456345

​ パッチの適用を参照してください。

SCD_COMPRESSION_LEVEL

  • Default—6
  • バージョン - Adobe Commerce 2.1.4以降

静的コンテンツを圧縮する際に使用するgzip圧縮レベル （0 ～ 9）を指定します。0は圧縮を無効にします。

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

  • Default—600
  • バージョン - Adobe Commerce 2.1.4以降

静的アセットの圧縮にかかる時間が圧縮タイムアウトの制限を超えると、デプロイメントプロセスが中断されます。 静的コンテンツ圧縮コマンドの最大実行時間を秒単位で設定します。

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_NO_PARENT

  • Default—false
  • バージョン - Adobe Commerce 2.4.2以降

ビルド フェーズで親テーマの静的コンテンツを生成しないようにするには、trueに設定します。

親テーマの静的コンテンツを生成しても、サイトの展開に影響を与えたり、不要なサイトのダウンタイムが発生したりしないように、ビルド段階でSCD_NO_PARENT: falseを設定します。 静的コンテンツ展開を参照してください。

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

  • 既定—設定なし
  • バージョン - Adobe Commerce 2.1.4以降

テーマごとに複数のロケールを設定できます。 このカスタマイズは、不要なテーマファイルの数を減らすことによって、ビルドプロセスを高速化するのに役立ちます。 例えば、英語で​magento/backend テーマを作成し、他の言語でカスタムテーマを作成できます。

次の例では、3つのロケールを持つMagento/backend テーマを構築します。

stage:
  build:
    SCD_MATRIX:
      "Magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA

次の例では、3つのロケールを持つ3つのテーマを構築します。

stage:
  build:
    SCD_MATRIX:
      "Magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA
      "Magento/blank":
        language:
          - en_US
          - fr_FR
          - af_ZA
      "Magento/luma":
        language:
          - en_US
          - fr_FR
          - af_ZA

または、テーマを​not デプロイするように選択できます。

stage:
  build:
    SCD_MATRIX:
      "Magento/backend": [ ]

SCD_MAX_EXECUTION_TIME

  • 既定—設定なし
  • バージョン - Adobe Commerce 2.2.0以降

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

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

stage:
  build:
    SCD_MAX_EXECUTION_TIME: 3600
WARNING
カスタムテーマファイルが見つからないなど、デプロイメント後にアプリケーションの静的コンテンツファイルに問題が発生した場合は、想定される最大実行時間を900秒以上に増やします。

SCD_STRATEGY

  • Default—quick
  • バージョン - Adobe Commerce 2.2.0以降

静的コンテンツの​ デプロイメント戦略をカスタマイズします。 静的ビューファイルのデプロイ ​を参照してください。

複数のロケールがある場合は、次のオプション のみ​を使用します。

  • standard – すべてのパッケージのすべての静的ビューファイルをデプロイします。
  • quick – （default）は、デプロイメント時間を最小限に抑えます。
  • compact - サーバー上のディスク領域を節約します。 Adobe Commerce バージョン 2.2.4以前では、この設定はscd_threadsの値を1の値で上書きします。
stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

  • Default – 自動
  • バージョン - Adobe Commerce 2.1.4以降

静的コンテンツのデプロイメント用のスレッド数を設定します。 デフォルト値は、検出されたCPU スレッド数に基づいて設定され、値4を超えることはありません。 スレッド数を増やすと、静的コンテンツのデプロイメントが高速化されます。スレッド数を減らすと、速度が低下します。 スレッドの値を設定できます。例：

stage:
  build:
    SCD_THREADS: 2

デプロイメントの時間をさらに短縮するには、scd-dump コマンドで構成管理を使用して、静的デプロイメントをビルド フェーズに移動します。

SCD_USE_BALER

  • 既定—設定なし
  • バージョン - Adobe Commerce 2.3.0以降

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

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

stage:
  build:
    SCD_USE_BALER: true
NOTE
Balerはアルファリリースであるため、実稼動環境で使用することはお勧めできません。

SKIP_COMPOSER_DUMP_AUTOLOAD

  • Default— 設定なし
  • バージョン - Adobe Commerce 2.1.4以降

Cloud Dockerのインストール中にcomposer dump-autoload コマンドをスキップするには、trueに設定します。 この変数は、書き込み可能なファイルシステムを持つCloud Docker コンテナにのみ関連します。 このような場合、コマンドをスキップすると、削除されたgenerated ディレクトリからコードにアクセスしようとする他のコマンドのエラーが回避されます。

Adobe Commerceがcomposer dump-autoloadを実行すると、生成されたクラスへのリンクを含む自動ロード ファイルがgenerated フォルダーに作成されます。これは、読み取り専用のファイル システムを備えた実稼動環境では問題ありません。 ただし、書き込み可能なファイルシステムを使用したCloud Dockerのインストール（./vendor/bin/ece-docker build:compose --with-testを使用したテストおよび開発用にのみ作成）の場合、--keep-generated オプションを使用せずにbin/magento -n setup:upgrade コマンドを実行すると、generated ディレクトリが削除されます。 ディレクトリが削除されると、オートロードに削除されたディレクトリ内のファイルへのリンクが含まれているため、composer dump-autoload コマンドは失敗します。

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

  • Default— 設定なし
  • バージョン - Adobe Commerce 2.1.4以降

ビルド フェーズ中に静的コンテンツのデプロイメントをスキップするには、trueに設定します。

構成管理のビルド フェーズで既に静的コンテンツをデプロイしている場合、クイック ビルド テスト用に静的コンテンツのデプロイをスキップできます。

ビルド フェーズで、SKIP_SCD: falseを設定して、静的コンテンツのビルドがビルド フェーズ中に発生し、プロセスがサイトのデプロイメントに影響を与えたり、不要なサイト ダウンタイムを引き起こしたりしないようにします。 静的コンテンツ展開を参照してください。

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

  • 既定—設定なし
  • バージョン - Adobe Commerce 2.1.4以降

デプロイメントフェーズ中に実行されるbin/magento CLI コマンドのSymfony デバッグの冗長性レベルを有効または無効にします。

NOTE
VERBOSE_COMMANDSを使用して、成功したCLI コマンドと失敗したbin/magento CLI コマンドの両方のコマンド出力の詳細を制御するには、MIN_LOGGING_LEVEL debugを設定する必要があります。

ログに記載されている詳細レベルを選択します。

  • -v=通常の出力
  • -vv=より詳細な出力
  • -vvv = デバッグに最適な詳細な出力
stage:
  build:
    VERBOSE_COMMANDS: "-vv"
recommendation-more-help
commerce-on-cloud-help-cloud-guide