5.5 KiB
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) :
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).
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 ?
docker compose ps redis
docker ps --filter name=crypto_wallet_redis
Attendu : Up / healthy.
2.2 Port 6379 ne doit pas être public
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
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
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
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é) :
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 :
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 :
docker compose up -d backend backend-ws backend-worker-bets backend-engine
Cas C — WRONGPASS alors que Redis est up
- Vérifier la ligne dans
.env:REDIS_PASSWORD=...(sans espaces / guillemets inutiles). - Ré-exporter (§0).
- Recréer Redis et les backends pour qu’ils reprennent le mot de passe Compose :
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 :
docker compose up -d --force-recreate backend backend-ws backend-worker-bets backend-engine
4. Checklist « tout est OK »
docker compose ps redis→ healthyss … 6379→ rien (fermé)ping→PONGINFO 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 :
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
- Ne jamais republier
6379:6379sur le VPS. - Garder
REDIS_PASSWORDfort dans.env(non commité). - Preférer
export REDIS_PASSWORD="$(grep …)"plutôt quesource .env. - Après incident slave : recreate Redis (+ volume si besoin), puis confirmer
role:master.
Détails / contexte : TROUBLESHOOTING-REDIS-PORT.md · déploiement : DEPLOY-VPS.md.