# 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 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).