Déploiement de variables

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

stage:
  deploy:
    DEPLOY_VARIABLE_NAME: value

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

CACHE_CONFIGURATION

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

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 env.php vous pouvez toutefois fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez la variable _merge à l’une des options suivantes :

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 méthode Fonction de préchargement Redis comme défini dans la variable 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 une REDIS_BACKEND (et pas uniquement à partir de la liste autorisée), définissez la variable _custom_redis_backend option à true pour activer la validation correcte, comme dans l’exemple suivant :

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

CLEAN_STATIC_FILES

Active ou désactive le nettoyage fichiers de contenu statique générés pendant la phase de création ou de déploiement. Utiliser la valeur par défaut true dans le développement en tant que bonne pratique.

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 de secours de fichier statique règles, les opérations de secours peuvent afficher un fichier incorrect si le répertoire contient plusieurs versions du même fichier.

CRON_CONSUMERS_RUNNER

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

Exemple de tableau qui exécute des consumers et la variable multiple_processes pour 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 tout 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 env.php fichier . 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

Configuration de consumers traitez les messages de la file d’attente des messages en sélectionnant l’une des options suivantes :

stage:
  deploy:
    CONSUMERS_WAIT_FOR_MAX_MESSAGES: false

CRYPT_KEY

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 la variable Cloud Console comme la propriété crypt/key dans la variable env.php fichier .

DATABASE_CONFIGURATION

Si vous avez défini une base de données dans la variable propriété relations de .magento.app.yaml , vous pouvez personnaliser les connexions de votre 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 env.php vous pouvez toutefois fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez la variable _merge à l’une des options suivantes :

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.

L’exemple suivant utilise la méthode ece_ préfixe de tableau avec les paramètres de connexion par défaut au lieu d’utiliser la variable _merge option :

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

Conserve la personnalisation Elastic Suite Paramètres du service entre les déploiements et l’utilise dans la section "system/default/smile_élasticsuite_core_base_settings" de la section principale Elastic Suite configuration. Si la variable Elastic Suite Le package de compositeur 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

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

Définissez la variable _merge à l’une des options suivantes :

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:

ENABLE_GOOGLE_ANALYTICS

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.

Ajoutez la variable ENABLE_GOOGLE_ANALYTICS de la variable d’environnement deploy dans la .magento.env.yaml fichier :

stage:
  deploy:
    ENABLE_GOOGLE_ANALYTICS: true

FORCE_UPDATE_URLS

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 Variable . Utilisez ce paramètre pour remplacer le comportement par défaut de la variable UPDATE_URLS Variable deploy, qui est ignorée lors du déploiement dans les environnements d’évaluation ou de production.

stage:
  deploy:
    FORCE_UPDATE_URLS: true

LOCK_PROVIDER

Le fournisseur de verrouillage empêche le lancement de tâches cron en double et de groupes cron. Utilisez la variable file fournisseur de verrouillage 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 , etc. ece-tools applique la variable db fournisseur de verrouillage automatiquement.

stage:
  deploy:
    LOCK_PROVIDER: "db"

Voir Configuration du verrouillage dans le Guide d’installation.

MYSQL_USE_SLAVE_CONNECTION

Adobe Commerce peut lire plusieurs bases de données de manière asynchrone. Définissez sur . true pour utiliser automatiquement un lecture seule connexion à 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 sur . false pour supprimer tout tableau de connexion en lecture seule existant du env.php fichier .

stage:
  deploy:
    MYSQL_USE_SLAVE_CONNECTION: true

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

QUEUE_CONFIGURATION

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 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 env.php vous pouvez toutefois fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez la variable _merge à l’une des options suivantes :

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

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 :

L’exemple de définition de REDIS_BACKEND

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

REDIS_USE_SLAVE_CONNECTION

Adobe Commerce peut lire plusieurs instances Redis de manière asynchrone. Définissez sur . true pour utiliser automatiquement un lecture seule connexion à une instance Redis 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 sur . false pour supprimer tout tableau de connexion en lecture seule existant du env.php fichier .

stage:
  deploy:
    REDIS_USE_SLAVE_CONNECTION: true

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

CEE-Outils version 2002.0.18 et plus tard utilise des paramètres plus tolérants aux erreurs. Si Adobe Commerce ne peut pas lire les données des Redis esclave , puis il lit les données du Redis master instance.

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

RESOURCE_CONFIGURATION

Mappe un nom de ressource à une connexion à la base de données ; Ce paramétrage correspond au resource de la env.php fichier .

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

Définissez la variable _merge à l’une des options suivantes :

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

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

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:
  deploy:
    SCD_COMPRESSION_LEVEL: 5

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

SCD_MATRIX

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. Vous pouvez, par exemple, déployer le magento/backend en anglais et un thème personnalisé dans d’autres langues.

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

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

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

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

SCD_NO_PARENT

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

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

SEARCH_CONFIGURATION

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 env.php vous pouvez toutefois fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez la variable _merge à l’une des options suivantes :

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

Configurez le stockage de la session Redis. Nécessite le save, redis, host, port, et database options de 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 env.php vous pouvez toutefois fusionner une ou plusieurs valeurs pour une configuration de service sans remplacer toutes les valeurs.

Définissez la variable _merge à l’une des options suivantes :

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

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

SKIP_SCD

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

Lors de la phase de déploiement, définissez SKIP_SCD: true afin 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

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 Variable . 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 dans les environnements Pro ou Starter Staging et Production, utilisez la variable FORCE_UPDATE_URLS Variable .

stage:
  deploy:
    UPDATE_URLS: 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:
  deploy:
    VERBOSE_COMMANDS: "-vv"