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

  • Default-Not set
  • Version—Adobe Commerce 2.4.5 et versions ultérieures

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

  • Default-Not set
  • Version—Adobe Commerce 2.4.4 et versions ultérieures

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

  • Par défautNon défini
  • Version—Adobe Commerce 2.1.4 et versions ultérieures

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
WARNING
Le paramètre de la variable MIN_LOGGING_LEVEL ne modifie pas la configuration du niveau de journal pour le gestionnaire de fichiers, qui est défini sur debug par défaut.

SCD_ON_DEMAND

  • Par défautNon défini
  • Version—Adobe Commerce 2.1.4 et versions ultérieures

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éduittemps 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

  • Par défautNon défini
  • Version—Adobe Commerce 2.2.0 et versions ultérieures

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
WARNING
Si vous rencontrez des problèmes avec les fichiers de contenu statique dans votre application après le déploiement, tels que des fichiers de thème personnalisé manquants, augmentez le temps d’exécution maximal attendu à 900 secondes ou plus.

SCD_NO_PARENT

  • Par défautNon défini
  • Version—Adobe Commerce 2.4.2 et versions ultérieures

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

  • Par défautNon défini
  • Version—Adobe Commerce 2.3.0 et versions ultérieures

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
NOTE
Installez et configurez le module Baler avant d’utiliser cette fonctionnalité. Comme Baler est en version Alpha, activez cette option uniquement dans les environnements d’évaluation.

SKIP_HTML_MINIFICATION

  • Par défaut :

    • true : pour les versions ece-tools 2002.0.13 et ultérieures
    • false : pour les versions antérieures d’ece-tools
  • Version—Adobe Commerce 2.1.4 et versions ultérieures

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.

  • false : copie le répertoire view_preprocessed dans le répertoire <magento_root>/init/ à la fin de la phase de création et restaure le répertoire dans le répertoire <magento_root>/var au début de la phase de déploiement.
  • true : permet la minimisation de l'HTML à la demande ; ne copie pas le <magento_root>var/view_preprocessed dans le répertoire <magento_root>/init/ à l'issue de la phase de création.

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

  • Par défautNon défini
  • Version—Adobe Commerce 2.1.4 et versions ultérieures

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 :

  • DENY : la page ne peut pas être affichée dans un cadre.
  • SAMEORIGIN : (paramètre Adobe Commerce par défaut). La page ne peut être affichée que dans un cadre de la même origine que la page elle-même.
WARNING
L’option ALLOW-FROM <uri> est obsolète, car les navigateurs pris en charge par Adobe Commerce ne la prennent plus en charge. Voir Compatibilité navigateur.

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

stage:
  global:
    X_FRAME_CONFIGURATION: SAMEORIGIN
recommendation-more-help