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

5.5 KiB
Raw Permalink Blame History

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

  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 :
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 → 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 :

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 · déploiement : DEPLOY-VPS.md.