Notes de mise à jour des outils de la CEE

OpenSearch—Ajout de la prise en charge d’OpenSearch pour Adobe Commerce versions 2.4.4, 2.4.3-p2 et 2.3.7-p3.

PHP—Ajout de la prise en charge de PHP 8.1.

symfony/process—Ajout de la compatibilité avec symfony/process ^5.3.

Consommateur de plusieurs processus—Ajout d’une option multiple_processes afin que vous puissiez spécifier le nombre de processus à générer pour chaque client. Voir la description de la variable CRON_CONSUMERS_RUNNER dans la section Déployer les variables.

Schéma OpenSearch et chemin d’accès hôte complet—Ajout de la possibilité de configurer un schéma Elasticsearch et un chemin d’accès hôte complet.

AWS S3 : modification de la méthode d’activation d’AWS S3.

Corriger le lecteur driver_options—Ajout de la lecture de la configuration driver_options pour la connexion à la base de données à partir du fichier env.php en ece-tools pour les validateurs.

Ajout de la prise en charge du compositeur 2.0.

Mise à jour des exigences du compositeur poursymphony/console—Mise à jour des exigences de version du composer.json ECE-Tools pour le package symphony/console afin de résoudre un problème qui a provoqué l’échec des commandes di:compile avec l’erreur suivante : Incompatible argument type: Required type: int. Actual type: string

Mise à jour des contrôles logiciels de fin de vie (eol.yaml) afin d’inclure Elasticsearch 7.9.x.

Informations d’identification d’authentification Redis—Ajout de la possibilité de lire les informations d’identification d’autorisation Redis à partir de la propriété relationships pendant la phase de déploiement.

informations d’identification d’autorisation Elasticsearch—Ajout de la possibilité de lire les informations d’identification d’autorisation Elasticsearch à partir de la propriété relationships pendant la phase de déploiement.

Service de stockage de session dédié—Ajout de redis-session en tant que seconde option pour le stockage de session. Vous pouvez utiliser le service redis-session pour stocker les informations de session et utiliser le service redis pour le cache afin d’offrir de meilleures performances.

Messages SPLIT_DB obsolètes—Ajout de messages d’avertissement et critiques du programme de validation pour l’option de SPLIT_DB obsolète d’Adobe Commerce 2.4.2 et sa suppression dans Adobe Commerce 2.5.0.

version d’Elasticsearch à partir des relations—Correction du validateur de service pour récupérer la version correcte d’Elasticsearch à partir des propriétés relationships dans Cloud Docker et les environnements d’intégration.

validation flexible du port Redis : Redis peut désormais valider le port dans une connexion de cache personnalisée à partir de l’URL server. Par exemple, vous pouvez ajouter votre numéro de port à l’URL de votre serveur comme suit : server: 'tcp://rfs-store-simple-page-cache:26379'. Cela permet d’éviter les erreurs de validation lorsque l’option port est manquante ou incorrecte.

Mise à niveau vers Adobe Commerce 2.4.2—Correction du problème qui obligeait les utilisateurs à exécuter manuellement bin/magento setup:upgrade pour que leurs sites soient opérationnels après la mise à niveau vers Adobe Commerce 2.4.2.

Stockage à distance : ajout de la variable d’environnement REMOTE_STORAGE pour activer les projets cloud pour le stockage à distance de fichiers multimédias à l’aide d’un service de stockage, tel qu’AWS S3. Cette option de configuration fait partie du package ECE-Tools, mais n’est pas prise en charge sur Adobe Commerce sur les infrastructures cloud.

Nouvelle commande de cloud:config:validate—Ajout d’une php vendor/bin/ece-tools cloud:config:validate de commande pour valider la configuration .magento.env.yaml avant de pousser les modifications vers l’environnement cloud distant.

Vidage de l’opcache—Ajout de la prise en charge de l’option opcache.enable_cli PHP pour vider l’opcache avant d’exécuter le hook de déploiement. Cette configuration réinitialise la configuration du cache pour s’assurer que les paramètres de configuration actuels sont appliqués à chaque déploiement.

Validation de la base de données Aurora—Mise à jour de la validation du service de base de données afin qu’elle soit compatible avec la base de données Aurora.

Nouvelle variable d’environnement SCD_NO_PARENT : ajout de la variable d’environnement SCD_NO_PARENT (pour Adobe Commerce >=2.4.2) pour gérer la génération de contenu statique pour les thèmes parents.

