Notes de mise à jour de CEE-Outils

Le package ece-tools est un ensemble de scripts et d’outils conçus pour gérer et déployer des projets Cloud. Ces notes de mise à jour décrivent les dernières améliorations apportées à ce module, qui fait partie de la suite d’outils cloud pour Commerce.

NOTE
Voir Mise à niveau de CEE-Outils pour plus d’informations sur la mise à jour vers la dernière version du package ece-tools.

Le package ece-tools utilise la séquence de contrôle de version suivante : 200<major>.<minor>.<patch>

Les notes de mise à jour incluent :

  • nouvelle icône Nouvelles fonctionnalités
  • Icône de correctif Correctifs et améliorations

v2002.2.0 latest

Date de publication : 7 octobre 2024

  • nouvelle icône MariaDB 11.4 - Prise en charge supplémentaire de MariaDB 11.4.
  • icône de correctif Code restructuré-Suppression de la prise en charge des anciennes versions de PHP 7.4, 7.3, 7.2 et des bibliothèques associées.
  • icône de correctif Mise à niveau de la version de Monolog - Ajout de la prise en charge de monolog 3.6.
  • icône de correctif Validator for RabbitMQ, MariaDB et PHP - Correction du programme de validation qui produisait un message trompeur sur la mauvaise version du service.

v2002.1.19

Date de publication : 21 mai 2024

  • nouvelle icône Lua : ajout de l’option useLua pour CACHE_CONFIGURATION.
  • Icône de correctif Validator—Mise à jour des validateurs pour les nouvelles versions de Redis et RabbitMQ.

v2002.1.18

Date de publication : 8 avril 2024

  • nouvelle icône PHP — Prise en charge de PHP 8.3.
  • icône de correctif Validator - Validator EOL mise à jour

v2002.1.17

Date de publication : 16 janvier 2024

  • Icône de correctif Validator for Elasticsearch & OpenSearch—Correction du programme de validation qui produisait un message trompeur pour installer un service de recherche lorsque LiveSearch est activé.
  • Icône de correctif Avertissement de déploiement—Correction d’un problème qui entraînait des avertissements de déploiement sur les dossiers non vides.

v2002.1.16

Date de publication : 16 octobre 2023

  • nouvelle icône ENABLE_WEBHOOKS variable d’environnement global—Ajout de la variable globale ENABLE_WEBHOOKS à utiliser avec les webhooks Commerce pour se connecter à un point de terminaison externe, tel qu’une action d’exécution App Builder ou un système de gestion d’inventaire tiers.

v2002.1.15

Date de publication : 31 juillet 2023

  • Icône de correctif Codes d’erreur : schéma de code d’erreur mis à jour et générateur de document de code d’erreur.
  • icône de correctif Validator for custom Redis model - Mise à jour du programme de validation pour les modèles d’arrière-plan Redis personnalisés. Voir l’exemple pour la configuration du cache.
  • icône de correctif Validator for RabbitMQ - Ajout de la prise en charge de RabbitMQ 3.11
  • icône de correctif Correction du lien incorrect : correction du lien incorrect vers la documentation d’intégration dans le modèle d’email de bienvenue.

v2002.1.14

Date de publication : 10 mars 2023

  • nouvelle icône PHP : prise en charge de PHP 8.2.
  • nouvelle icône Validators for Services—Mise à jour des validateurs pour Commerce 2.4.6 des services requis : MariaDB 10.6, Redis 7.0, PHP 8.2, OpenSearch 2.x et RabbitMQ 3.9.
  • icône de correctif ece-tools db-dump : correction d’un problème en raison duquel l’opération db-dump s’arrêtait prématurément.

v2002.1.13

Date de publication : 27 octobre 2022

  • nouvelle icône Ajout de la prise en charge des événements d’Adobe I/O pour Adobe Commerce. Les développeurs d’extensions peuvent désormais utiliser la structure Adobe I/O Events pour envoyer des informations d’événement Commerce des instances cloud à leurs applications écrites pour Adobe App Builder. Les événements d’Adobe I/O pour Adobe Commerce sont dans l’aperçu du partenaire.
  • nouvelle icône Validator for OPcache configuration—Ajout d’un programme de validation pour vérifier la configuration OPcache pour les chemins exclus.
  • icône de correction Correction d’un problème lié à la configuration du cache GraphQL. Désormais, les outils de la CEE conservent la valeur GraphQL id_salt dans la configuration cache du fichier app/etc/env.php.

v2002.1.12

Date de publication : 13 septembre 2022

  • nouvelle icône Activezsynchronous_replication—Jeu d’outils CEE synchronous_replication=>true dans le fichier app/etc/env.php lorsque MYSQL_USE_SLAVE_CONNECTION est activé. Cette configuration affecte uniquement Commerce 2.4.6+. Voir la description de la variable MYSQL_USE_SLAVE_CONNECTION dans Déployer des variables.
  • nouvelle icône OpenSearch : ajout d’une fonctionnalité permettant de configurer et de définir le moteur opensearch pour la prochaine version d’Adobe Commerce 2.4.6. Voir Configuration du service OpenSearch.

v2002.1.1

