[Solo PaaS]{class="badge informative" title="Se aplica solo a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe) y a proyectos locales."}

Prácticas recomendadas para la configuración del servicio Valkey

Adobe recomienda las siguientes prácticas recomendadas al configurar el servicio Valkey:

Configuración de la caché de Valkey L2

Configure la caché de Valkey L2 estableciendo la variable de implementación VALKEY_BACKEND en el archivo de configuración .magento.env.yaml.

stage:
  deploy:
    VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

Para obtener información sobre la configuración del entorno en la infraestructura en la nube, consulte VALKEY_BACKEND en la Guía de Commerce en la infraestructura en la nube.

Para instalaciones locales, consulte Configurar el almacenamiento en caché de la página Valkey en la Guía de configuración.

Tamaño de la memoria caché L2 (Adobe Commerce Cloud)

La caché L2 usa un sistema de archivos temporal como mecanismo de almacenamiento. En comparación con los sistemas de base de datos de clave-valor especializados, un sistema de archivos temporal no tiene una política de expulsión de claves para controlar el uso de la memoria.

La falta de control de uso de memoria puede hacer que el uso de memoria caché L2 crezca con el tiempo al acumular la caché antigua.

Para evitar el agotamiento de la memoria de las implementaciones de caché L2, Adobe Commerce borra el almacenamiento cuando se alcanza un determinado umbral. El valor de umbral predeterminado es 95 %.

Es importante ajustar el uso máximo de memoria caché L2 en función de los requisitos del proyecto para el almacenamiento en caché. Utilice uno de los siguientes métodos para configurar el tamaño de la caché de memoria:

El siguiente ejemplo muestra un(a) CACHE_CONFIGURATION en el archivo .magento.env.yaml:

stage:
  deploy:
    VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            cleanup_percentage: 90

Los requisitos de caché pueden variar en función de la configuración del proyecto y el código de terceros personalizado. El ámbito del tamaño de la memoria caché L2 permite que la caché L2 funcione sin visitas de umbral innecesarias.
Lo ideal es que el uso de memoria caché L2 se estabilice en un determinado nivel por debajo del umbral para evitar la limpieza frecuente del almacenamiento.

Puede comprobar el uso de la memoria de almacenamiento en caché L2 en cada nodo del clúster mediante el siguiente comando CLI y, a continuación, buscar la línea /dev/shm.
El uso puede variar entre distintos nodos, pero debe converger al mismo valor.

df -h

Habilitar la conexión esclava de Valkey

Habilite una conexión esclava de Valkey en el archivo de configuración .magento.env.yaml para permitir que solo un nodo gestione el tráfico de lectura-escritura mientras que los demás nodos gestionan el tráfico de solo lectura.

stage:
  deploy:
    VALKEY_USE_SLAVE_CONNECTION: true

Para obtener más información, consulte VALKEY_USE_SLAVE_CONNECTION en la Guía de infraestructura de Commerce en la nube.

Para las instalaciones locales de Adobe Commerce, configure la nueva implementación de caché de Valkey con los comandos bin/magento:setup. Para obtener más información, consulte Usar Valkey para la caché predeterminada en la Guía de configuración.

Claves de precarga

Para reutilizar datos entre páginas, enumere las claves para la carga previa en el archivo de configuración .magento.env.yaml.

stage:
  deploy:
    VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          id_prefix: '061_'                       # Prefix for keys to be preloaded
          backend_options:
            preload_keys:                         # List the keys to be preloaded
              - '061_EAV_ENTITY_TYPES:hash'
              - '061_GLOBAL_PLUGIN_LIST:hash'
              - '061_DB_IS_UP_TO_DATE:hash'
              - '061_SYSTEM_DEFAULT:hash'

Para instalaciones locales, consulte Función de precarga de Valkey en la Guía de configuración.

Habilitar caché obsoleta

Reduzca los tiempos de espera de bloqueo y mejore el rendimiento, especialmente cuando se trata de numerosos bloques y claves de caché, mediante el uso de una caché obsoleta y la generación de una nueva caché en paralelo. Habilite la caché obsoleta y defina los tipos de caché en el archivo de configuración .magento.env.yaml:

stage:
  deploy:
    VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      default:
        backend_options:
          use_stale_cache: false
      stale_cache_enabled:
        backend_options:
          use_stale_cache: true
      type:
        default:
          frontend: "default"
        layout:
          frontend: "stale_cache_enabled"
        block_html:
          frontend: "stale_cache_enabled"
        reflection:
          frontend: "stale_cache_enabled"
        config_integration:
          frontend: "stale_cache_enabled"
        config_integration_api:
          frontend: "stale_cache_enabled"
        full_page:
          frontend: "stale_cache_enabled"
        translate:
          frontend: "stale_cache_enabled"

Para configurar instalaciones locales, consulte Opciones de caché antiguas en la Guía de configuración.

Durante la implementación, debería ver las líneas siguientes en el registro de compilación e implementación:

W:   - Downloading colinmollenhour/credis (1.11.1)
W:   - Downloading colinmollenhour/php-redis-session-abstract (v1.4.5)
...
W:   - Installing colinmollenhour/credis (1.11.1): Extracting archive
W:   - Installing colinmollenhour/php-redis-session-abstract (v1.4.5): Extracting archive
...
[2022-08-17 01:13:40] INFO: Version of service 'valkey' is 8.0
[2022-08-17 01:13:40] INFO: Version of service 'valkey-session' is 8.0
[2022-08-17 01:13:40] INFO: valkey-session will be used for the session if it was not overridden by SESSION_CONFIGURATION.

Compresión de caché

Si usa más de 6 GB de Valkey maxmemory, puede utilizar la compresión de caché para reducir el espacio consumido por las claves. Tenga en cuenta que existe un equilibrio entre el rendimiento del lado del cliente y el de Si tiene CPU de reserva, Adobe recomienda habilitarlas. Consulte Usar Valkey para el almacenamiento de sesión en la Guía de configuración.

stage:
  deploy:
    VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true;
      frontend:
        default:
          backend_options:
            compress_data: 4              # 0-9
            compress_tags: 4              # 0-9
            compress_threshold: 20480     # do not compress files smaller than this value
            compression_lib: 'gzip'       # snappy and lzf for performance, gzip for high compression (~70%)