DocumentaciónKCS de Experience Cloud

Error de implementación debido a una configuración incorrecta del puerto Valkey en Adobe Commerce

Última actualización: 31 de julio de 2026

Se produce un error de implementación en Adobe Commerce en la infraestructura de la nube cuando la configuración de caché de Valkey Stale usa un puerto incorrecto en el archivo .magento.env.yaml. Para resolver el problema, actualice los puertos de Valkey y vuelva a implementarlos correctamente.

Descripción description

Entorno

  • Producto: Adobe Commerce en infraestructura en la nube
  • Versión: 2.4.8
  • Entorno de implementación: Integración

Problema/Síntomas

  • La implementación falla al aplicar la configuración de caché obsoleta en .magento.env.yaml.
  • Los registros de implementación muestran el siguiente error: Texto sin formato1Conexión a Redis standalone tcp://localhost:6370 tras 1 errores. Último error : (111) Conexión rechazada.
  • Adobe Commerce no se puede conectar al servidor de caché de Valkey configurado.
  • La configuración de conexión de Valkey hace referencia a un puerto incorrecto en la configuración.
  • La validación de la implementación falla durante la configuración del back-end de caché.

Resolución resolution

Siga los pasos a continuación para resolver el problema:

  1. Antes de insertar la configuración de caché obsoleta en .magento.env.yaml, ejecute el siguiente comando para obtener los detalles de la relación de Valkey:

    code language-none 
    magento-cloud relationships
...
       port: <port_number>

  2. Tenga en cuenta el valor de puerto devuelto para el servicio Valkey existente.

  3. Busque todas las referencias al puerto Valkey en el archivo .magento.env.yaml y actualice cada ocurrencia del puerto 6370 al valor de puerto correcto identificado en el paso anterior.

  4. Revise la sección backend_options y actualice cualquier referencia al puerto 26370 al puerto de Valkey correcto, si existe.

  5. Guarde el archivo .magento.env.yaml actualizado y confirme los cambios.

  6. Vuelva a implementar la aplicación de Adobe Commerce con la configuración corregida.

  7. Compruebe que la implementación se completa correctamente y confirme que no aparecen errores de conexión de Valkey en los registros de implementación.

Nota: Compruebe que todos los archivos de configuración que hacen referencia a Valkey, incluidos .magento.app.yaml y services.yaml, usan la misma configuración de puerto.

Lectura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles