Déploiement de variables

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

stage:
  deploy:
    DEPLOY_VARIABLE_NAME: value

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

CACHE_CONFIGURATION

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

Configurez la page Redis et la mise en cache par défaut. Lors de la définition du paramètre cm_cache_backend_redis, vous devez spécifier les options server, port et database.

stage:
  deploy:
    CACHE_CONFIGURATION:
      frontend:
        default:
          backend: file
        page_cache:
          backend: file

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne de nouvelles valeurs avec une configuration existante :

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            database: 10
        page_cache:
          backend_options:
            database: 11

L’exemple suivant utilise la fonction de préchargement Redis comme défini dans le Guide de configuration :

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          id_prefix: '061_'
          backend_options:
            preload_keys:
              - '061_EAV_ENTITY_TYPES:hash'
              - '061_GLOBAL_PLUGIN_LIST:hash'
              - '061_DB_IS_UP_TO_DATE:hash'
              - '061_SYSTEM_DEFAULT:hash'

Pour utiliser un modèle personnalisé REDIS_BACKEND (et pas seulement à partir de la liste autorisée), définissez l’option _custom_redis_backend sur true afin d’activer la validation correcte, comme dans l’exemple suivant :

stage:
  deploy:
    CACHE_CONFIGURATION:
      frontend:
        default:
          _custom_redis_backend: true
          backend: '\CustomRedisModel'

CLEAN_STATIC_FILES

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

Active ou désactive le nettoyage des fichiers de contenu statique générés pendant la phase de création ou de déploiement. Il est recommandé d’utiliser la valeur par défaut true dans le développement.

  • true : supprime tout le contenu statique existant avant de déployer le contenu statique mis à jour.
  • false : le déploiement remplace uniquement les fichiers de contenu statique existants si le contenu généré contient une version plus récente.

Si vous modifiez du contenu statique par le biais d’un processus distinct, définissez la valeur sur false.

stage:
  deploy:
    CLEAN_STATIC_FILES: false

L’échec du nettoyage des fichiers d’affichage statiques avant le déploiement peut entraîner des problèmes si vous déployez des mises à jour vers des fichiers existants sans supprimer les versions précédentes. En raison des règles de secours de fichier statique, les opérations de secours peuvent afficher un fichier incorrect si le répertoire contient plusieurs versions du même fichier.

CRON_CONSUMERS_RUNNER

  • Par défautcron_run = false, max_messages = 1000
  • Version—Adobe Commerce 2.2.0 et versions ultérieures

Utilisez cette variable d’environnement pour confirmer que les files d’attente de messages s’exécutent après un déploiement.

  • cron_run : valeur booléenne qui active ou désactive la tâche consumers_runner cron (par défaut = false).

  • max_messages : nombre spécifiant le nombre maximal de messages que chaque consommateur doit traiter avant de s’arrêter (par défaut = 1000). Vous pouvez définir la valeur sur 0 pour empêcher le consommateur de s’arrêter.

  • consumers : un tableau de chaînes spécifiant les consommateurs à exécuter. Un tableau vide exécute tous les consommateurs.

  • multiple_processes-Un nombre spécifiant le nombre de processus à générer pour chaque consommateur. Pris en charge dans Commerce 2.4.4 ou version ultérieure.

NOTE
Pour renvoyer une liste de la file d’attente de messages consumers, exécutez la commande ./bin/magento queue:consumers:list dans l’environnement distant.

Exemple de tableau qui exécute les consumers spécifiques et le multiple_processes à générer pour chaque consommateur :

stage:
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers:
        - example_consumer_1
        - example_consumer_2
-     multiple_processes:
        example_consumer_1: 4
        example_consumer_2: 3

Exemple de tableau vide qui exécute tous les consumers :

stage:
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers: []

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Voir Gestion des files d’attente de messages dans le Guide de configuration de Commerce pour Adobe Commerce sur site.

CONSUMERS_WAIT_FOR_MAX_MESSAGES

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

Configurez la manière dont consumers traite les messages de la file d’attente des messages en choisissant l’une des options suivantes :

  • falseConsumers traitez les messages disponibles dans la file d’attente, fermez la connexion TCP et arrêtez-vous. Consumers n’attendez pas que des messages supplémentaires entrent dans la file d’attente, même si le nombre de messages traités est inférieur à la valeur max_messages spécifiée dans la variable de déploiement CRON_CONSUMERS_RUNNER.

  • trueConsumers continuer à traiter les messages de la file d’attente des messages jusqu’à atteindre le nombre maximal de messages (max_messages) spécifié dans la variable de déploiement CRON_CONSUMERS_RUNNER avant de fermer la connexion TCP et d’interrompre le processus client. Si la file d’attente se vide avant d’atteindre max_messages, le consommateur attend que d’autres messages arrivent.

WARNING
Si vous utilisez des programmes de travail pour exécuter consumers au lieu d’utiliser une tâche cron, définissez cette variable sur true.
stage:
  deploy:
    CONSUMERS_WAIT_FOR_MAX_MESSAGES: false

CRYPT_KEY

  • Par défautNon défini
  • Version—Adobe Commerce 2.1.4 et versions ultérieures
WARNING
Définissez la valeur CRYPT_KEY via le fichier Cloud Console au lieu du fichier .magento.env.yaml afin d’éviter d’exposer la clé dans le référentiel de code source de votre environnement. Voir Définition des variables d’environnement et de projet.

Lorsque vous déplacez la base de données d’un environnement à un autre sans processus d’installation, vous avez besoin des informations cryptographiques correspondantes. Adobe Commerce utilise la valeur de clé de chiffrement définie dans Cloud Console comme valeur crypt/key dans le fichier env.php.

DATABASE_CONFIGURATION

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

Si vous avez défini une base de données dans la propriété de relations du fichier .magento.app.yaml, vous pouvez personnaliser vos connexions de base de données pour le déploiement.

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_value'

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne de nouvelles valeurs avec une configuration existante :

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_new_value'
      _merge: true

Vous pouvez également configurer un préfixe de tableau.

WARNING
Si vous n’utilisez pas l’option de fusion avec le préfixe de tableau, vous devez fournir les paramètres de connexion par défaut, sinon la validation du déploiement échoue.

L’exemple suivant utilise le préfixe de table ece_ avec les paramètres de connexion par défaut au lieu d’utiliser l’option _merge :

stage:
  deploy:
    DATABASE_CONFIGURATION:
      connection:
        default:
          username: user
          host: host
          dbname: magento
          password: password
      table_prefix: 'ece_'

Exemple de sortie :

MariaDB [main]> SHOW TABLES;
+-------------------------------------+
| Tables_in_main                      |
+-------------------------------------+
| ece_admin_passwords                 |
| ece_admin_system_messages           |
| ece_admin_user                      |
| ece_admin_user_session              |
| ece_adminnotification_inbox         |
| ece_amazon_customer                 |
| ece_authorization_rule              |
| ece_cache                           |
| ece_cache_tag                       |
| ece_captcha_log                     |
...

ELASTICSUITE_CONFIGURATION

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

Conserve les paramètres de service Elastic Suite personnalisés entre les déploiements et les utilise dans la section 'system/default/smile_élasticsuite_core_base_settings' de la configuration principale Elastic Suite. Si le package de compositeur Elastic Suite est installé, il est configuré automatiquement.

stage:
  deploy:
    ELASTICSUITE_CONFIGURATION:
      es_client:
        servers: 'remote-host:9200'
      indices_settings:
        number_of_shards: 1
        number_of_replicas: 0
