DocumentaciónCommerceGuía de Commerce en la nube

Configurar el servicio Redis

Última actualización: 5 de mayo de 2025

Creado para:

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Redis es una solución de caché back-end opcional que reemplaza a Zend Framework Zend_Cache_Backend_File, que Adobe Commerce usa de forma predeterminada.

IMPORTANT
La caché de Redis no es compatible con Adobe Commerce 2.4.9 o con versiones de parches posteriores a las 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 y 2.4.8-p5. Utilice Valkey para la configuración de caché donde no se admita Redis. Consulte Requisitos del sistema para ver los servicios de caché admitidos por versión.

Siga estas instrucciones para la configuración del servicio en entornos de integración profesional y entornos de inicio, incluida la rama master.

NOTE
Envíe un ticket de soporte de Adobe Commerce para cambiar la configuración del servicio en los entornos de ensayo y producción de Pro.

Para habilitar Redis:

  1. Agregue el nombre y el tipo necesarios al archivo .magento/services.yaml.

    code language-yaml 
    myredis:
    type: redis:<version>

    Para proporcionar su propia configuración de Redis, agregue una clave core_config a su archivo .magento/services.yaml:

    code language-yaml 
    cache:
    type: redis:<version>

  2. Configure las relaciones en el archivo .magento.app.yaml.

    code language-yaml 
    runtime:
    extensions:
        - redis

relationships:
    redis: "redis:redis"

  3. Agregue, confirme e inserte los cambios de código.

    code language-bash 
    git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable redis service" && git push origin <branch-name>

  4. Compruebe las relaciones de servicio.

TIP
Después de la instalación inicial del servicio, puede cambiar la versión del software de un servicio instalado actualizando los archivos de configuración services.yaml y .magento.app.yaml. Consulte Cambiar la versión del servicio para obtener instrucciones sobre cómo actualizar o degradar un servicio.

Personalizar la configuración de Redis

Para obtener más información sobre cómo personalizar la configuración de Redis, consulte Configurar Redis en la Guía de prácticas recomendadas de implementación del manual.

Uso de la CLI de Redis

Suponiendo que su relación de Redis se llame redis, puede obtener acceso a ella con la herramienta redis-cli.

  1. Utilice SSH para conectarse al entorno de integración con Redis instalado y configurado.

  2. Abra un túnel SSH a un host.

    code language-bash 
    redis-cli -h redis.internal

Obtener la versión de Redis instalada

Utilice el siguiente comando para obtener la versión de Redis instalada en un entorno de integración:

redis-cli -h redis.internal info | grep version

Respuesta de ejemplo:

redis_version:7.0.5
gcc_version:8.3.0

Redis en ensayo y producción Pro

Para obtener la versión de Redis instalada en un entorno de ensayo o producción, use el comando redis-server:

redis-server -v

Redis server v=7.0.5 ...

Utilice el siguiente comando para instalar la configuración de Redis en un entorno de ensayo o producción de Pro:

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Respuesta de ejemplo:

"redis" : [
    {
        "cluster" : "project-master-123abc4",
        "fragment" : null,
        "host" : "redis.internal",
        "host_mapped" : false,
        "hostname" : "oblahblahblahblahe.redis.service._.magentosite.cloud",
        "ip" : "169.254.10.10",
        "password" : null,
        "path" : null,
        "port" : 6379,
        "public" : false,
        "query" : {},
        "rel" : "redis",
        "scheme" : "redis",
        "service" : "redis",
        "type" : "redis:7.0.5",
        "username" : null
    }
]

Solución de problemas de Redis

Consulte los siguientes artículos de soporte de Adobe Commerce para obtener ayuda sobre la resolución de problemas de Redis:

recommendation-more-help
commerce-on-cloud-help-cloud-guide