Notas de la versión de ECE-Tools

OpenSearch: se ha agregado compatibilidad con OpenSearch para las versiones de Adobe Commerce 2.4.4, 2.4.3-p2 y 2.3.7-p3.

PHP—Se agregó compatibilidad con PHP 8.1.

symfony/process—Se ha agregado la compatibilidad con symfony/process ^5.3.

Procesos múltiples de consumidor—Se ha agregado una opción multiple_processes para que pueda especificar el número de procesos que se generarán para cada consumidor. Vea la descripción de la variable CRON_CONSUMERS_RUNNER en Implementar variables.

esquema OpenSearch y ruta de acceso completa al host—Se ha agregado la capacidad de configurar un esquema Elasticsearch y una ruta de acceso completa al host.

AWS S3—Se ha cambiado el método de habilitación de AWS S3.

Corrección de driver_options reader—Se ha agregado la lectura de driver_options para la conexión DB desde el archivo env.php por ece-tools para los validadores.

agregó compatibilidad con Composer 2.0.

Se han actualizado los requisitos del compositor parasymphony/console: se han actualizado los requisitos de versión de ECE-Tools composer.json para el paquete symphony/console a fin de corregir un problema que causaba que los comandos di:compile dieran el siguiente error: Incompatible argument type: Required type: int. Actual type: string

Se han actualizado las comprobaciones del software al final de su vida útil (eol.yaml) para incluir Elasticsearch 7.9.x.

Credenciales de autenticación Redis—Se ha agregado la capacidad de leer las credenciales de autorización de Redis de la propiedad relationships durante la fase de implementación.

Credenciales de autorización de Elasticsearch—Se agregó la capacidad de leer las credenciales de autorización de Elasticsearch de la propiedad relationships durante la fase de implementación.

Servicio de almacenamiento de sesión dedicado—Se agregó redis-session como una segunda opción para el almacenamiento de sesión. Puede usar el servicio redis-session para almacenar información de sesión y usar el servicio redis para la caché con el fin de proporcionar un mejor rendimiento.

Mensajes obsoletos de SPLIT_DB—Se han agregado mensajes críticos y de advertencia de validador para la opción obsoleta SPLIT_DB de Adobe Commerce 2.4.2 y su eliminación en Adobe Commerce 2.5.0.

Versión de Elasticsearch de las relaciones—Validador de servicio fijo para recuperar la versión correcta de Elasticsearch de las propiedades de relationships en los entornos Cloud Docker e integración.

Validación flexible de puertos de Redis—Ahora Redis puede validar el puerto en una conexión de caché personalizada desde la dirección URL server. Por ejemplo, puede agregar el número de puerto a la dirección URL del servidor de la siguiente manera: server: 'tcp://rfs-store-simple-page-cache:26379'. Esto ayuda a evitar errores de validación en los que falta la opción port o es incorrecta.

Actualización a Adobe Commerce 2.4.2—Se ha corregido el problema que requería que los usuarios ejecutaran manualmente bin/magento setup:upgrade para que sus sitios estuvieran operativos después de actualizar a Adobe Commerce 2.4.2.

Almacenamiento remoto—Se ha agregado la variable de entorno REMOTE_STORAGE para habilitar Proyectos en la nube para el almacenamiento remoto de archivos multimedia mediante un servicio de almacenamiento, como AWS S3. Esta opción de configuración forma parte del paquete ECE-Tools, pero no es compatible con Adobe Commerce en la infraestructura en la nube.

Nuevo comando cloud:config:validate—Se agregó el comando php vendor/bin/ece-tools cloud:config:validate para validar la configuración de .magento.env.yaml antes de insertar cambios en el entorno de nube remoto.

Vaciando el opcache—Se agregó compatibilidad con la opción PHP opcache.enable_cli para vaciar el OPcache antes de ejecutar el enlace de implementación. Esta configuración restablece la configuración de la caché para garantizar que se aplican los valores de configuración actuales en cada implementación.

Validación de Aurora DB: se ha actualizado la validación del servicio de base de datos para que sea compatible con la base de datos Aurora.

