games_app/docs/TROUBLESHOOTING-REDIS-PORT.md

3.8 KiB
Raw Blame History

Dépannage : Redis port 6379 déjà utilisé

Symptômes

Lors de npm run phase-b:up (ou docker compose --profile http up -d --build) :

Error response from daemon: failed to set up container networking:
... endpoint crypto_wallet_redis ...
failed to bind host port 0.0.0.0:6379/tcp: address already in use

Sur l’app (page prédiction Candle Predict, Tloto Support, realtime) :

  • Stream isn't writeable and enableOfflineQueue options is false
  • Connection is closed

Ce n’est pas un bug marketing / Live Activity. C’est Redis indisponible : le backend Redis client utilise enableOfflineQueue: false et échoue immédiatement si Redis est down.

Un simple « rebuild » peut parfois « marcher » parce qu’il arrête/recrée des conteneurs et libère temporairement le port — le conflit peut revenir au prochain up.

Cause

Le conteneur Redis (crypto_wallet_redis) publie le port hôte 6379. Si un autre process ou un autre conteneur Redis l’occupe déjà, le démarrage échoue. Les services API / WS / workers démarrent parfois sans Redis → erreurs realtime ci-dessus.

Diagnostic

Sur le VPS (dans le dépôt du projet) :

# Qui écoute sur 6379 ?
sudo ss -tlnp | grep 6379
# ou
sudo lsof -i :6379

# Conteneurs Redis (y compris arrêtés)
docker ps -a --filter name=redis
docker ps -a | grep -i redis

# État de la stack
sudo npm run phase-b:status
# ou
docker compose ps

Interpréter :

Observation Interprétation
Conteneur crypto_wallet_redis Exit / Created Échec de bind ; Redis de la stack n’est pas up
Autre conteneur Redis « Up » sur 6379 Deux stacks Docker se disputent le port
Process redis-server hors Docker Redis système qui occupe 6379

Résolution

1. Libérer le port (cas le plus fréquent)

# Ancien conteneur Redis de cette stack
docker stop crypto_wallet_redis 2>/dev/null
docker rm crypto_wallet_redis 2>/dev/null

# Autre Redis Docker (adapter le nom si besoin)
docker ps -a | grep -i redis
docker stop <autre_conteneur_redis>
docker rm <autre_conteneur_redis>

# Redis installé sur l’hôte (si ss/lsof le montre)
sudo systemctl stop redis
# ou
sudo systemctl stop redis-server

Puis relancer :

sudo npm run phase-b:up
# HTTPS :
# sudo npm run phase-b:up:https

Vérifier :

docker ps --filter name=crypto_wallet_redis
# doit être "Up"
sudo ss -tlnp | grep 6379
# doit être le conteneur Docker Redis de la stack

2. Éviter deux stacks en parallèle

Ne pas laisser tourner en même temps :

  • phase-b (prod VPS) et
  • une autre compose qui mappe aussi 6379:6379 (ex. ancien projet, docker:local sur la même machine)

Garder une seule stack qui expose 6379, ou changer le mapping de l’autre (ex. "6380:6379") dans son docker-compose — sans changer Redis côté app tant que l’URL interne Docker reste redis:6379.

3. Confirmer que les erreurs app disparaissent

Après Redis up :

  1. Recharger la page prédiction et le Support.
  2. Les messages Stream isn't writeable… / Connection is closed ne doivent plus apparaître.
  3. Logs utiles :
    docker logs crypto_wallet_redis --tail 50
    docker logs crypto_wallet_api --tail 80
    docker logs crypto_wallet_ws --tail 80
    

Prévention

  • Avant un phase-b:up, vérifier : sudo ss -tlnp | grep 6379.
  • Après un déploiement raté, ne pas enchaîner des rebuilds sans regarder Redis : corriger le port d’abord.
  • Sur un VPS partagé, ne pas installer Redis système et Redis Docker sur le même 6379.

Références code

  • Client Redis (échec rapide) : backend/src/realtime/redis/client.ts (enableOfflineQueue: false)
  • Compose / service Redis : docker-compose (service redis, port hôte 6379)
  • Commandes stack : docs/DEPLOY-VPS.md (phase-b:up, phase-b:status, phase-b:logs)