Documentation Commerce Commerce sur le cloud

Configuration du service Valkey

Dernière mise à jour : 18 juillet 2025

Rubriques :
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

Créé pour :

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

Valkey est une solution de cache d’arrière-plan facultative qui remplace le Zend Framework Zend_Cache_Backend_File utilisé par défaut par Adobe Commerce. Si vous remplacez la valeur par défaut sur les versions de Commerce 2.4.9+ ou les versions de correctif ultérieures aux lignes de version 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 et 2.4.8-p4, vous devez utiliser Valkey.

Voir Configurer Valkey dans le Guide des bonnes pratiques du playbook d’implémentation.

Utilisez les instructions suivantes pour la configuration du service sur les environnements Pro Integration et les environnements de démarrage, y compris la branche master.

NOTE

Envoyez un ticket d’assistance Adobe Commerce pour modifier la configuration du service dans les environnements de production et d’évaluation Pro.

Pour remplacer Redis par Valkey, mettez à jour la configuration dans les trois fichiers suivants :

Remplacez la configuration Redis par le nom et le type Valkey requis dans le fichier .magento/services.yaml.

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

Pour fournir votre propre configuration Valkey, ajoutez une clé core_config dans votre fichier .magento/services.yaml :

code language-yaml
`cache: type: valkey:8.0`

Configurez les relations dans le fichier .magento.app.yaml.

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

Configurez .magento.env.yaml pour remplacer la configuration Redis comme suit :.

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

note tip
TIP
Pour Adobe Commerce version 2.4.9 et ultérieure, vous pouvez utiliser l’implémentation moderne du cache L2 basé sur Symfony Cache au lieu de `RemoteSynchronizedCache` en définissant `VALKEY_BACKEND: symfony_l2`. Voir `VALKEY_BACKEND` dans la référence Déployer les variables.

Ajouter, valider et transmettre vos modifications de code.

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>`

Vérifier les relations de service.

TIP

Après la configuration initiale du service, vous pouvez modifier la version du logiciel d’un service installé en mettant à jour les fichiers de configuration services.yaml et .magento.app.yaml. Consultez Modifier la version du service pour obtenir des conseils sur la mise à niveau ou la rétrogradation d’un service.

NOTE

New Relic peut toujours afficher Redis même après la migration vers Valkey

Il est prévu que New Relic puisse continuer à faire référence au service de cache en tant que Redis même après la migration de l’environnement vers Valkey.

Valkey est une forme open source de Redis, et certains outils et intégrations continuent à identifier le service à l’aide de l’appellation Redis plutôt que d’un libellé Valkey distinct. Cela n’indique pas nécessairement que Redis est toujours installé.

Utilisation de l’interface de ligne de commande Valkey

En supposant que votre relation Valkey soit nommée valkey, vous pouvez y accéder à l’aide de l’outil valkey-cli .

Utilisez SSH pour vous connecter à l’environnement d’intégration avec Valkey installé et configuré.

Ouvrez un tunnel SSH vers un hôte.

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

Obtenir la version de Valkey installée

Utilisez la commande suivante pour installer la version de Valkey dans un environnement d’intégration :

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

Réponse :

valkey_version:8.0.1
gcc_version:12.2.0

Valkey sur l’évaluation et la production Pro

Pour installer la version de Valkey dans un environnement d’évaluation ou de production, utilisez la commande valkey-server :

valkey-server -v

Valkey server v=8.0.1 ...

Utilisez la commande suivante pour installer la configuration Valkey dans un environnement d’évaluation ou de production Pro :

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Réponse :

"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