games_app/docs/TROUBLESHOOTING-REDIS-PORT.md

124 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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`) :
```text
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) :
```bash
# 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)
```bash
# 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 :
```bash
sudo npm run phase-b:up
# HTTPS :
# sudo npm run phase-b:up:https
```
Vérifier :
```bash
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 :
```bash
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`)