Date de publication : 4 août 2022

  • icône de correction ElasticSuite Validator and OpenSearch—Correction du problème de validation de l’intégrité d’ElasticSuite lors de l’installation d’OpenSearch.
  • Icône de correctif Types de retour pour les commandes de déploiement—Types de retour fixes pour les commandes de déploiement.
  • icône de correction RabbitMQproblème avec la nouvelle installation de Commerce 2.4.5—Correction d’un problème de blocage RabbitMQ sur la nouvelle installation de Commerce 2.4.5.

v2002.1.10

Date de publication : 31 mars 2022

  • icône de correctif Elasticsearch 7.10—Mise à jour des validateurs pour la prise en charge de la version 7.10 d’Elasticsearch.

v2002.1.9

Date de publication : 10 mars 2022

  • nouvelle icône 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.

  • nouvelle icône PHP : prise en charge de PHP 8.1.

  • Icône de correctif symfony/process—Ajout de la compatibilité avec symfony/process ^5.3.

  • nouvelle icône 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.

  • nouvelle icône 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.

  • icône de correctif AWS S3 : modification de la méthode d’activation d’AWS S3.

  • icône de correctif 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.

v2002.1.8

Date de publication : 25 octobre 2021

  • nouvelle icône Emplacement de vidage alternatif : ajout de l’option --dump-directory afin que vous puissiez choisir un répertoire cible pour un vidage DB. Désormais /app/var/dump-main est le répertoire cible par défaut pour un vidage DB. Voir Gestion des sauvegardes : sauvegarder votre base de données
  • Icône de correctif Mise à jour de monolog—Mise à jour de la version minimale requise pour le package monolog vers ^2.3.
  • Icône de correctif Mettre à jour Symfony : mise à jour des dépendances Symfony pour qu’elles soient compatibles avec Adobe Commerce 2.4.4.
  • icône de correctif Fonctionnalité/résolution du chargement automatique : correction d’un problème lors du déploiement dans un environnement d’intégration et de l’affichage de l’erreur CRITICAL: [9] Required configuration is missed in autoload section of composer.json file..

v2002.1.7

Date de publication : 29 juillet 2021

Mises à jour de configuration

  • nouvelle icône Ajout de la prise en charge du compositeur 2.0.

  • icône de correction 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

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

v2002.1.6

Date de publication : 20 avril 2021

  • new icon 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.

  • nouvelle icône 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.

  • nouvelle icône 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.

  • nouvelle icône 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.

  • icône de correctif 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.

  • icône de correction 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.

  • icône de correctif 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.

v2002.1.5

Date de publication : 1 février 2021

  • nouvelle icône 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 icône 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.

  • nouvelle icône 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.

  • nouvelle icône 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 icône 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.

  • icône de correctif 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.

  • icône de correction ​: 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.

  • Icône de correctif Journaux d’erreur vides : correction d’un problème qui provoquait l’échec des déploiements si le cloud.error.log était vide.

  • Icône de correctif Validation MariaDB 10.3—Correction de la validation de MariaDB 10.3 pour Adobe Commerce 2.3.6-p1.

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

v2002.1.4

Date de publication : 19 novembre 2020

  • icône de correction Correction d’un problème qui provoquait l’échec du déploiement lorsque le moteur de recherche spécifié dans la variable d’environnement SEARCH_CONFIGURATION était une valeur autre que elasticsearch.

v2002.1.3

Date de publication : 9 novembre 2020

Mises à jour de l’infrastructure

  • nouvelle icône 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.

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

  • icône de correctif 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.

Améliorations de la validation et du journal

  • nouvelle icône 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.

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

  • nouvelle icône 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.

  • nouvelle icône 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.

  • icône de correction 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.

  • icône de correction 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.

Mises à jour des commandes de l’interface de ligne de commande

Mises à jour des variables d’environnement

  • nouvelle icône Ajout de la variable de build SKIP_COMPOSER_DUMP_AUTOLOAD. La définition de la variable sur true empêche l’application d’exécuter la commande composer dump-autoload lors d’une installation de Cloud Docker for Commerce. La variable ne concerne que les conteneurs Cloud Docker pour Commerce avec des systèmes de fichiers modifiables (créés pour le test et le développement à l’aide de ./vendor/bin/ece-docker build:compose --with-test). Pour de telles installations, ignorer la commande composer dump-autoload empêche les erreurs lors de l'exécution d'autres commandes qui tentent d'accéder aux fichiers à partir d'un répertoire generated supprimé.

v2002.1.2

Date de publication : 5 août 2020

Améliorations de la validation et du journal

  • new icon 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.

  • nouvelle icône 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.

  • nouvelle icône 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 .

  • nouvelle icône 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.

v2002.1.1

Date de publication : 25 juin 2020

  • nouvelle icône Mises à jour de l’infrastructure

    • nouvelle icône 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.

    • new icon 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.

    • icône de correction 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.

    • icône de correctif 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.

    • icône de correction 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.

  • nouvelle icône Mises à jour du service

    • nouvelle icône Ajout de la prise en charge de PHP 7.4 et MariaDB 10.4.
  • nouvelle icône Mises à jour de variable d’environnement

    • nouvelle icône 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.

    • nouvelle icône 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.

  • nouvelle icône Mises à jour de la commande CLI

    • nouvelle icône 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.

  • nouvelle icône Améliorations de la validation

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

    • nouvelle icône {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.

    • icône de correction 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.
      
    • nouvelle icône 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.

    • nouvelle icône 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.
        

v2002.1.0

Date de publication : 6 février 2020

05f2f56e-ac5d-4931-8cdb-764e60e16f26