Configuration du service Valkey

Last update: Fri Jul 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Cloud
Cache

Créé pour :

Administration
Développeur

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.

Voir Configurer Valkey dans le Guide de configuration.

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 :

Ajoutez le nom et le type requis au 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 comme suit :.

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

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.

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

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