limites et commandes de mémoire—Correction d’un problème où les commandes de php vendor/bin/ece-tools ne fonctionnaient pas si la taille du fichier cloud.log dépassait la limite de mémoire PHP. Au lieu de lire l’intégralité du fichier cloud.log en mémoire, nous ne lisons désormais qu’un plus petit sous-ensemble de données à partir du fichier journal.

Connexions à la base de données personnalisée—Correction d’un problème de configuration .magento.env.yaml en raison duquel les connexions à la base de données personnalisée définies pour DATABASE_CONFIGURATION n’étaient pas utilisées. Les paramètres de connexion n’ont pas été ajoutés à app/etc/env.php.

Journaux d’erreurs vides—Correction d’un problème en raison duquel les déploiements échouaient si le cloud.error.log était vide.

Validation de MariaDB 10.3—Correction de la validation de MariaDB 10.3 pour Adobe Commerce 2.3.6-p1.

cache:flush journalisation : amélioration des entrées de journal pour indiquer le début et la fin de l’étape de cache:flush.

Ajout de la prise en charge des outils ECE pour le répertoire pub/static en lecture seule lorsque le contenu statique est prêt à être déployé à l’étape de création.

Ajout de la prise en charge d’Elasticsearch 7.9 et de Redis 6 pour la compatibilité avec les prochaines versions d’Adobe Commerce.

Mise à jour du composer.json ECE-Tools pour ajouter une dépendance requise pour l’outil de correctifs de qualité. Ceci corrige une dépendance circulaire qui existait entre les paquets ECE-Tools et magento-cloud-patches.

Ajout d’une validation du moteur de recherche pour s’assurer que elasticsearch est défini pour Adobe Commerce sur les infrastructures cloud 2.4 et versions ultérieures. Si la validation échoue, le déploiement est arrêté avec un message d’erreur critique qui suggère des correctifs pour le problème. Voir Erreurs critiques, étape de déploiement.

Ajout d’une validation Elasticsearch pour vérifier la compatibilité entre la version du service Elasticsearch et la version Adobe Commerce.

Mise à jour du message d’erreur de compatibilité d’Elasticsearch pour afficher les versions d’Elasticsearch compatibles avec le module Adobe Commerce Elasticsearch. Le message d’erreur indique désormais les versions Elasticsearch spécifiques à installer dans votre infrastructure cloud afin qu’elle soit compatible avec le module Elasticsearch utilisé par votre version d’Adobe Commerce. Voir Erreurs d’avertissement, étape de déploiement.

Ajout d’erreurs d’avertissement 2026 et 2027 pour les paramètres de variable d’environnement MAGE_MODE non valides. La seule valeur valide est production. Avant ce correctif, MAGE_MODE pouvait être défini sur developer sans erreur de déploiement, pour entraîner ultérieurement des erreurs lors de tentatives d’écriture dans des fichiers en lecture seule. Voir Erreurs d’avertissement.

Correction de la validation des services Redis, RabbitMQ et MySQL pour s’assurer que ces versions sont compatibles avec la version Adobe Commerce. Des versions valides de ces services sont désormais écrites dans le cloud.log.

Mise à jour du cloud.log afin d’inclure la limite de requêtes simultanées pour l’envoi de requêtes pendant le préchauffage du cache. Cette valeur est configurée dans la variable post-déploiement WARM_UP_CONCURRENCY.

Ajout du fichier schema.error.yaml qui comprend toutes les notifications d’erreur et d’avertissement qui peuvent se produire pendant les processus de création, de déploiement et de post-déploiement, ainsi que des suggestions pour résoudre les erreurs. Les informations contenues dans ce fichier sont également disponibles dans le Guide cloud pour Commerce. Voir Référence du message d’erreur pour ece-tools.

Modification des entrées du journal d’erreurs cloud (/var/log/cloud.error.log) au format JSON afin de faciliter l’analyse du journal par programmation.

Ajout de vérifications d’erreur supplémentaires pour le traitement de création, de déploiement et de post-déploiement, et amélioration des vérifications existantes :

• Code d’erreur 2026 : échec de la restauration de certaines données générées pendant la phase de création dans les répertoires montés

• Code d’erreur 3004 : impossible de créer des fichiers de sauvegarde

• Code d’erreur 102 : ajout de vérifications supplémentaires pour les problèmes qui se produisent lorsque le fichier env.php n’est pas accessible en écriture

Ajout de la variable d’environnement QUALITY_PATCHES pour spécifier un ou plusieurs correctifs de qualité à appliquer pendant le processus de déploiement. Voir Créer des variables.

