DocumentaciónCommerceGuía de Commerce en la nube

Configuración del servicio Valkey

Última actualización: 18 de julio de 2025

Creado para:

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

Valkey 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. Si reemplaza el valor predeterminado en las versiones de Commerce 2.4.9+ o versiones de parches posteriores a las líneas de versión 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 y 2.4.8-p5, debe utilizar Valkey.

Consulte Configurar Valkey en la Guía de prácticas recomendadas de implementación del manual.

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 reemplazar Redis por Valkey, actualice la configuración en los tres archivos siguientes:

  1. Reemplace la configuración de Redis con el nombre de Valkey necesario y escriba en el archivo .magento/services.yaml.

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

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

    code language-yaml 
    cache:
    type: valkey:8.0

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

    code language-yaml 
    relationships:
    valkey: "cache:valkey"

  3. Configure .magento.env.yaml para reemplazar la configuración de Redis de la siguiente manera:.

    code language-yaml 
     stage:
     deploy:
     VALKEY_USE_SLAVE_CONNECTION: true
     VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

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

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

  5. 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.
NOTE
New Relic puede mostrar Redis incluso después de la migración a Valkey
Se espera que New Relic continúe refiriéndose al servicio de caché como Redis incluso después de que el entorno se haya migrado a Valkey.
Valkey es una ramificación de código abierto de Redis, y algunas herramientas e integraciones siguen identificando el servicio mediante el uso de nombres de Redis en lugar de una etiqueta de Valkey distinta. Esto no indica necesariamente que Redis siga instalado.

Uso de la CLI de Valkey

Suponiendo que su relación de Valkey se llame valkey, puede acceder a ella con la herramienta valkey-cli.

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

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

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

Obtener la versión instalada de Valkey

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

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

Respuesta:

valkey_version:8.0.1
gcc_version:12.2.0

Valkey en Pro ensayo y producción

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

valkey-server -v

Valkey server v=8.0.1 ...

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

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Respuesta:

"valkey" : [
    {
        "cluster" : "project-master-abc0003",
        "epoch" : 0,
        "fragment" : null,
        "host" : "valkeycache.internal",
        "host_mapped" : false,
        "hostname" : "oblahblahblahblahe.cache.service._.magentosite.cloud",
        "instance_ips" : [
        "123.456.789.012"
        ],
        "ip" : "123.456.789.012",
        "password" : null,
        "path" : null,
        "port" : 6379,
        "public" : false,
        "query" : {},
        "rel" : "valkey",
        "scheme" : "valkey",
        "service" : "cache",
        "type" : "valkey:8.0",
        "username" : null
    }
]
recommendation-more-help
commerce-on-cloud-help-cloud-guide