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 de 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 de software al final de su vida útil (eol.yaml) para incluir el 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 Cloud Docker y entornos de 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.

Caché:registro de vaciado—Entradas de registro mejoradas para indicar el comienzo y el fin 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 de Elasticsearch y la versión de Adobe Commerce.

Se ha actualizado el mensaje de error de compatibilidad del Elasticsearch para mostrar las versiones de Elasticsearch compatibles con el módulo de Elasticsearch de Adobe Commerce. El mensaje de error ahora proporciona las versiones específicas del Elasticsearch que se van a instalar en la infraestructura de Cloud para que sea compatible con el módulo del Elasticsearch utilizado por la 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_PATCH para especificar uno o más parches de calidad que se aplicarán 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 del Elasticsearch 7.x: validación actualizada del Elasticsearch para las comprobaciones de compatibilidad del software del 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 los requisitos de Adobe Commerce 2.4.

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