NOTE
Sur une grappe de production/d’évaluation Pro qui comporte trois noeuds (ou trois noeuds de service sur l’architecture mise à l’échelle, le indices_settings doit être défini comme suit :
code language-yaml
           indices_settings:
               number_of_shards: 3
               number_of_replicas: 2

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne une nouvelle valeur avec la configuration existante :

stage:
  deploy:
    ELASTICSUITE_CONFIGURATION:
      indices_settings:
        number_of_shards: 3
        number_of_replicas: 2
      _merge: true

Limites connues :

  • La modification du moteur de recherche sur un autre type que elasticsuite entraîne un échec de déploiement accompagné d’une erreur de validation appropriée.
  • La suppression du service Elasticsearch entraîne un échec de déploiement accompagné d’une erreur de validation appropriée.
NOTE
Pour plus d’informations sur l’utilisation ou la résolution des problèmes du module externe Elastic Suite avec Adobe Commerce, consultez la Elastic Suite documentation.

ENABLE_GOOGLE_ANALYTICS

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

Active et désactive les Google Analytics lors du déploiement dans les environnements d’évaluation et d’intégration. Par défaut, le paramètre Google Analytics est défini sur true uniquement pour l’environnement de production. Définissez cette valeur sur true pour activer les Google Analytics dans les environnements d’évaluation et d’intégration.

  • true : active les Google Analytics dans les environnements d’évaluation et d’intégration.
  • false : désactive les Google Analytics dans les environnements d’évaluation et d’intégration.

Ajoutez la variable d'environnement ENABLE_GOOGLE_ANALYTICS à l'étape deploy dans le fichier .magento.env.yaml :

stage:
  deploy:
    ENABLE_GOOGLE_ANALYTICS: true
NOTE
Le processus de déploiement active toujours les Google Analytics dans les environnements de production.

FORCE_UPDATE_URLS

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

Lors du déploiement dans les environnements Pro ou Starter Staging et Production, cette variable remplace les URL de base Adobe Commerce dans la base de données par les URL de projet spécifiées par la variable MAGENTO_CLOUD_ROUTES. Utilisez ce paramètre pour remplacer le comportement par défaut de la variable de déploiement UPDATE_URLS, qui est ignorée lors du déploiement dans les environnements d’évaluation ou de production.

stage:
  deploy:
    FORCE_UPDATE_URLS: true

LOCK_PROVIDER

  • Par défautfile
  • Version—Adobe Commerce 2.2.5 et versions ultérieures

Le fournisseur de verrouillage empêche le lancement de tâches cron en double et de groupes cron. Utilisez le fournisseur de verrouillage file dans l’environnement de production. Les environnements de démarrage et l’environnement d’intégration Pro n’utilisent pas la variable MAGENTO_CLOUD_LOCKS_DIR. Par conséquent, ece-tools applique automatiquement le fournisseur de verrouillage db.

stage:
  deploy:
    LOCK_PROVIDER: "db"

Voir Configuration du verrouillage dans le guide d’installation.

MYSQL_USE_SLAVE_CONNECTION

  • Par défautfalse
  • Version—Adobe Commerce 2.1.4 et versions ultérieures
TIP
La variable MYSQL_USE_SLAVE_CONNECTION n’est prise en charge que sur Adobe Commerce dans les environnements de grappe d’infrastructure cloud Staging et Production Pro et n’est pas prise en charge dans les projets de démarrage.

Adobe Commerce peut lire plusieurs bases de données de manière asynchrone. Définissez cette variable sur true pour utiliser automatiquement une connexion en lecture seule à la base de données pour recevoir du trafic en lecture seule sur un noeud non maître. Cette connexion améliore les performances grâce à l’équilibrage de charge, car un seul noeud traite le trafic lecture-écriture. Définissez cette variable sur false pour supprimer tout tableau de connexion en lecture seule existant du fichier env.php.

stage:
  deploy:
    MYSQL_USE_SLAVE_CONNECTION: true

Lorsque la variable MYSQL_USE_SLAVE_CONNECTION est définie sur true, le paramètre synchronous_replication est défini sur true par défaut dans le fichier env.php des environnements d’évaluation et de production Pro. Lorsque MYSQL_USE_SLAVE_CONNECTION est défini sur false, le paramètre synchronous_replication n’est pas configuré.

QUEUE_CONFIGURATION

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

Utilisez cette variable d’environnement pour conserver les paramètres de service AMQP personnalisés entre les déploiements. Par exemple, si vous préférez utiliser un service de file d’attente de messages existant plutôt que de vous fier à l’infrastructure cloud pour le créer, utilisez la variable d’environnement QUEUE_CONFIGURATION pour la connecter à votre site :

stage:
  deploy:
    QUEUE_CONFIGURATION:
      amqp:
        host: test.host
        port: 1234
      amqp2:
        host: test.host2
        port: 12345
      mq:
        host: mq.host
        port: 1234

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne de nouvelles valeurs avec une configuration existante :

stage:
  deploy:
    QUEUE_CONFIGURATION:
      _merge: true
      amqp:
        host: changed1.host
        port: 5672
      amqp2:
        host: changed2.host2
        port: 12345
      mq:
        host: changedmq.host
        port: 1234

REDIS_BACKEND

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

Spécifie la configuration du modèle principal pour le cache Redis.

Adobe Commerce version 2.3.0 et ultérieure comprend les modèles principaux suivants :

  • Cm_Cache_Backend_Redis
  • \Magento\Framework\Cache\Backend\Redis
  • \Magento\Framework\Cache\Backend\RemoteSynchronizedCache

Exemple de définition de REDIS_BACKEND

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
NOTE
Si vous spécifiez \Magento\Framework\Cache\Backend\RemoteSynchronizedCache comme modèle principal Redis pour activer le cache L2, ece-tools génère automatiquement la configuration du cache. Voir un exemple de fichier de configuration dans le Guide de configuration Adobe Commerce. Pour remplacer la configuration de cache générée, utilisez la variable de déploiement CACHE_CONFIGURATION.

REDIS_USE_SLAVE_CONNECTION

  • Par défautfalse
  • Version—Adobe Commerce 2.1.16 et versions ultérieures
WARNING
N’activez pas pas cette variable sur un projet d’architecture mise à l’échelle. Cela entraîne des erreurs de connexion Redis. Les esclaves Redis sont toujours actifs mais ne sont pas utilisés pour les lectures Redis. Adobe recommande d’utiliser Adobe Commerce 2.3.5 ou version ultérieure, de mettre en oeuvre une nouvelle configuration de serveur principal Redis et de mettre en cache L2 pour Redis.
TIP
La variable REDIS_USE_SLAVE_CONNECTION n’est prise en charge que sur Adobe Commerce dans les environnements de grappe d’infrastructure cloud Staging et Production Pro et n’est pas prise en charge dans les projets de démarrage.

Adobe Commerce peut lire plusieurs instances Redis de manière asynchrone. Définissez cette variable sur true pour utiliser automatiquement une connexion en lecture seule à une instance Redis afin de recevoir du trafic en lecture seule sur un noeud non maître. Cette connexion améliore les performances grâce à l’équilibrage de charge, car un seul noeud traite le trafic lecture-écriture. Définissez cette variable sur false pour supprimer tout tableau de connexion en lecture seule existant du fichier env.php.

stage:
  deploy:
    REDIS_USE_SLAVE_CONNECTION: true

Un service Redis doit être configuré dans le fichier .magento.app.yaml et dans le fichier services.yaml.

CEE-Outils version 2002.0.18 et versions ultérieures utilise des paramètres plus tolérants aux pannes. Si Adobe Commerce ne peut pas lire les données de l’instance Redis esclave, il lit les données de l’instance Redis master.

La connexion en lecture seule n’est pas disponible dans l’environnement d’intégration ou si vous utilisez la variable CACHE_CONFIGURATION.

RESOURCE_CONFIGURATION

  • Default—Non défini
  • Version—Adobe Commerce 2.1.4 et versions ultérieures

Mappe un nom de ressource à une connexion à la base de données ; Cette configuration correspond à la section resource du fichier env.php.

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne de nouvelles valeurs avec une configuration existante :

stage:
  deploy:
    RESOURCE_CONFIGURATION:
      _merge: true
      default_setup:
        connection: default

SCD_COMPRESSION_LEVEL

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

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

stage:
  deploy:
    SCD_COMPRESSION_LEVEL: 5

SCD_COMPRESSION_TIMEOUT

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

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:
  deploy:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_MATRIX

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

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

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

stage:
  deploy:
    SCD_MATRIX:
      "magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA

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

stage:
  deploy:
    SCD_MATRIX:
      "magento/backend": [ ]

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 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:
  deploy:
    SCD_MAX_EXECUTION_TIME: 3600
WARNING
Si vous rencontrez des problèmes avec des fichiers de contenu statiques dans votre application après le déploiement, tels que l’absence de fichiers de thème personnalisés, augmentez le temps d’exécution maximum prévu à 900 secondes ou plus.

SCD_NO_PARENT

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

Lors de la phase de déploiement, définissez SCD_NO_PARENT: true de sorte que la génération du contenu statique pour les thèmes parents ne se produise pas pendant la phase de déploiement. Ce paramètre réduit le temps de déploiement et évite les temps d’arrêt du site qui peuvent se produire si la génération de contenu statique échoue pendant le déploiement. Voir Déploiement de contenu statique.

stage:
  deploy:
    SCD_NO_PARENT: true

SCD_STRATEGY

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

Permet de personnaliser 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 :

  • standard : déploie tous les fichiers d’affichage statique pour tous les modules.
  • quick—(default) minimise le temps de déploiement.
  • compact : conserve l’espace disque sur le serveur. Dans Adobe Commerce version 2.2.4 et antérieure, ce paramètre remplace la valeur de scd_threads par une valeur de 1.
stage:
  deploy:
    SCD_STRATEGY: "compact"

SCD_THREADS

  • Default—Automatique
  • Version—Adobe Commerce 2.1.4 et versions ultérieures

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:
  deploy:
    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.

SEARCH_CONFIGURATION

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

Utilisez cette variable d’environnement pour conserver les paramètres de service de recherche personnalisés entre les déploiements. Par exemple :

Configuration Elasticsearch :

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: elasticsearch
      elasticsearch_server_hostname: http://elasticsearch.internal
      elasticsearch_server_port: '9200'
      elasticsearch_index_prefix: magento2
      elasticsearch_server_timeout: '15'

Configuration OpenSearch (pour Commerce 2.4.6 et versions ultérieures) :

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: opensearch
      opensearch_server_hostname: 'http://opensearch.internal'
      opensearch_server_port: '9200'
      opensearch_index_prefix: 'magento2'
      opensearch_server_timeout: '15'

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne une nouvelle valeur avec la configuration existante :

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: elasticsearch
      elasticsearch_server_port: '9200'
      _merge: true

SESSION_CONFIGURATION

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

Configurez le stockage de la session Redis. Nécessite les options save, redis, host, port et database pour la variable de stockage de session. Par exemple :

stage:
  deploy:
    SESSION_CONFIGURATION:
      redis:
        bot_first_lifetime: 100
        bot_lifetime: 10001
        database: 0
        disable_locking: 1
        host: redis.internal
        max_concurrency: 10
        max_lifetime: 10001
        min_lifetime: 100
        port: 6379
      save: redis

Par défaut, le processus de déploiement remplace tous les paramètres du fichier env.php. Cependant, vous pouvez choisir de fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez l’option _merge sur l’une des options suivantes :

  • trueFusionner les valeurs de service configurées avec les valeurs de variable d’environnement.
  • falseRemplacer les valeurs de service configurées par les valeurs de variable d’environnement.

L’exemple suivant fusionne une nouvelle valeur avec la configuration existante :

stage:
  deploy:
    SESSION_CONFIGURATION:
      _merge: true
      redis:
        max_concurrency: 10

SKIP_SCD

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

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

Lors de la phase de déploiement, définissez SKIP_SCD: true de sorte que la création de contenu statique ne se produise pas pendant la phase de déploiement. Ce paramètre réduit le temps de déploiement et évite les temps d’arrêt du site qui peuvent se produire si la génération de contenu statique échoue pendant le déploiement. Voir Déploiement de contenu statique.

stage:
  deploy:
    SKIP_SCD: true

UPDATE_URLS

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

Lors du déploiement, remplacez les URL de base Adobe Commerce dans la base de données par les URL de projet spécifiées par la variable MAGENTO_CLOUD_ROUTES. Cette configuration est utile pour le développement local, où les URL de base sont configurées pour votre environnement local. Lorsque vous effectuez un déploiement dans un environnement cloud, les URL sont mises à jour afin que vous puissiez accéder à votre storefront et à votre administrateur à l’aide des URL du projet.

Si vous devez mettre à jour les URL lors du déploiement vers les environnements d’évaluation et de production Pro ou Starter, utilisez la variable FORCE_UPDATE_URLS.

stage:
  deploy:
    UPDATE_URLS: false

VERBOSE_COMMANDS

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

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.

NOTE
Pour utiliser le paramètre VERBOSE_COMMANDS afin de contrôler le détail en sortie de commande pour les commandes CLI bin/magento réussies et échouées, vous devez définir MIN_LOGGING_LEVEL debug.

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

  • -v= sortie normale
  • -vv= sortie plus détaillée
  • -vvv = sortie verbeuse idéale pour le débogage
stage:
  deploy:
    VERBOSE_COMMANDS: "-vv"
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26