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.
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 :
- Nouvelles fonctionnalités
- Correctifs et améliorations
v2002.2.0 latest
Date de publication : 7 octobre 2024
- MariaDB 11.4 - Prise en charge supplémentaire de MariaDB 11.4.
- 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.
- Mise à niveau de la version de Monolog - Ajout de la prise en charge de monolog 3.6.
- 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
- Lua : ajout de l’option useLua pour CACHE_CONFIGURATION.
- Validator—Mise à jour des validateurs pour les nouvelles versions de Redis et RabbitMQ.
v2002.1.18
Date de publication : 8 avril 2024
- PHP — Prise en charge de PHP 8.3.
- Validator - Validator EOL mise à jour
v2002.1.17
Date de publication : 16 janvier 2024
- Validator for Elasticsearch & OpenSearch—Correction du programme de validation qui produisait un message trompeur pour installer un service de recherche lorsque LiveSearch est activé.
- 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
- 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
- Codes d’erreur : schéma de code d’erreur mis à jour et générateur de document de code d’erreur.
- 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.
- Validator for RabbitMQ - Ajout de la prise en charge de RabbitMQ 3.11
- 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
- PHP : prise en charge de PHP 8.2.
- 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.
-
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
- 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.
- Validator for OPcache configuration—Ajout d’un programme de validation pour vérifier la configuration OPcache pour les chemins exclus.
-
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 configurationcache
du fichierapp/etc/env.php
.
v2002.1.12
Date de publication : 13 septembre 2022
-
Activez
synchronous_replication
—Jeu d’outils CEEsynchronous_replication=>true
dans le fichierapp/etc/env.php
lorsqueMYSQL_USE_SLAVE_CONNECTION
est activé. Cette configuration affecte uniquement Commerce 2.4.6+. Voir la description de la variableMYSQL_USE_SLAVE_CONNECTION
dans Déployer des variables. -
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
- ElasticSuite Validator and OpenSearch—Correction du problème de validation de l’intégrité d’ElasticSuite lors de l’installation d’OpenSearch.
- Types de retour pour les commandes de déploiement—Types de retour fixes pour les commandes de déploiement.
- 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
- 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
-
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 variableCRON_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
parece-tools
pour les validateurs.
v2002.1.8
Date de publication : 25 octobre 2021
-
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 -
Mise à jour de monolog—Mise à jour de la version minimale requise pour le package
monolog
vers^2.3
. - Mettre à jour Symfony : mise à jour des dépendances Symfony pour qu’elles soient compatibles avec Adobe Commerce 2.4.4.
-
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—
-
Ajout de la prise en charge du compositeur 2.0.
-
Mise à jour des exigences du compositeur pour
symphony/console
—Mise à jour des exigences de versioncomposer.json
de la version CEE-Outils pour le packagesymphony/console
afin de résoudre un problème qui entraînait l’échec des commandesdi: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.
v2002.1.6
Date de publication : 20 avril 2021
-
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 serviceredis-session
pour stocker des informations de session et utiliser le serviceredis
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'optionport
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.
v2002.1.5
Date de publication : 1 février 2021
-
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 commandephp 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 fichiercloud.log
dépassait la limite de mémoire PHP. Au lieu de lire l'intégralité du fichiercloud.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 pourDATABASE_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
.
v2002.1.4
Date de publication : 19 novembre 2020
-
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 queelasticsearch
.
v2002.1.3
Date de publication : 9 novembre 2020
Mises à jour de l’infrastructure—
-
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.
Améliorations de la validation et du journal—
-
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
et2027
pour le paramètre de variable d’environnementMAGE_MODE
non valide. La seule valeur valide estproduction
. Avant ce correctif,MAGE_MODE
pouvait être défini surdeveloper
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.
Mises à jour des commandes de l’interface de ligne de commande—
-
Ajout de commandes d’interface de ligne de commande (
cloud:config:create
etcloud:config:update
) pour créer et mettre à jour le fichier.magento.env.yaml
avec une configuration pouvant inclure une ou plusieurs variables de création, de déploiement et de post-déploiement. Voir Création d’un fichier de configuration à partir de l’interface en ligne de commande.
Mises à jour des variables d’environnement—
-
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 commandecomposer 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 commandecomposer 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épertoiregenerated
supprimé.
v2002.1.2
Date de publication : 5 août 2020
Améliorations de la validation et du journal—
-
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.
v2002.1.1
Date de publication : 25 juin 2020
-
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’attributprimary: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 étapesdi:compile
etmodule:refresh
. -
Correction d’un problème dans le processus d’installation qui renvoie incorrectement l’erreur
Crypt key missing
. La valeurcrypt/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.
-
Ajout de la validation du fichier
env.php
et des données—Ajout de vérifications pour le fichierenv.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 valeurcrypt/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 commandecron:enable
s'exécute pendant le processus de mise à niveau pour restaurer le fichier avec tous lescache_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