193 lines
5.5 KiB
Markdown
193 lines
5.5 KiB
Markdown
# 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).
|