ビルド変数

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

stage:
  build:
    BUILD_VARIABLE_NAME: value

ビルドおよびデプロイプロセスのカスタマイズに関する詳細情報：

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

ERROR_REPORT_DIR_NESTING_LEVEL

エラーレポートファイルの保存に使用するディレクトリネストのレベルを設定して、レポートディレクトリが数万のファイルで埋もれてしまい、データの管理やレビューが困難になるのを回避します。 この設定のデフォルトは 1 です。 通常、<magento_root>/var/report/ ディレクトリ内のエラーレポート ファイルを管理する際に問題が発生しない限り、既定値を変更する必要はありません。

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

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

stage:
  build:
    QUALITY_PATCHES: [ ]

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

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

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

SCD_COMPRESSION_LEVEL

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

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

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

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_NO_PARENT

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

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

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

テーマごとに複数のロケールを設定できます。 このカスタマイズにより、不要なテーマファイルの数を減らすことで、ビルドプロセスを迅速化できます。 例えば、英語の 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

または、テーマをデプロイする しない を選択できます。

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

SCD_MAX_EXECUTION_TIME

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

デフォルトでは、クラウドインフラストラクチャー上のAdobe Commerceでは、予想される最大実行時間が 900 秒に設定されていますが、場合によっては、クラウドプロジェクトの静的コンテンツのデプロイメントを完了するためにより多くの時間が必要になることがあります。

stage:
  build:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_STRATEGY

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

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

stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

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

stage:
  build:
    SCD_THREADS: 2

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

SCD_USE_BALER

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

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

stage:
  build:
    SCD_USE_BALER: true

SKIP_COMPOSER_DUMP_AUTOLOAD

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

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

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

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

Configuration Management を使用してビルドフェーズで既に静的コンテンツをデプロイしている場合は、迅速なビルドテストのために静的コンテンツのデプロイメントをスキップできます。

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

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

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

ログに表示される詳細レベルを選択します。

stage:
  build:
    VERBOSE_COMMANDS: "-vv"