[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Variables globales

Les variables globales contrôlent les actions à chaque phase du processus de déploiement Commerce : création, déploiement et post-déploiement. Les variables globales ayant un impact sur chaque phase, vous devez les définir à l’étape global du fichier .magento.env.yaml :

stage:
  global:
    GLOBAL_VARIABLE_NAME: value

Pour plus d’informations sur la personnalisation du processus de création et de déploiement :

ENABLE_EVENTING

Lorsque la valeur est définie sur true, permet à cron d’exécuter les consommateurs de file d’attente de messages. Adobe I/O Events pour Adobe Commerce utilise les files d’attente de messages pour accélérer la diffusion des événements critiques.

Adobe vous recommande également d’ajouter la variable CRON_CONSUMERS_RUNNER à l’étape deploy du fichier .magento.env.yaml avec cron_run définie sur true.

L’exemple suivant illustre une variable ENABLE_EVENTING entièrement configurée.

stage:
  global:
    ENABLE_EVENTING: true
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 0
      consumers: []

ENABLE_WEBHOOKS

Lorsqu’il est défini sur true, active les Webhooks Commerce. Le webhook s’exécute sur un point d’entrée externe, tel qu’une action d’exécution App Builder ou un système de gestion des stocks tiers. Le guide des Webhooks décrit cette fonctionnalité en détail.

stage:
  global:
    ENABLE_WEBHOOKS: true

MIN_LOGGING_LEVEL

Il remplace le niveau de journalisation minimal pour tous les flux de sortie sans modifier le code, ce qui s’avère utile lors de la résolution des problèmes de déploiement. Par exemple, si votre déploiement échoue, vous pouvez utiliser cette variable pour augmenter la granularité de la journalisation au niveau mondial. Voir Niveaux de journal. La valeur min_level dans Gestionnaires de journalisation remplace ce paramètre.

stage:
  global:
    MIN_LOGGING_LEVEL: debug

SCD_ON_DEMAND

Activez la génération de contenu statique lorsqu’un utilisateur ou une utilisatrice (SCD) le demande. Le contenu statique à la demande est idéal pour le workflow de développement et de test, car il réduit le temps de déploiement.

Le préchargement du cache à l’aide du hook post_deploy réduit ​ temps d’arrêt du site. Le réchauffement du cache n’est disponible que pour les projets Pro contenant des environnements d’évaluation et de production dans les projets Cloud Console et de démarrage. Ajoutez la variable d’environnement SCD_ON_DEMAND à l’étape global dans le fichier .magento.env.yaml :

stage:
  global:
    SCD_ON_DEMAND: true

La variable SCD_ON_DEMAND ignore le SCD lors des deux phases (création et déploiement), efface les dossiers pub/static et var/view_preprocessed et écrit les éléments suivants dans le fichier app/etc/env.php :

return array(
   ...
   'static_content_on_demand_in_production' => 1,
   ...
);

SCD_MAX_EXECUTION_TIME

Permet d’augmenter le temps d’exécution maximal attendu pour le déploiement de contenu statique.

Par défaut, Adobe Commerce définit l’exécution maximale prévue sur 900 secondes, mais dans certains scénarios, vous aurez peut-être besoin de plus de temps pour terminer le déploiement du contenu statique pour un projet cloud.

stage:
  global:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_NO_PARENT

Définissez cette variable sur true afin d’empêcher la génération de contenu statique pour les thèmes parents pendant les phases de création et de déploiement. Lorsque cette option est définie sur true, moins de contenu statique est généré, ce qui améliore votre temps de création et de déploiement global.

stage:
  global:
    SCD_NO_PARENT: true

SCD_USE_BALER

Baler est un module qui analyse le code JavaScript généré et crée un lot JavaScript optimisé. Le déploiement du lot optimisé sur votre site peut réduire le nombre de requêtes réseau lors du chargement de votre site et améliorer les temps de chargement des pages.

Définissez sur true pour exécuter la presse après avoir effectué un déploiement de contenu statique.

stage:
  build:
    SCD_USE_BALER: true

SKIP_HTML_MINIFICATION

Active ou désactive la copie de fichiers de vue statiques dans le répertoire <magento_root>/init/ à la fin de l'étape de création. Si le paramètre est défini sur true, les fichiers ne sont pas copiés et une minimisation d’HTML est disponible sur demande. Définissez cette valeur sur true afin de réduire les temps d’arrêt lors du déploiement dans les environnements d’évaluation et de production.

Ajoutez la variable d’environnement SKIP_HTML_MINIFICATION à l’étape global dans le fichier .magento.env.yaml :

stage:
  global:
    SKIP_HTML_MINIFICATION: true

X_FRAME_CONFIGURATION

Utilisez la variable X_FRAME_CONFIGURATION pour modifier la configuration de l’en-tête X-Frame-Options de votre site Adobe Commerce. Cette configuration contrôle la manière dont le navigateur effectue le rendu d’une page dans une <frame>, un <iframe> ou un <object>. Utilisez l’une des options suivantes :

Ajoutez la variable d’environnement X_FRAME_CONFIGURATION à l’étape global dans le fichier .magento.env.yaml :

stage:
  global:
    X_FRAME_CONFIGURATION: SAMEORIGIN