Nueva variable de entorno SCD_NO_PARENT—Se ha agregado la variable de entorno SCD_NO_PARENT (para Adobe Commerce >=2.4.2) para administrar la generación de contenido estático para las temáticas principales.

Límites y comandos de memoria—Se ha corregido un problema por el que los comandos de php vendor/bin/ece-tools no funcionaban si el tamaño del archivo de cloud.log superaba el límite de memoria PHP. En lugar de leer todo el archivo cloud.log en la memoria, ahora solo se lee un subconjunto más pequeño de datos del archivo de registro.

Conexiones de base de datos personalizadas—Se ha corregido un problema de configuración de .magento.env.yaml en el que no se usaban las conexiones de base de datos personalizadas definidas para DATABASE_CONFIGURATION. No se agregaba la configuración de conexión a app/etc/env.php.

Registros de errores vacíos—Se ha corregido un problema que hacía que las implementaciones fallaran si cloud.error.log estaba vacío.

Validación de MariaDB 10.3—Validación fija de MariaDB 10.3 para Adobe Commerce 2.3.6-p1.

Registro de caché:flush: se mejoraron las entradas de registro para indicar el comienzo y el final del paso cache:flush.

agregó compatibilidad con ECE-Tools para el directorio de solo lectura pub/static cuando el contenido estático está configurado para implementarse en la fase de compilación.

agregó compatibilidad con Elasticsearch 7.9 y Redis 6 por compatibilidad con próximas versiones de Adobe Commerce.

Se ha actualizado ECE-Tools composer.json para agregar una dependencia necesaria para la herramienta Parches de calidad. Esto corrige una dependencia circular que existía entre los paquetes ECE-Tools y magento-cloud-patch.

Se agregó la validación del motor de búsqueda para garantizar que elasticsearch esté configurado para Adobe Commerce en la infraestructura en la nube 2.4 y posterior. Si la validación falla, la implementación se detiene con un mensaje de error crítico que sugiere correcciones para el problema. Ver errores críticos, implementación de fase.

agregó validación de Elasticsearch para comprobar la compatibilidad entre la versión del servicio Elasticsearch y la versión de Adobe Commerce.

Se ha actualizado el mensaje de error de compatibilidad de Elasticsearch para mostrar las versiones de Elasticsearch compatibles con el módulo Elasticsearch de Adobe Commerce. El mensaje de error ahora proporciona las versiones específicas de Elasticsearch que se deben instalar en la infraestructura de Cloud para que sea compatible con el módulo de Elasticsearch que use su versión de Adobe Commerce. Ver errores de advertencia, implementación de fase.

agregó errores de advertencia 2026 y 2027 para la configuración de variable de entorno MAGE_MODE no válida. El único valor válido es production. Antes de esta corrección, MAGE_MODE se podía establecer en developer sin errores de implementación, solo para provocar errores más adelante al intentar escribir en archivos de solo lectura. Ver errores de advertencia.

Se ha corregido la validación de los servicios Redis, RabbitMQ y MySQL para garantizar que estas versiones sean compatibles con la versión de Adobe Commerce. Las versiones válidas de estos servicios ahora se escriben en cloud.log.

Actualizó cloud.log para incluir el límite de solicitudes simultáneas para enviar solicitudes durante el calentamiento de la caché. Este valor está configurado en la variable WARM_UP_CONCURRENCY posterior a la implementación.

agregó el archivo schema.error.yaml que incluye todas las notificaciones de error y advertencia que pueden ocurrir durante el proceso de generación, implementación y posterior a la implementación, además de sugerencias para resolver los errores. La información contenida en este archivo también está disponible en la Guía de Cloud para Commerce. Consulte Referencia de mensaje de error para ece-tools.

cambió las entradas del registro de errores de Cloud (/var/log/cloud.error.log) al formato JSON para que el registro sea más fácil de analizar mediante programación.

agregó comprobaciones de errores adicionales para generar, implementar y posimplementar el procesamiento, y mejoró las comprobaciones existentes:

• Código de error 2026: error al restaurar algunos datos generados durante la fase de compilación en los directorios montados

• Código de error 3004: no se pueden crear archivos de copia de seguridad

• Código de error 102: se agregaron comprobaciones adicionales para detectar problemas que se producen cuando el archivo env.php no se puede escribir en

agregó la variable de entorno QUALITY_PATCHES para especificar uno o más parches de calidad para aplicar durante el proceso de implementación. Ver variables de compilación.

actualizaciones de infraestructura—

• Mejoras en el registro: se ha mejorado la capacidad de seguimiento de registros al asignar códigos de salida a errores de implementación críticos y al exponer los códigos de salida en las notificaciones de mensajes de error y los eventos de registro. Consulte Referencia de mensaje de error para ece-tools.

• mejoró el proceso de volcados de base de datos (vendor/bin/ece-tools db-dump) y actualizó los mensajes de registro para aclarar que la operación de volcado de base de datos cambia la aplicación al modo de mantenimiento, detiene los procesos de cola de consumidores y deshabilita los trabajos cron antes de que comience el volcado.

• Se ha corregido un problema para garantizar que la dirección URL del proyecto se actualice correctamente al implementarla en los entornos de ensayo y producción. Ahora, ece-tools usa la dirección URL de la ruta con el atributo primary:true establecido en la configuración de ruta del proyecto. Ver Implementar variables.

• Actualizó el flujo de trabajo del escenario de compilación generate.xml para aplicar parches. Los parches se deben aplicar antes para actualizar Adobe Commerce y solucionar los problemas que puedan provocar errores en los pasos de di:compile y module:refresh.

• Se ha corregido un problema en el proceso de instalación que devolvía incorrectamente el error Crypt key missing. El valor crypt/key se genera automáticamente durante la instalación.

Actualizaciones de servicio—

• agregó compatibilidad con PHP 7.4 y MariaDB 10.4.

Actualizaciones de variables de entorno—

• agregó la variable SCD_USE_BALER para habilitar el módulo Baler para el agrupamiento de JavaScript durante el proceso de compilación de Adobe Commerce en la nube. Ver la descripción de la variable en variables de compilación.

• agregó la variable de entorno REDIS_BACKEND para configurar el modelo de back-end Redis para la caché Redis para Adobe Commerce 2.3.5 o posterior. Consulte la descripción de la variable en implementar variables.

actualizaciones de comandos CLI—

• Se han actualizado los siguientes comandos de CLI con una opción para un registro más detallado:

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

  El nivel de registro de cada llamada está determinado por la configuración de la variable VERBOSE_COMMANDS en el archivo .magento.env.yaml.

Mejoras de validación—

• comprobaciones de compatibilidad de Elasticsearch 7.x: se ha actualizado la validación de Elasticsearch para las comprobaciones de compatibilidad del software Elasticsearch 7.x.

• Comprobaciones de validación de EOL y versión de servicio actualizada: validación actualizada para comprobar las versiones de servicio instaladas con Adobe Commerce 2.4. requisitos.

• Se ha corregido un problema de validación para que el siguiente mensaje de advertencia posterior a la implementación se muestre únicamente si falta la configuración del vínculo post-deploy en el archivo .magento.app.yaml:

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

• Validación agregada para las dependencias de Zend Framework—Validación de dependencia del compositor agregada para Zend Framework que ha migrado al proyecto Laminas. Si faltan las dependencias necesarias, aparece el siguiente mensaje de error durante el proceso de generación.

  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.

  Ver Verificar dependencias de Zend Framework.

• Validación agregada para env.php archivo y datos—Comprobaciones agregadas para el archivo y los datos env.php durante el proceso de instalación y actualización.

  • Si falta el archivo env.php en la instalación y el valor crypt/key no se especifica en el archivo .magento.app.yaml, la implementación falla con la siguiente notificación:

    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 la instalación no incluye el archivo env.php, o si la configuración contiene sólo un tipo de caché, el comando cron:enable se ejecuta durante el proceso de actualización para restaurar el archivo con todos los cache_types. Se agrega la siguiente notificación al registro:

    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.

actualizaciones de infraestructura—

• Se agregó un paquete independiente para Cloud Docker para Commerce—Se desacopló el paquete Docker del paquete ece-tools para mantener la calidad del código y proporcionar versiones independientes. Las actualizaciones y correcciones relacionadas con ece-tools se administran desde el repositorio de magento-cloud-docker de GitHub.

