Skapa variabler

Följande build-variabler kontrollerar åtgärder i byggfasen och kan ärva och åsidosätta värden från Globala variabler. Infoga de här variablerna i build-steget i filen .magento.env.yaml:

stage:
  build:
    BUILD_VARIABLE_NAME: value

Mer information om hur du anpassar bygg- och distributionsprocessen:

Följande variabler togs bort i v2.2:

ERROR_REPORT_DIR_NESTING_LEVEL

Ange nivån för katalogkapsling för att spara felrapportfiler för att undvika att fylla i rapportkatalogen med tiotusentals filer, vilket kan göra det svårt att hantera och granska data. Den här inställningen är som standard 1. Normalt behöver du inte ändra standardvärdet om du inte har problem med att hantera felrapportfiler i katalogen <magento_root>/var/report/.

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

Ange en lista över Adobe Commerce-kvalitetsuppdateringar som ska användas under distributionen.

stage:
  build:
    QUALITY_PATCHES: [ ]

I följande exempel anges tre korrigeringar som ska användas under distributionen.

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

Se Tillämpa korrigeringar.

SCD_COMPRESSION_LEVEL

Anger vilken gzip-komprimeringsnivå (0 till 9) som ska användas vid komprimering av statiskt innehåll. 0 inaktiverar komprimering.

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

När den tid det tar att komprimera de statiska resurserna överskrider tidsgränsen för komprimering avbryts distributionsprocessen. Ange den maximala körningstiden i sekunder för det statiska kommandot för innehållskomprimering.

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_NO_PARENT

Ange true för att förhindra att statiskt innehåll genereras för överordnade teman under byggfasen.

Ange SCD_NO_PARENT: false under byggfasen så att generering av statiskt innehåll för de överordnade temana inte påverkar webbplatsdistributionen eller orsakar onödiga driftavbrott. Se Distribution av statiskt innehåll.

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

Du kan konfigurera flera språkinställningar per tema. Den här anpassningen snabbar upp byggprocessen genom att minska antalet onödiga temafiler. Du kan till exempel skapa temat magento/backend på engelska och ett anpassat tema på andra språk.

I följande exempel skapas temat Magento/backend med tre språkområden:

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

I följande exempel byggs tre teman med tre språkområden:

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

Du kan också välja att inte ska distribuera ett tema:

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

SCD_MAX_EXECUTION_TIME

Gör att du kan öka den maximala förväntade körningstiden för statisk innehållsdistribution.

Som standard sätter Adobe Commerce i molninfrastrukturen den maximala förväntade körningen till 900 sekunder, men i vissa fall behöver du mer tid för att slutföra den statiska innehållsdistributionen för ett Cloud-projekt.

stage:
  build:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_STRATEGY

Anpassa distributionsstrategin för statiskt innehåll. Se Distribuera statiska vyfiler.

Använd dessa alternativ endast om du har fler än en språkinställning:

stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

Anger antalet trådar för distribution av statiskt innehåll. Standardvärdet baseras på antalet CPU-tråd som identifierats och överstiger inte värdet 4. Om du ökar antalet trådar går det snabbare att distribuera statiskt innehåll, och om du minskar antalet trådar blir det långsammare. Du kan ange ett trådvärde, till exempel:

stage:
  build:
    SCD_THREADS: 2

Om du vill minska distributionstiden ytterligare använder du Configuration Management med kommandot scd-dump för att flytta statisk distribution till byggfasen.

SCD_USE_BALER

Baler skannar den genererade JavaScript-koden och skapar ett optimerat JavaScript-paket. Genom att distribuera det optimerade paketet till din webbplats kan du minska antalet nätverksförfrågningar när du läser in webbplatsen och förbättra sidinläsningstiden.

Ange true om du vill köra Baler efter att ha utfört distributionen av statiskt innehåll.

stage:
  build:
    SCD_USE_BALER: true

SKIP_COMPOSER_DUMP_AUTOLOAD

Ange true om du vill hoppa över kommandot composer dump-autoload under en installation av en Cloud Docker. Den här variabeln gäller endast för Cloud Docker-behållare med skrivbara filsystem. Om du hoppar över kommandot förhindras i så fall fel från andra kommandon som försöker komma åt kod från den borttagna generated-katalogen.

När Adobe Commerce kör composer dump-autoload skapas automatiskt inlästa filer med länkar till genererade klasser i mappen generated, vilket inte är något problem i produktionsmiljöer med skrivskyddade filsystem. För Cloud Docker-installationer med skrivbara filsystem (som bara skapats för testning och utveckling med ./vendor/bin/ece-docker build:compose --with-test) kan du köra kommandot bin/magento -n setup:upgrade utan alternativet --keep-generated som tar bort katalogen generated. Om katalogen tas bort misslyckas kommandot composer dump-autoload eftersom den automatiska inläsningen innehåller länkar till filer i den borttagna katalogen.

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

Ange true om du vill hoppa över distribution av statiskt innehåll under byggfasen.

Om du redan distribuerar statiskt innehåll under byggfasen med Configuration Management kan du hoppa över statisk innehållsdistribution för att få ett snabbt byggtest.

Under byggfasen anger du SKIP_SCD: false så att det statiska innehållet skapas under byggfasen där processen inte påverkar webbplatsens distribution eller orsakar onödiga driftavbrott. Se Distribution av statiskt innehåll.

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

Aktivera eller inaktivera Symfony-felsökningsnivån för bin/magento CLI-kommandon som utförs under distributionsfasen.

Välj detaljnivå i loggarna:

stage:
  build:
    VERBOSE_COMMANDS: "-vv"