Configuración del servicio Valkey

Valkey es una solución de caché backend opcional para Adobe Commerce en la infraestructura en la nube. Valkey es necesario cuando se anula la configuración de caché predeterminada en Adobe Commerce 2.4.9 y versiones posteriores, o en versiones de parches posteriores a 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 y 2.4.8-p4.

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

Configuración de Valkey

Para reemplazar Redis por Valkey, actualice los siguientes archivos:

Configuración del servicio

En .magento/services.yaml, reemplace la definición del servicio Redis por una definición del servicio Valkey. Reemplace <version> con una versión de Valkey compatible con su versión de Adobe Commerce y la plantilla de nube actual.

cache:
  type: valkey:<version>

Ejemplo

cache:
  type: valkey:8.0

La versión de ejemplo no es universal. Las versiones reales del servicio predeterminado y admitido dependen de la versión de Adobe Commerce y de la plantilla de nube actual. Utilice la versión especificada por la plantilla de proyecto actual. Consulte Configurar servicios para obtener más información.

No dé por hecho que los datos de caché y de sesión persisten al cambiar el valor de type de redis:<version> a valkey:<version>, aunque mantenga el mismo Id. de servicio. Considere la migración como la creación de una nueva caché: no se garantiza que se conserven la caché existente y los datos de sesión, y se cierra la sesión de los usuarios una vez finalizada la migración.

Configuración de la relación de servicio

En .magento.app.yaml, configure la relación entre la aplicación y el servicio Valkey:

relationships:
  valkey: "cache:valkey"

La clave de relación valkey es el nombre que usa la aplicación para obtener acceso al servicio. El valor cache:valkey hace referencia al identificador y tipo de servicio definidos en .magento/services.yaml.

runtime:
      extensions:
          - redis

Confirmar e implementar los cambios

Añada, confirme e inserte los cambios de configuración:

git add .magento/services.yaml .magento.app.yaml
git commit -m "Enable Valkey service"
git push origin <branch-name>

Una vez finalizada la implementación, compruebe que la relación de servicio de Valkey esté disponible.

Personalización de la configuración de Valkey

Para las recomendaciones de caché, sesión, L2 y conexión de réplica, consulte Prácticas recomendadas para la configuración de los servicios Valkey y Redis en la Guía de prácticas recomendadas de implementación del libro de estrategias.

Verificar la relación de servicio

Para mostrar el objeto MAGENTO_CLOUD_RELATIONSHIPS descodificado, ejecute el siguiente comando desde un contenedor de aplicaciones después de implementar la configuración:

Utilice SSH para conectarse al entorno remoto de la nube y, a continuación, ejecute:

echo "$MAGENTO_CLOUD_RELATIONSHIPS" | base64 -d | json_pp

El comando muestra todas las relaciones de servicio configuradas. Para identificar los detalles de conexión de Valkey, busque la relación de Valkey.

Ejemplo de salida

En el siguiente ejemplo abreviado se muestra la relación valkey. No es un esquema universal.

{
   "database" : [
      {
         "host" : "database.internal",
         "port" : 3306,
         "path" : "main",
         "scheme" : "mysql"
      }
   ],
   "opensearch" : [
      {
         "host" : "opensearch.internal",
         "port" : 9200,
         "path" : null,
         "scheme" : "http"
      }
   ],
   "valkey" : [
      {
         "host" : "valkey.internal",
         "port" : 6379,
         "path" : null,
         "scheme" : "valkey"
      }
   ]
}

La salida varía según el entorno y la configuración del servicio. No codifique nombres de host, puertos, direcciones IP, nombres de clúster, versiones de servicio, nombres de usuario o contraseñas desde este ejemplo. Use los valores devueltos por MAGENTO_CLOUD_RELATIONSHIPS en el entorno de destino.

Si jq está disponible, mostrar solo la relación de Valkey:

printf '%s' "$MAGENTO_CLOUD_RELATIONSHIPS" \
  | base64 -d \
  | jq '{valkey: .valkey}'

Para obtener más información acerca de las relaciones de servicio, vea Configurar servicios.

Uso de la CLI de Valkey

Si su relación de Valkey se llama valkey, use el host y el puerto que MAGENTO_CLOUD_RELATIONSHIPS devolvió para conectarse a Valkey:

valkey-cli -h <host> -p <port>

Ejemplo

valkey-cli -h valkey.internal -p 6379

Obtener la versión de Valkey instalada

valkey-cli -h <host> -p <port> info | grep version

valkey_version:<installed-version>
gcc_version:<gcc-version>

valkey-server -v

Valkey server v=<installed-version> ...

Solución de problemas Valkey

Los errores de limpieza de caché hacen referencia a Redis en una caché configurada con Valkey

Un error de limpieza de caché previa a la implementación puede mostrar el código de error [107] (clean-redis-cache) y un mensaje Connection to Redis incluso cuando el servicio cache está configurado como Valkey. ece-tools utiliza este código y mensaje de error para el paso de limpieza de caché, independientemente de si el servicio de caché de copia de seguridad es Redis o Valkey.

Si el error subyacente es un error de DNS, como Name or service not known para el host de relación, el paso de implementación se ejecutó antes de que la relación de servicio estuviera disponible o el nombre de relación de .magento.app.yaml no coincide con el ID de servicio de .magento/services.yaml. Consulte Verificar la relación de servicio.