Variabili di build

Le seguenti variabili build controllano le azioni nella fase di compilazione e possono ereditare ed eseguire l'override dei valori dalle variabili globali. Inserisci queste variabili nella fase build del file .magento.env.yaml:

stage:
  build:
    BUILD_VARIABLE_NAME: value

Per ulteriori informazioni sulla personalizzazione del processo di compilazione e distribuzione:

Le seguenti variabili sono state rimosse nella versione v2.2:

ERROR_REPORT_DIR_NESTING_LEVEL

Impostare il livello di nidificazione delle directory per il salvataggio dei file del report degli errori per evitare di riempire la directory del report con decine di migliaia di file, rendendo difficile la gestione e la revisione dei dati. Impostazione predefinita: 1. In genere, non è necessario modificare il valore predefinito a meno che non si verifichino problemi nella gestione dei file di segnalazione errori nella directory <magento_root>/var/report/.

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

Specificare un elenco di patch di qualità Adobe Commerce da applicare durante la distribuzione.

stage:
  build:
    QUALITY_PATCHES: [ ]

Nell'esempio seguente vengono specificate tre patch da applicare durante la distribuzione.

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

Vedi Applicare le patch.

SCD_COMPRESSION_LEVEL

Specifica il livello di compressione gzip (da 0 a 9) da utilizzare durante la compressione del contenuto statico; 0 disabilita la compressione.

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

Quando il tempo necessario per comprimere le risorse statiche supera il limite di timeout di compressione, il processo di distribuzione viene interrotto. Imposta il tempo massimo di esecuzione, in secondi, per il comando di compressione del contenuto statico.

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_NO_PARENT

Imposta su true per impedire la generazione di contenuto statico per i temi principali durante la fase di compilazione.

Imposta SCD_NO_PARENT: false durante la fase di build in modo che la generazione di contenuto statico per i temi principali non influisca sulla distribuzione del sito o non provochi inutili tempi di inattività. Vedi Distribuzione di contenuto statico.

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

È possibile configurare più impostazioni internazionali per tema. Questa personalizzazione consente di velocizzare il processo di creazione riducendo il numero di file dei temi non necessari. Ad esempio, puoi creare il tema magento/backend in inglese e un tema personalizzato in altre lingue.

Nell'esempio seguente viene creato il tema Magento/backend con tre impostazioni internazionali:

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

L’esempio seguente crea tre temi con tre impostazioni internazionali:

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

In alternativa, puoi scegliere di non distribuire un tema:

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

SCD_MAX_EXECUTION_TIME

Consente di aumentare il tempo massimo di esecuzione previsto per la distribuzione del contenuto statico.

Per impostazione predefinita, Adobe Commerce su infrastruttura cloud imposta l’esecuzione massima prevista su 900 secondi, ma in alcuni scenari potrebbe essere necessario più tempo per completare la distribuzione di contenuti statici per un progetto Cloud.

stage:
  build:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_STRATEGY

Personalizzare la strategia di distribuzione per il contenuto statico. Vedere Distribuire i file di visualizzazione statici.

Utilizza queste opzioni only se hai più di una lingua:

stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

Imposta il numero di thread per la distribuzione del contenuto statico. Il valore predefinito è impostato in base al numero di thread della CPU rilevati e non supera il valore 4. L'aumento del numero di thread velocizza la distribuzione dei contenuti statici; la riduzione del numero di thread ne rallenta la distribuzione. Puoi impostare il valore del thread, ad esempio:

stage:
  build:
    SCD_THREADS: 2

Per ridurre ulteriormente i tempi di distribuzione, utilizzare Gestione configurazione con il comando scd-dump per spostare la distribuzione statica nella fase di compilazione.

SCD_USE_BALER

Baler analizza il codice JavaScript generato e crea un bundle JavaScript ottimizzato. L’implementazione del bundle ottimizzato sul sito può ridurre il numero di richieste di rete durante il caricamento del sito e migliorare i tempi di caricamento delle pagine.

Impostare su true per eseguire Baler dopo l'esecuzione della distribuzione del contenuto statico.

stage:
  build:
    SCD_USE_BALER: true

SKIP_COMPOSER_DUMP_AUTOLOAD

Impostare su true per ignorare il comando composer dump-autoload durante un'installazione di Cloud Docker. Questa variabile è rilevante solo per i contenitori Cloud Docker con file system scrivibili. In questi casi, ignorando il comando si impedisce agli altri comandi di tentare di accedere al codice dalla directory generated eliminata.

Quando Adobe Commerce esegue composer dump-autoload, vengono creati file di caricamento automatico con collegamenti alle classi generate nella cartella generated. Ciò non costituisce un problema negli ambienti di produzione con file system di sola lettura. Tuttavia, per le installazioni di Cloud Docker con file system scrivibili (create solo per il test e lo sviluppo utilizzando ./vendor/bin/ece-docker build:compose --with-test), è possibile eseguire il comando bin/magento -n setup:upgrade senza l'opzione --keep-generated, che elimina la directory generated. Se la directory viene eliminata, il comando composer dump-autoload non riuscirà perché il caricamento automatico contiene collegamenti ai file nella directory eliminata.

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

Imposta su true per saltare la distribuzione del contenuto statico durante la fase di compilazione.

Se distribuisci già contenuto statico durante la fase di compilazione con Gestione configurazione, puoi saltare la distribuzione di contenuto statico per un test di compilazione rapido.

Durante la fase di compilazione, impostare SKIP_SCD: false in modo che la compilazione del contenuto statico avvenga durante la fase di compilazione in cui il processo non influisce sulla distribuzione del sito o causa inutili tempi di inattività del sito. Vedi Distribuzione di contenuto statico.

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

Attiva o disattiva il livello di dettaglio di debug Symfony per i comandi CLI bin/magento eseguiti durante la fase di distribuzione.

Scegli il livello di dettaglio fornito nei registri:

stage:
  build:
    VERBOSE_COMMANDS: "-vv"