games_app/docs/REDIS-RUNBOOK.md
2026-10-26 11:57:27 +02:00

193 lines
5.5 KiB
Markdown
Raw Permalink 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.

# Runbook Redis Prediqo (VPS)
Procédure à suivre **dès qu’un problème Redis se reproduit** (prédiction bloquée, Support offline, `READONLY`, `Stream isn't writeable…`, etc.).
Répertoire de travail (adapter si besoin) :
```bash
cd ~/projects_repository/games-project
```
---
## 0. Charger le mot de passe (sans `source .env`)
Ne pas faire `source .env` (risque d’exécuter des valeurs multi-mots comme commandes).
```bash
export REDIS_PASSWORD="$(grep -E '^REDIS_PASSWORD=' .env | cut -d= -f2-)"
# Vérifier que la variable n’est pas vide :
test -n "$REDIS_PASSWORD" && echo "REDIS_PASSWORD ok" || echo "MANQUANT dans .env"
```
---
## 1. Reconnaître le symptôme
| Symptôme app / logs | Cause probable |
|---------------------|----------------|
| `Stream isn't writeable and enableOfflineQueue options is false` | Redis down ou injoignable depuis l’API/WS |
| `Connection is closed` | Idem |
| `READONLY You can't write against a read only replica` | Redis en **slave** (attaque / mauvais état) |
| `WRONGPASS` / `NOAUTH` sur `redis-cli` | Mot de passe shell faux / oublié `-a` |
| Conteneur `crypto_wallet_redis` Exit / unhealthy | Crash, mauvais `REDIS_PASSWORD`, volume |
---
## 2. Diagnostic rapide (ordre fixe)
### 2.1 Conteneur up ?
```bash
docker compose ps redis
docker ps --filter name=crypto_wallet_redis
```
Attendu : **Up** / **healthy**.
### 2.2 Port 6379 **ne doit pas** être public
```bash
sudo ss -tlnp | grep 6379 || echo "OK: 6379 fermé"
```
Si quelque chose écoute sur 6379 sur l’hôte : ce n’est **pas** Prediqo (compose ne publie plus ce port). Arrêter l’autre Redis / process ; **ne pas** republier 6379 pour Prediqo.
### 2.3 Auth + rôle master
```bash
docker exec crypto_wallet_redis redis-cli -a "$REDIS_PASSWORD" --no-auth-warning ping
# → PONG
docker exec crypto_wallet_redis redis-cli -a "$REDIS_PASSWORD" --no-auth-warning INFO replication
# → role:master
# → connected_slaves:0
```
Sans `-a` / sans export, `NOAUTH` est **normal** (Redis refuse l’accès anonyme).
### 2.4 Écriture depuis l’API
```bash
docker exec crypto_wallet_api node -e "
const Redis=require('ioredis');
const r=new Redis(process.env.REDIS_URL||'');
if(!process.env.REDIS_URL){console.error('NO_REDIS_URL');process.exit(1);}
r.set('write_probe','1').then(()=>{console.log('REDIS_WRITE_OK');return r.del('write_probe');})
.catch(e=>console.error('REDIS_FAIL',e.message))
.finally(()=>r.quit());
"
```
Attendu : `REDIS_WRITE_OK`.
---
## 3. Remediation selon le cas
### Cas A — Redis down / unhealthy / Stream isn't writeable
```bash
docker compose up -d redis
# Attendre healthy :
docker compose ps redis
docker compose up -d backend backend-ws backend-worker-bets backend-engine
```
Revérifier §2.3 et §2.4. Recharger Candle Predict / Support.
### Cas B — `role:slave` (READONLY)
Avec le compose durci, `REPLICAOF` est désactivé. Recréer Redis (le cache se reconstruit ; **Postgres** reste la source de vérité) :
```bash
docker compose stop redis
docker compose rm -f redis
docker compose up -d redis
docker exec crypto_wallet_redis redis-cli -a "$REDIS_PASSWORD" --no-auth-warning INFO replication
# doit être role:master
```
Si toujours `slave` après recreate :
```bash
docker compose stop redis
docker compose rm -f redis
docker volume ls | grep -i redis
# Exemple de nom : games-project_redis_data (adapter)
docker volume rm <NOM_VOLUME_redis_data>
docker compose up -d redis
```
Puis redémarrer les services app :
```bash
docker compose up -d backend backend-ws backend-worker-bets backend-engine
```
### Cas C — `WRONGPASS` alors que Redis est up
1. Vérifier la ligne dans `.env` : `REDIS_PASSWORD=...` (sans espaces / guillemets inutiles).
2. Ré-exporter (§0).
3. Recréer Redis **et** les backends pour qu’ils reprennent le mot de passe Compose :
```bash
docker compose up -d --force-recreate redis backend backend-ws backend-worker-bets backend-engine
```
### Cas D — `REDIS_FAIL` depuis l’API alors que `PONG` OK
L’API n’a probablement pas le bon `REDIS_URL` (ancien conteneur). Recréer les backends :
```bash
docker compose up -d --force-recreate backend backend-ws backend-worker-bets backend-engine
```
---
## 4. Checklist « tout est OK »
- [ ] `docker compose ps redis` → healthy
- [ ] `ss … 6379` → rien (fermé)
- [ ] `ping` → `PONG`
- [ ] `INFO replication` → `role:master`, `connected_slaves:0`
- [ ] Script API → `REDIS_WRITE_OK`
- [ ] Candle Predict / Support : plus d’erreurs stream
---
## 5. Noms de services utiles
| Service Compose | Conteneur |
|-----------------|-----------|
| `redis` | `crypto_wallet_redis` |
| `backend` | `crypto_wallet_api` |
| `backend-ws` | `crypto_wallet_ws` |
| `backend-worker-bets` | `crypto_wallet_worker_bets` |
| `backend-engine` | `crypto_wallet_engine` |
*(Il n’existe pas de service `backend-worker-engine`.)*
Logs :
```bash
docker logs crypto_wallet_redis --tail 80
docker logs crypto_wallet_api --tail 80
docker logs crypto_wallet_ws --tail 80
```
Ou : `npm run phase-b:logs` / `npm run phase-b:status`.
---
## 6. Règles à ne pas enfreindre
1. **Ne jamais** republier `6379:6379` sur le VPS.
2. Garder `REDIS_PASSWORD` fort dans `.env` (non commité).
3. Preférer `export REDIS_PASSWORD="$(grep …)"` plutôt que `source .env`.
4. Après incident slave : recreate Redis (+ volume si besoin), puis confirmer `role:master`.
Détails / contexte : [TROUBLESHOOTING-REDIS-PORT.md](./TROUBLESHOOTING-REDIS-PORT.md) · déploiement : [DEPLOY-VPS.md](./DEPLOY-VPS.md).