Variabili globali
Le variabili globali controllano le azioni in ogni fase del processo di distribuzione di Commerce: compilazione, distribuzione e post-distribuzione. Poiché le variabili globali influiscono su ogni fase, è necessario impostarle nella fase global
del file .magento.env.yaml
:
stage:
global:
GLOBAL_VARIABLE_NAME: value
Per ulteriori informazioni sulla personalizzazione del processo di compilazione e distribuzione:
ENABLE_EVENTING
- Predefinito-Non impostato
- Versione—Adobe Commerce 2.4.5 e versioni successive
Se impostata su true
, abilita cron per eseguire i consumer della coda di messaggi. Gli eventi di Adobe I/O per Adobe Commerce utilizzano le code di messaggi per accelerare la consegna di eventi critici.
L'Adobe consiglia inoltre di aggiungere la variabile CRON_CONSUMERS_RUNNER
alla fase deploy
del file .magento.env.yaml
con cron_run
impostato su true
.
L'esempio seguente mostra una variabile ENABLE_EVENTING
completamente configurata.
stage:
global:
ENABLE_EVENTING: true
deploy:
CRON_CONSUMERS_RUNNER:
cron_run: true
max_messages: 0
consumers: []
ENABLE_WEBHOOKS
- Predefinito-Non impostato
- Versione—Adobe Commerce 2.4.4 e versioni successive
Se è impostato su true
, abilita i webhook di Commerce. Il webhook viene eseguito su un endpoint esterno, ad esempio un’azione di runtime di App Builder o un sistema di gestione dell’inventario di terze parti. La Guida ai webhook descrive questa funzionalità in dettaglio.
stage:
global:
ENABLE_WEBHOOKS: true
MIN_LOGGING_LEVEL
- Predefinito—Non impostato
- Versione—Adobe Commerce 2.1.4 e versioni successive
Ignora il livello minimo di registrazione per tutti i flussi di output senza modificare il codice, il che è utile per la risoluzione dei problemi di distribuzione. Ad esempio, se la distribuzione non riesce, puoi utilizzare questa variabile per aumentare la granularità della registrazione a livello globale. Vedi Livelli di registro. Il valore min_level
nei gestori di registrazione sovrascrive questa impostazione.
stage:
global:
MIN_LOGGING_LEVEL: debug
MIN_LOGGING_LEVEL
non modifica la configurazione a livello di registro per il gestore di file, che è impostata su debug
per impostazione predefinita.SCD_ON_DEMAND
- Predefinito—Non impostato
- Versione—Adobe Commerce 2.1.4 e versioni successive
Abilita la generazione di contenuto statico quando richiesto da un utente (SCD). I contenuti statici on-demand sono ideali per il flusso di lavoro di sviluppo e test, in quanto riducono i tempi di implementazione.
Il precaricamento della cache utilizzando l'hook post_deploy
riduce i tempi di inattività del sito. Il riscaldamento della cache è disponibile solo per i progetti Pro che contengono ambienti di staging e produzione in Cloud Console e per i progetti iniziali. Aggiungere la variabile di ambiente SCD_ON_DEMAND
alla fase global
nel file .magento.env.yaml
:
stage:
global:
SCD_ON_DEMAND: true
La variabile SCD_ON_DEMAND
ignora l'SCD in entrambe le fasi (compilazione e distribuzione), cancella le cartelle pub/static
e var/view_preprocessed
e scrive quanto segue nel file app/etc/env.php
:
return array(
...
'static_content_on_demand_in_production' => 1,
...
);
SCD_MAX_EXECUTION_TIME
- Predefinito—Non impostato
- Versione—Adobe Commerce 2.2.0 e versioni successive
Consente di aumentare il tempo massimo di esecuzione previsto per la distribuzione del contenuto statico.
Per impostazione predefinita, Adobe Commerce imposta l’esecuzione massima prevista su 900 secondi, ma in alcuni scenari potrebbe essere necessario più tempo per completare la distribuzione di contenuto statico per un progetto Cloud.
stage:
global:
SCD_MAX_EXECUTION_TIME: 3600
SCD_NO_PARENT
- Predefinito—Non impostato
- Versione—Adobe Commerce 2.4.2 e versioni successive
Imposta su true
per impedire la generazione di contenuto statico per i temi principali durante le fasi di compilazione e distribuzione. Quando questa opzione è impostata su true
, viene generato meno contenuto statico, il che migliora i tempi complessivi di compilazione e distribuzione.
stage:
global:
SCD_NO_PARENT: true
SCD_USE_BALER
- Predefinito—Non impostato
- Versione—Adobe Commerce 2.3.0 e versioni successive
Baler è un modulo che 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_HTML_MINIFICATION
-
Predefinito:
true
—perece-tools
2002.0.13 e versioni successivefalse
- per le versioni precedenti diece-tools
-
Versione—Adobe Commerce 2.1.4 e versioni successive
Abilita o disabilita la copia dei file di visualizzazione statica nella directory <magento_root>/init/
alla fine della fase di compilazione. Se è impostato su true
, i file non vengono copiati e la minimizzazione HTML è disponibile su richiesta. Impostare questo valore su true
per ridurre i tempi di inattività durante la distribuzione negli ambienti di staging e produzione.
false
- Copia la directoryview_preprocessed
nella directory<magento_root>/init/
alla fine della fase di compilazione e ripristina la directory nella directory<magento_root>/var
all'inizio della fase di distribuzione.true
- Abilita la minimizzazione di HTML su richiesta; non copia<magento_root>var/view_preprocessed
nella directory<magento_root>/init/
alla fine della fase di compilazione.
Aggiungere la variabile di ambiente SKIP_HTML_MINIFICATION
alla fase global
nel file .magento.env.yaml
:
stage:
global:
SKIP_HTML_MINIFICATION: true
X_FRAME_CONFIGURATION
- Predefinito—Non impostato
- Versione—Adobe Commerce 2.1.4 e versioni successive
Utilizza la variabile X_FRAME_CONFIGURATION
per modificare la configurazione dell'intestazione X-Frame-Options
per il tuo sito Adobe Commerce. Questa configurazione controlla come il browser esegue il rendering di una pagina in un <frame>
, <iframe>
o <object>
. Utilizza una delle seguenti opzioni:
DENY
- Impossibile visualizzare la pagina in un frame.SAMEORIGIN
—(impostazione predefinita di Adobe Commerce). La pagina può essere visualizzata solo in un frame sulla stessa origine della pagina stessa.
ALLOW-FROM <uri>
è stata rimossa perché i browser supportati da Adobe Commerce non la supportano più. Vedi Compatibilità browser.Aggiungere la variabile di ambiente X_FRAME_CONFIGURATION
alla fase global
nel file .magento.env.yaml
:
stage:
global:
X_FRAME_CONFIGURATION: SAMEORIGIN