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

Lorsqu’il est défini sur true, il permet à cron d’exécuter les consommateurs de la file d’attente des messages. Les événements d’Adobe I/O pour Adobe Commerce utilisent les files d’attente de messages pour accélérer la diffusion des événements critiques.

Adobe recommande d’ajouter également la variable CRON_CONSUMERS_RUNNER à l’étape deploy du fichier .magento.env.yaml avec cron_run défini 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’elle est définie sur true, active les webhooks Commerce. Le webhook s’exécute sur un point de terminaison externe, tel qu’une action d’exécution App Builder ou un système de gestion d’inventaire tiers. Le Guide des webhooks décrit cette fonctionnalité en détail.

stage:
  global:
    ENABLE_WEBHOOKS: true

MIN_LOGGING_LEVEL

Permet de remplacer le niveau de journalisation minimum pour tous les flux de sortie sans modifier le code, ce qui permet de résoudre les problèmes liés au déploiement. Par exemple, si votre déploiement échoue, vous pouvez utiliser cette variable pour augmenter la granularité de journalisation globalement. Voir Niveaux de journal. La valeur min_level des 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 le demande (SCD). Le contenu statique à la demande est idéal pour le workflow de développement et de test, car il réduit la durée de déploiement.

Le préchargement du cache à l’aide du point d’extension post_deploy réduit le temps de disponibilité du site. Le réchauffement du cache est disponible uniquement pour les projets Pro contenant des environnements d’évaluation et de production dans Cloud Console et pour les projets 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 dans les deux phases (création et déploiement), efface les dossiers pub/static et var/view_preprocessed et écrit ce qui suit 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 maximum prévu pour le déploiement de contenu statique.

Par défaut, Adobe Commerce définit l’exécution maximale prévue à 900 secondes, mais dans certains cas, il peut s’avérer nécessaire de consacrer plus de temps au déploiement de contenu statique pour un projet Cloud.

stage:
  global:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_NO_PARENT

Définissez cette variable sur true pour 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 les délais de création et de déploiement globaux.

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 cette variable sur true pour exécuter Baler après l’exécution du déploiement de contenu statique.

stage:
  build:
    SCD_USE_BALER: true

SKIP_HTML_MINIFICATION

Active ou désactive la copie des fichiers d’affichage statique dans le répertoire <magento_root>/init/ à la fin de l’étape de création. Si celle-ci est définie sur true, les fichiers ne sont pas copiés et la minification d’HTML est disponible sur demande. Définissez cette valeur sur true pour réduire le 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 <frame>, <iframe> ou <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