• Funciones de parches actualizadas—Se ha movido la funcionalidad de parches del paquete ECE-Tools a un paquete magento-cloud-patch independiente. Durante la implementación, ece-tools usa el nuevo paquete para aplicar parches. Ver Notas de la versión de parches de nube.

• Dependencias actualizadas del compositor—Se ha actualizado el archivo composer.json para Adobe Commerce en la infraestructura en la nube con una dependencia para el paquete magento/magento-cloud-docker. Ahora, ece-tools incluye dependencias para todos los paquetes en Cloud Tools Suite for Commerce. Estos paquetes se instalan y actualizan automáticamente al instalar o actualizar ece-tools.

Compatibilidad con implementaciones basadas en escenarios—

• Ahora puede personalizar los procesos de generación, implementación y posterior implementación mediante archivos de configuración XML para anular o personalizar la configuración predeterminada.

• Se ha cambiado la configuración de hooks en.magento.app.yaml. Hemos actualizado el formato de configuración de hooks para admitir implementaciones basadas en escenarios. El formato heredado de versiones anteriores de ECE-Tools 2002.0.x todavía es compatible. Sin embargo, debe actualizar al nuevo formato para utilizar la función de implementación basada en escenarios. Consulte Implementaciones basadas en escenarios.

Actualizaciones de servicio—

• agregó compatibilidad con PHP 7.3.

• agregó compatibilidad con RabbitMQ 3.8.

• Se agregó la validación para comprobar las versiones del servicio instalado respecto a la fecha límite para cada servicio. Ahora, los clientes recibirán una notificación si la versión de un servicio se encuentra dentro de los tres meses posteriores a la fecha límite y una advertencia si la fecha límite se encuentra en el pasado.

• Se ha corregido un problema de configuración de Elasticsearch para garantizar que la configuración correcta de Elasticsearch esté establecida en todos los entornos.

Actualizaciones de variables de entorno—

• ha ampliado la funcionalidad de la variable de entorno WARM_UP_PAGES para admitir la precarga de caché en páginas de producto específicas. Vea la definición expandida en el tema variables posteriores a la implementación.

• agregó la variable de entorno ERROR_REPORT_DIR_NESTING_LEVEL para simplificar la administración de datos del informe de errores en el directorio <magento_root>/var/report/. Consulte la descripción de la variable en el tema variables de compilación.

• eliminó las variables de entorno SCD_EXCLUDE_THEMES, STATIC_CONTENT_THREADS, DO_DEPLOY_STATIC_CONTENT y STATIC_CONTENT_SYMLINK. Ver cambios incompatibles con versiones anteriores.

• Se ha corregido un problema en el proceso de configuración de Elastic Suite para que la configuración predeterminada se sobrescriba como se esperaba al configurar la variable de implementación ELASTICSUITE_CONFIGURATION sin la opción _merge.

actualizaciones de comandos CLI—

• Nuevo comando cron: ahora puede administrar manualmente el procesamiento cron en su entorno de Adobe Commerce en la nube mediante los comandos cron:disable y cron:enable. Utilice el comando disable para todos los procesos cron activos y deshabilitar todos los trabajos cron. Utilice el comando enable para volver a habilitar los trabajos cron cuando esté listo. Consulte Deshabilitar trabajos cron.

• Informes de errores mejorados—Se ha agregado un mejor registro para los errores de comandos de CLI que se producen durante el procesamiento de ECE-Tools.

• Quitar comandos de compilación obsoletos— Se eliminaron los siguientes comandos de compilación: m2-ece-build, m2-ece-deploy, m2-ece-scd-dump y se cambió el nombre de ece-tools docker comandos a ece-docker. Ver cambios incompatibles con versiones anteriores

eliminó el archivo build_options.ini obsoleto y agregó validación para fallar en la compilación si el archivo existe. Utilice el archivo .magento.env.yaml para configurar las opciones de generación.

Se ha corregido un problema que ocasionaba que fallara el proceso de compilación cuando el archivo config.php estaba vacío.