Configuración del servicio Valkey

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Nube
Caché

Creado para:

Administrador
Desarrollador

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.

Consulte Configurar Valkey en la guía de configuració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 Valkey:

Agregue el nombre y el tipo necesarios al 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`

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

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

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

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

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.

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.

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

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

7c2b03ac-000c-497d-aba3-2c6dc720a938