124 lines
3.8 KiB
Markdown
124 lines
3.8 KiB
Markdown
# 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`)
|