DocumentationExperience Cloud KCS

Échec du déploiement en raison d’une configuration de port Valkey incorrecte dans Adobe Commerce

Dernière mise à jour : 31 juillet 2026

Un échec de déploiement se produit dans Adobe Commerce sur l’infrastructure cloud lorsque la configuration de cache obsolète Valkey utilise un port incorrect dans le fichier .magento.env.yaml. Pour résoudre le problème, mettez à jour les ports Valkey et redéployez-les.

Description description

Environnement

  • Produit : Adobe Commerce sur les infrastructures cloud
  • Version : 2.4.8
  • Environnement de déploiement : Intégration

Problème/Symptômes

  • Le déploiement échoue lors de l’application de la configuration de cache obsolète dans .magento.env.yaml.
  • Les journaux de déploiement affichent l’erreur suivante : Texte brut1La connexion à l’instance autonome Redis tcp://localhost:6370 a échoué après 1 échec. Dernière erreur : (111) connexion refusée.
  • Adobe Commerce ne parvient pas à se connecter au serveur principal du cache Valkey configuré.
  • Les paramètres de connexion Valkey font référence à un port incorrect dans la configuration.
  • La validation du déploiement échoue lors de la configuration du serveur principal du cache.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Avant de pousser la configuration de cache obsolète dans .magento.env.yaml, exécutez la commande suivante pour obtenir les détails de la relation Valkey :

    code language-none 
    magento-cloud relationships
...
       port: <port_number>

  2. Notez la valeur de port renvoyée pour le service Valkey existant.

  3. Recherchez toutes les références au port Valkey dans le fichier .magento.env.yaml et mettez à jour chaque occurrence du port 6370 avec la valeur de port correcte identifiée à l’étape précédente.

  4. Consultez la section backend_options et mettez à jour toute référence au port 26370 au port Valkey approprié, le cas échéant.

  5. Enregistrez le fichier .magento.env.yaml mis à jour et validez les modifications.

  6. Redéployez l’application Adobe Commerce à l’aide de la configuration corrigée.

  7. Vérifiez que le déploiement s’est terminé correctement et qu’aucune erreur de connexion Valkey n’apparaît dans les journaux de déploiement.

Remarque : vérifiez que tous les fichiers de configuration faisant référence à Valkey, y compris .magento.app.yaml et services.yaml, utilisent la même configuration de port.

Lecture connexe

recommendation-more-help
experience-cloud-kcs-help-kbarticles