Documentation Commerce Guide de Commerce sur le cloud

Configuration du service Redis

Dernière mise à jour : 5 mai 2025

Rubriques :
Cloud
Cache

Créé pour :

Administration
Développeur

Redis est une solution de cache back-end facultative qui remplace Zend_Cache_Backend_File de la structure Zend, utilisée par défaut par Adobe Commerce.

Voir Configuration de Redis 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 activer Redis :

Ajoutez le nom et le type requis au fichier .magento/services.yaml.
myredis: type: redis:<version>
Pour fournir votre propre configuration Redis, ajoutez une clé core_config dans votre fichier .magento/services.yaml :
cache: type: redis:<version>

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

runtime:
    extensions:
        - redis

relationships:
    redis: "redis:redis"

Ajouter, valider et transmettre vos modifications de code.

git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable redis 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 Redis

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

Utilisez SSH pour vous connecter à l’environnement d’intégration avec Redis installé et configuré.
Ouvrez un tunnel SSH vers un hôte.
redis-cli -h redis.internal

Obtenir la version Redis installée

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

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

Exemple de réponse :

redis_version:7.0.5
gcc_version:8.3.0

Redis on Pro évaluation et production

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

redis-server -v

Redis server v=7.0.5 ...

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

echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

Exemple de réponse :

"redis" : [
    {
        "cluster" : "project-master-123abc4",
        "fragment" : null,
        "host" : "redis.internal",
        "host_mapped" : false,
        "hostname" : "oblahblahblahblahe.redis.service._.magentosite.cloud",
        "ip" : "169.254.10.10",
        "password" : null,
        "path" : null,
        "port" : 6379,
        "public" : false,
        "query" : {},
        "rel" : "redis",
        "scheme" : "redis",
        "service" : "redis",
        "type" : "redis:7.0.5",
        "username" : null
    }
]

Résolution des problèmes liés à Redis

Consultez les articles d’assistance Adobe Commerce suivants pour obtenir de l’aide sur la résolution des problèmes Redis :

recommendation-more-help