Créer des variables

Les variables build suivantes contrôlent les actions pendant la phase de génération et peuvent hériter et remplacer des valeurs des variables globales. Insérez ces variables à l’étape build du fichier .magento.env.yaml :

stage:
  build:
    BUILD_VARIABLE_NAME: value

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

Les variables suivantes ont été supprimées dans la version v2.2 :

ERROR_REPORT_DIR_NESTING_LEVEL

Définissez le niveau d’imbrication de répertoires pour enregistrer les fichiers de rapport d’erreur afin d’éviter de remplir le répertoire de rapports avec des dizaines de milliers de fichiers, ce qui peut rendre difficile la gestion et la révision des données. Ce paramètre est défini par défaut sur 1. En règle générale, vous n’avez pas besoin de modifier la valeur par défaut, sauf si vous rencontrez des problèmes pour gérer les fichiers de rapport d’erreur dans le répertoire <magento_root>/var/report/.

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

Spécifiez une liste de correctifs de qualité Adobe Commerce à appliquer lors du déploiement.

stage:
  build:
    QUALITY_PATCHES: [ ]

L’exemple suivant indique trois correctifs à appliquer lors du déploiement.

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

Voir Appliquer les correctifs.

SCD_COMPRESSION_LEVEL

Spécifie le niveau de compression gzip (0 à 9) à utiliser lors de la compression du contenu statique ; 0 désactive la compression.

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

Lorsque le temps nécessaire à la compression des ressources statiques dépasse la limite du délai d’expiration de compression, cela interrompt le processus de déploiement. Définissez la durée d’exécution maximale, en secondes, de la commande de compression de contenu statique.

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

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 la phase de création.

Définissez SCD_NO_PARENT: false pendant la phase de génération de sorte que la génération du contenu statique pour les thèmes parents n’affecte pas le déploiement du site ou n’entraîne pas de temps d’arrêt inutile du site. Voir Déploiement de contenu statique.

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

Vous pouvez configurer plusieurs paramètres régionaux par thème. Cette personnalisation permet d’accélérer le processus de création en réduisant le nombre de fichiers de thème inutiles. Par exemple, vous pouvez créer le thème magento/backend en anglais et un thème personnalisé dans d’autres langues.

L’exemple suivant crée le thème Magento/backend avec trois paramètres régionaux :

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

L’exemple suivant crée trois thèmes avec trois paramètres régionaux :

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

Vous pouvez également choisir de ne pas déployer un thème :

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

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 sur l’infrastructure cloud définit l’exécution maximale prévue à 900 secondes, mais dans certains scénarios, vous devrez peut-être plus de temps pour terminer le déploiement de contenu statique pour un projet Cloud.

stage:
  build:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_STRATEGY

Personnalisez la stratégie de déploiement pour le contenu statique. Voir Déploiement de fichiers d’affichage statique.

Utilisez ces options only si vous avez plusieurs paramètres régionaux :

stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

Définit le nombre de threads pour le déploiement de contenu statique. La valeur par défaut est définie en fonction du nombre de threads du processeur détecté et ne dépasse pas une valeur de 4. L’augmentation du nombre de threads accélère le déploiement de contenu statique ; la réduction du nombre de threads la ralentit. Vous pouvez définir la valeur de thread, par exemple :

stage:
  build:
    SCD_THREADS: 2

Pour réduire davantage le temps de déploiement, utilisez Configuration Management avec la commande scd-dump pour passer au déploiement statique dans la phase de création.

SCD_USE_BALER

Baler 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_COMPOSER_DUMP_AUTOLOAD

Définissez cette variable sur true pour ignorer la commande composer dump-autoload lors de l’installation de Cloud Docker. Cette variable ne s’applique qu’aux conteneurs Cloud Docker avec des systèmes de fichiers modifiables. Dans ce cas, ignorer la commande empêche les erreurs d’autres commandes d’accéder au code du répertoire generated supprimé.

Lorsqu’Adobe Commerce exécute composer dump-autoload, il crée des fichiers de chargement automatique avec des liens vers des classes générées dans le dossier generated, ce qui n’est pas un problème dans les environnements de production avec des systèmes de fichiers en lecture seule. Toutefois, pour les installations de Cloud Docker avec des systèmes de fichiers modifiables (créés uniquement à des fins de test et de développement à l’aide de ./vendor/bin/ece-docker build:compose --with-test), vous pouvez exécuter la commande bin/magento -n setup:upgrade sans l’option --keep-generated, ce qui supprime le répertoire generated. Si le répertoire est supprimé, la commande composer dump-autoload échoue, car le chargement automatique contient des liens vers des fichiers du répertoire supprimé.

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

Définissez cette variable sur true pour ignorer le déploiement de contenu statique pendant la phase de création.

Si vous déployez déjà du contenu statique pendant la phase de création avec Configuration Management, vous pouvez ignorer le déploiement de contenu statique pour un test de création rapide.

Lors de la phase de création, définissez SKIP_SCD: false de sorte que la génération de contenu statique se produise pendant la phase de création, lorsque le processus n’a aucune incidence sur le déploiement du site ou provoque des temps d’arrêt inutiles du site. Voir Déploiement de contenu statique.

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

Activez ou désactivez le niveau de détail de débogage Symfony pour les commandes d’interface de ligne de commande bin/magento exécutées pendant la phase de déploiement.

Sélectionnez le niveau de détail fourni dans les logs :

stage:
  build:
    VERBOSE_COMMANDS: "-vv"