Mises à jour de l’infrastructure—

• Améliorations de la journalisation : amélioration de la fonctionnalité de suivi des journaux en attribuant des codes de sortie aux erreurs de déploiement critiques et en exposant les codes de sortie dans les notifications de messages d’erreur et les événements de journal. Voir Référence du message d’erreur pour ece-tools.

• Amélioration du processus pour les vidages de base de données (vendor/bin/ece-tools db-dump) et mise à jour des messages de journal afin de clarifier que l’opération de vidage de base de données fait passer l’application en mode de maintenance, arrête les processus de file d’attente des clients et désactive les tâches cron avant le début du vidage.

• Correction d’un problème afin de s’assurer que l’URL du projet est correctement mise à jour lors du déploiement dans les environnements d’évaluation et de production. Désormais, ece-tools utilise l’URL de l’itinéraire avec l’attribut primary:true défini dans la configuration de l’itinéraire du projet. Voir Déploiement de variables.

• Mise à jour du workflow de scénario de build generate.xml pour l’application de correctifs. Des correctifs doivent être appliqués plus tôt pour mettre à jour Adobe Commerce afin de résoudre tous les problèmes qui peuvent entraîner l’échec des étapes di:compile et module:refresh.

• Correction d’un problème dans le processus d’installation qui renvoyait incorrectement l’erreur Crypt key missing. La valeur crypt/key est générée automatiquement lors de l’installation.

Mises à jour des services—

• Ajout de la prise en charge de PHP 7.4 et MariaDB 10.4.

Mises à jour des variables d’environnement—

• Ajout de la variable SCD_USE_BALER pour activer le module Baler pour le regroupement JavaScript pendant le processus de création d’Adobe Commerce sur l’infrastructure cloud. Voir la description de la variable dans la section Variables de build.

• Ajout de la variable d’environnement REDIS_BACKEND pour configurer le modèle principal Redis pour le cache Redis pour Adobe Commerce version 2.3.5 ou ultérieure. Voir la description de la variable dans la déploiement des variables.

mises à jour des commandes CLI—

• Mise à jour des commandes d’interface de ligne de commande suivantes avec une option pour une journalisation plus détaillée :

  • app:config:dump
  • app:config:import
  • module:enable

  Le niveau de journalisation pour chaque appel est déterminé par la configuration de la variable VERBOSE_COMMANDS dans le fichier .magento.env.yaml.

Améliorations de la validation—

• Contrôles de compatibilité Elasticsearch 7.x—Mise à jour de la validation Elasticsearch pour les contrôles de compatibilité logicielle Elasticsearch 7.x.

• Contrôles de version de service et de validation de fin de vie mis à jour—Validation mise à jour pour vérifier les versions de service installées par rapport à Adobe Commerce 2.4. requirements.

• Correction d’un problème de validation en raison duquel le message d’avertissement post-déploiement suivant s’affichait uniquement si la configuration du hook post-deploy était absente du fichier .magento.app.yaml :

  code language-text
  Your application does not have the "post_deploy" hook enabled.

