Notes de mise à jour de CEE-Outils

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 : prise en charge de PHP 8.1.

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

Processus multiples de consommateur : ajout d’une option multiple_processes afin que vous puissiez spécifier le nombre de processus à générer pour chaque consommateur. Voir la description de la variable CRON_CONSUMERS_RUNNER dans Déployer des variables.

OpenSearch scheme et chemin d’accès d’hôte complet : ajout de la possibilité de configurer un schéma d’Elasticsearch et un chemin d’accès d’hôte complet.

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

Fix driver_options reader—Ajout de la configuration de lecture driver_options pour la connexion DB du fichier env.php par 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 composer.json de la version CEE-Outils pour le package symphony/console afin de résoudre un problème qui entraînait l’échec des commandes di:compile avec l’erreur suivante : Incompatible argument type: Required type: int. Actual type: string

Mise à jour des vérifications de logiciels de fin de vie (eol.yaml) pour inclure Elasticsearch 7.9.x.

Redis authentication credentials : 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 comme deuxième option pour le stockage de session. Vous pouvez utiliser le service redis-session pour stocker des informations de session et utiliser le service redis pour le cache afin de fournir de meilleures performances.

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

version Elasticsearch à partir des relations—Correction du programme de validation des services pour récupérer la version correcte de l’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'empêcher 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 des fichiers multimédias à l’aide d’un service de stockage, tel qu’AWS S3. Cette option de configuration fait partie du package CEE-Outils, mais n'est pas prise en charge sur Adobe Commerce sur l'infrastructure cloud.

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

Purge du cache de l’ouverture—Ajout de la prise en charge de l’option opcache.enable_cli PHP pour vider le cache de l’opération avant d’exécuter le crochet 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 d’Aurora DB—Mise à jour de la validation du service de base de données afin qu’il 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 en raison duquel les commandes 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 plus qu'un sous-ensemble plus petit de données du fichier journal.

​ ​: correction d’un problème de configuration .magento.env.yaml en raison duquel les connexions de base de données personnalisées 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’erreur vides : correction d’un problème qui provoquait l’échec des déploiements si le cloud.error.log était vide.

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

Cache:flush logging—Amélioration des entrées de journal pour indiquer le début et la fin de l’étape cache:flush.

Ajout de la prise en charge des outils CEE pour le répertoire pub/static en lecture seule lorsque le contenu statique est défini pour ê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 des outils de la gestion des balises numériques composer.json pour ajouter une dépendance requise pour l’outil de correctifs de qualité. Ceci corrige une dépendance circulaire qui existait entre les packages EC-Tools et magento-cloud-patches.

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

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

Mise à jour du message d’erreur de compatibilité des Elasticsearch pour afficher les versions d’Elasticsearch compatibles avec le module d’Elasticsearch Adobe Commerce. Le message d’erreur fournit désormais les versions spécifiques de l’Elasticsearch à 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, déploiement de l’étape.

Ajout d’erreurs d’avertissement 2026 et 2027 pour le paramètre de variable d’environnement MAGE_MODE non valide. La seule valeur valide est production. Avant ce correctif, MAGE_MODE pouvait être défini sur developer sans erreurs de déploiement, pour entraîner des erreurs ultérieurement lors de la tentative 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 d’Adobe Commerce. Les versions valides de ces services sont maintenant écrites dans le cloud.log.

Mise à jour de cloud.log afin d’inclure la limite des demandes simultanées pour envoyer des demandes pendant la chaleur du cache. Cette valeur est configurée dans la variable WARM_UP_CONCURRENCY post-déploiement.

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

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

Ajout de vérifications d’erreurs supplémentaires pour créer, déployer et post-déployer le traitement 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 modifiable .

Ajout de la variable d’environnement QUALITY_PATCH 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 les outils-citoyen.

• 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 pour clarifier que l’opération de vidage de base de données passe en mode de maintenance, arrête les processus de file d’attente des consommateurs et désactive les tâches cron avant le début de la vidage.

• Correction d’un problème pour 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 version generate.xml pour appliquer des correctifs. Des correctifs doivent être appliqués plus tôt pour mettre à jour Adobe Commerce afin de résoudre les problèmes susceptibles d'entraîner l'échec des étapes di:compile et module:refresh.

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

Mises à jour du service—

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

Mises à jour de variable 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 les 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 2.3.5 ou version ultérieure. Voir la description de la variable dans deploy variables.

Mises à jour de la commande CLI—

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

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

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

Améliorations de la validation—

• Vérifications de compatibilité Elasticsearch 7.x—Mise à jour de la validation Elasticsearch pour les vérifications de compatibilité des logiciels Elasticsearch 7.x.

• {Mise à jour des contrôles de version de service et de validation EOL—Mise à jour de la validation afin de vérifier les versions de service installées par rapport aux exigences d’Adobe Commerce 2.4.

• Correction d’un problème de validation de sorte que le message d’avertissement suivant après le déploiement s’affiche uniquement si la configuration du crochet post-deploy est manquante dans le fichier .magento.app.yaml :

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

• Ajout de la validation des dépendances Zend Framework : ajout de la validation de la dépendance de 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érification des dépendances du Zend Framework.

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

  • Si le fichier env.php est manquant dans 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 pour Commerce : découplé 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 magento-cloud-docker GitHub.

• {Fonctionnalités de correction mises à jour : déplacement de la fonctionnalité de correction du package CEE-Outils 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 de 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 comprend des dépendances pour tous les packages de 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 antérieure de CEE-Outils 2002.0.x est toujours pris en charge. Cependant, vous devez effectuer une mise à jour vers le nouveau format pour utiliser la fonctionnalité de déploiement basée sur un scénario. Voir Déploiements basés sur des scénarios.