Créer des variables

Les éléments suivants build contrôlent les actions lors de la phase de création et peuvent hériter et remplacer des valeurs de la fonction Variables globales. Insérez ces variables dans le build étape de la .magento.env.yaml fichier :

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, il n’est pas nécessaire de modifier la valeur par défaut, sauf si vous rencontrez des problèmes pour gérer les fichiers de rapport d’erreur dans la variable <magento_root>/var/report/ répertoire .

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 gzip niveau de compression (0 to 9) à utiliser lors de la compression de 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 sur . true pour empêcher la génération de contenu statique pour les thèmes parents pendant la phase de création.

Définir SCD_NO_PARENT: false pendant la phase de création, de sorte que la génération du contenu statique pour les thèmes parents n’ait aucune incidence sur le déploiement du site ou ne provoque 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 la variable magento/backend en anglais et un thème personnalisé dans d’autres langues.

L’exemple suivant crée la variable Magento/backend thème 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 not 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 le stratégie de déploiement pour le contenu statique. Voir Déploiement de fichiers d’affichage statique.

Utiliser 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 Gestion des configurations avec la propriété scd-dump pour déplacer le déploiement statique dans la phase de génération.

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 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 sur . true pour ignorer composer dump-autoload lors d’une 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 qui tentent d’accéder au code du generated répertoire .

Lorsque Adobe Commerce s’exécute composer dump-autoload, il crée des fichiers de chargement automatique avec des liens vers les classes générées dans le generated , ce qui n’est pas un problème dans les environnements de production avec les 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 variable bin/magento -n setup:upgrade sans la commande --keep-generated , qui supprime la variable generated répertoire . Si le répertoire est supprimé, la variable 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 sur . true pour ignorer le déploiement du contenu statique pendant la phase de création.

Si vous déployez déjà du contenu statique pendant la phase de création avec Gestion des configurations, 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 création 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 la variable Symfony niveau de détail du débogage pour bin/magento Commandes d’interface de ligne de commande exécutées lors de la phase de déploiement

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

stage:
  build:
    VERBOSE_COMMANDS: "-vv"