• Ajout de la validation pour les dépendances de Zend Framework—Ajout de la validation des dépendances du compositeur pour Zend Framework qui a migré vers le projet Laminas. Si les dépendances requises sont manquantes, le message d’erreur suivant s’affiche pendant le processus de création.

  code language-text
  Required configuration is missing from the autoload section of the composer.json file. Add ("Laminas\Mvc\Controller\Zend\": "setupsrc/ Zend/Mvc/Controller/") to the `autoload -> psr-4` section. Then, re-run the "composer update" command locally, and commit the updated composer.json and composer.lock files.

  Voir Vérifier les dépendances de Zend Framework.

• Ajout d’une validation pour env.php fichier et les données—Ajout de vérifications pour le fichier et les données env.php pendant le processus d’installation et de mise à niveau.

  • Si le fichier env.php est absent de l’installation et que la valeur crypt/key n’est pas spécifiée dans le fichier .magento.app.yaml, le déploiement échoue avec la notification suivante :

    code language-text
    The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable``Missing crypt key for upgrading Magento`.

  • Si l’installation n’inclut pas le fichier env.php ou si la configuration ne contient qu’un seul type de cache, la commande cron:enable s’exécute pendant le processus de mise à niveau pour restaurer le fichier avec tous les cache_types. La notification suivante est ajoutée au journal :

    code language-text
    Magento state indicated as installed but configuration file app/etc/env.php was empty or did not exist. Required data will be restored from environment configurations and from the .magento.env.yaml file.

Mises à jour de l’infrastructure—

• Ajout d’un package distinct pour Cloud Docker for Commerce—Découplage le package Docker du package ece-tools pour maintenir la qualité du code et fournir des versions indépendantes. Les mises à jour et les correctifs liés à ece-tools sont gérés à partir du référentiel GitHub magento-cloud-docker.

• Fonctionnalités de correction mises à jour—Déplacement de la fonctionnalité de correction du package ECE-Tools vers un package magento-cloud-patches distinct. Pendant le déploiement, ece-tools utilise le nouveau package pour appliquer des correctifs. Voir Notes de mise à jour des correctifs cloud.

• Dépendances du compositeur mises à jour—Mise à jour du fichier composer.json pour Adobe Commerce sur l’infrastructure cloud avec une dépendance pour le package magento/magento-cloud-docker. Désormais, ece-tools inclut des dépendances pour tous les packages du Cloud Tools Suite for Commerce. Ces packages sont installés et mis à jour automatiquement lorsque vous installez ou mettez à jour ece-tools.

prise en charge des déploiements basés sur des scénarios—

• Vous pouvez désormais personnaliser les processus de création, de déploiement et de post-déploiement à l’aide de fichiers de configuration XML pour remplacer ou personnaliser la configuration par défaut.

• Modification de la configuration hooks dans.magento.app.yaml—Nous avons mis à jour le format de configuration hooks pour prendre en charge les déploiements basés sur des scénarios. Le format hérité de la version 2002.0.x de ECE-Tools antérieure est toujours pris en charge. Cependant, vous devez effectuer une mise à jour vers le nouveau format pour utiliser la fonctionnalité de déploiement basé sur un scénario. Voir Déploiements basés sur des scénarios.

Mises à jour des services—

• Ajout de la prise en charge de PHP 7.3.

• Ajout de la prise en charge de RabbitMQ 3.8.

• Ajout d’une validation pour vérifier les versions de service installées par rapport à la date de fin de vie de chaque service. Désormais, les clients reçoivent une notification si une version de service est dans les trois mois suivant la date de fin de vie, ainsi qu’un avertissement si la date de fin de vie est dans le passé.

• correction d’un problème de configuration d’Elasticsearch afin de s’assurer que les paramètres Elasticsearch appropriés sont configurés dans tous les environnements.

Mises à jour des variables d’environnement—

• Extension de la fonctionnalité de la variable d’environnement WARM_UP_PAGES afin de prendre en charge le préchargement du cache pour des pages de produits spécifiques. Consultez la définition développée dans la rubrique variables post-déploiement.

• Ajout de la variable d’environnement ERROR_REPORT_DIR_NESTING_LEVEL pour simplifier la gestion des données du rapport d’erreur dans le répertoire <magento_root>/var/report/. Voir la description de la variable dans la rubrique créer des variables.

• Supprimez les variables d’environnement SCD_EXCLUDE_THEMES, STATIC_CONTENT_THREADS, DO_DEPLOY_STATIC_CONTENT et STATIC_CONTENT_SYMLINK. Voir Modifications rétrocompatibles.

• correction d’un problème dans le processus de configuration d’Elastic Suite afin que la configuration par défaut soit remplacée comme prévu lorsque vous configurez la variable de déploiement ELASTICSUITE_CONFIGURATION sans l’option _merge.

mises à jour des commandes CLI—

• Nouvelle commande cron—Vous pouvez désormais gérer manuellement le traitement cron dans votre environnement Adobe Commerce sur l’infrastructure cloud à l’aide des commandes cron:disable et cron:enable. Utilisez la commande disable pour arrêter tous les processus cron actifs et désactiver toutes les tâches cron. Utilisez la commande d’activation pour réactiver les tâches cron lorsque vous êtes prêt. Voir ​ Désactiver les tâches cron ​.

• Amélioration des rapports d’erreur—Ajout d’une meilleure journalisation pour les défaillances de commande CLI qui se produisent pendant le traitement ECE-Tools.

• Supprimer les commandes de build obsolètes— Suppression des commandes de build suivantes : m2-ece-build, m2-ece-deploy, m2-ece-scd-dump, et renommage des commandes de ece-tools docker en ece-docker. Voir Modifications rétrocompatibles

Suppression du fichier build_options.ini obsolète et ajout de la validation pour faire échouer la version si le fichier existe. Utilisez le fichier .magento.env.yaml pour configurer les options de génération.

correction d’un problème en raison duquel le processus de création échouait lorsque le fichier config.php était vide.