Documentation Technique Ops

max_connections = 200
shared_buffers = 256MB
work_mem = 16MB
maintenance_work_mem = 128MB
effective_cache_size = 768MB
log_min_duration_statement = 1000  # log requêtes > 1s

Host rewapp-bastion-prod
  HostName bastion.rewapp.fr
  User ec2-user
  IdentityFile ~/.ssh/rewapp-prod.pem
  Port 22

Host rewapp-*-prod
  ProxyJump rewapp-bastion-prod
  User ec2-user
  IdentityFile ~/.ssh/rewapp-prod.pem

# Connexion au bastion
ssh rewapp-bastion-prod

# Connexion à une instance via bastion
ssh rewapp-app-prod

# Rotation manuelle d'un secret via Dashboard CapRover
# Apps > [APP_NAME] > App Configs > Environmental Variables
# Modifier la variable concernée puis Save & Update

# Installation de CapRover CLI
npm install -g caprover

# Configuration du serveur
caprover serversetup

# Login au serveur CapRover
caprover login

# Vérification de la connexion
caprover api --path "/user/system/info" --method GET

# Lister les applications CapRover
caprover api --path "/user/apps" --method GET

# Voir l'état d'une application
docker ps --filter "name=srv-captain--[APP_NAME]"

# Forcer le redéploiement d'une application
caprover api --appName [APP_NAME] --method restartApp

# Modifier le nombre d'instances (scaling manuel)
# Via Dashboard CapRover : Apps > [APP_NAME] > App Configs > Instance Count

# Voir les logs d'un container
docker logs srv-captain--[APP_NAME] --tail 100 -f

# Voir les logs via CapRover dashboard
# Dashboard > Apps > [APP_NAME] > App Logs

# Connexion à la base de données via Docker
docker exec -it srv-captain--postgres psql -U rewapp_admin -d rewapp_prod

# Vérifier l'état du container PostgreSQL
docker ps --filter "name=srv-captain--postgres"

# Créer un backup manuel
docker exec srv-captain--postgres pg_dump -U rewapp rewapp_prod > backup_$(date +%Y%m%d).sql

# Lister les backups
ls -la /captain/data/backups/

# Redémarrer PostgreSQL (⚠️ downtime)
docker restart srv-captain--postgres

-- Vérifier les connexions actives
SELECT pid, usename, application_name, client_addr, state, query_start, query
FROM pg_stat_activity
WHERE state = 'active';

-- Voir les requêtes lentes (> 5s)
SELECT pid, now() - pg_stat_activity.query_start AS duration, query
FROM pg_stat_activity
WHERE (now() - pg_stat_activity.query_start) > interval '5 seconds';

-- Tuer une requête bloquante
SELECT pg_terminate_backend(pid);

-- Vérifier la taille des tables
SELECT relname AS table_name,
       pg_size_pretty(pg_total_relation_size(relid)) AS total_size
FROM pg_catalog.pg_statio_user_tables
ORDER BY pg_total_relation_size(relid) DESC
LIMIT 10;

-- Vérifier les locks
SELECT blocked_locks.pid AS blocked_pid,
       blocked_activity.usename AS blocked_user,
       blocking_locks.pid AS blocking_pid,
       blocking_activity.usename AS blocking_user,
       blocked_activity.query AS blocked_statement
FROM pg_catalog.pg_locks blocked_locks
JOIN pg_catalog.pg_stat_activity blocked_activity 
  ON blocked_activity.pid = blocked_locks.pid
JOIN pg_catalog.pg_locks blocking_locks 
  ON blocking_locks.locktype = blocked_locks.locktype
JOIN pg_catalog.pg_stat_activity blocking_activity 
  ON blocking_activity.pid = blocking_locks.pid
WHERE NOT blocked_locks.granted;

# Connexion Redis via Docker
docker exec -it srv-captain--redis redis-cli

# Vérifier l'état du container Redis
docker stats srv-captain--redis

# Vérifier la connexion
PING

# Voir les statistiques mémoire
INFO memory

# Voir les clés par pattern
KEYS session:*
KEYS qr:*
KEYS rate:*

# Compter les clés
DBSIZE

# Voir le TTL d'une clé
TTL session:user123

# Supprimer une clé
DEL session:user123

# Invalider le cache API
KEYS cache:api:* | xargs redis-cli DEL

# Flush database (⚠️ ATTENTION - perte de données)
FLUSHDB

# Voir les logs d'une application
docker logs srv-captain--[APP_NAME] --tail 100 -f

# Stream des logs en temps réel
docker logs srv-captain--auth-service --follow

# Rechercher dans les logs (avec grep)
docker logs srv-captain--auth-service 2>&1 | grep "ERROR"

# Via CapRover Dashboard
# Apps > [APP_NAME] > App Logs

# Exporter les logs vers un fichier
docker logs srv-captain--auth-service > auth-service-logs.txt 2>&1

# Voir les logs Loki (si configuré)
# Dashboard Grafana > Explore > Loki

# Configuration client MinIO (mc)
mc alias set rewapp http://minio.rewapp.fr ACCESS_KEY SECRET_KEY

# Lister les buckets
mc ls rewapp/

# Lister le contenu d'un bucket
mc ls rewapp/rewapp-prod-assets/

# Copier un fichier
mc cp local-file.png rewapp/rewapp-prod-assets/images/

# Synchroniser un dossier
mc mirror ./backup rewapp/rewapp-prod-backup/manual/

# Télécharger un fichier
mc cp rewapp/rewapp-prod-backup/daily/latest.sql ./

# Via Dashboard CapRover :
# Apps > [APP_NAME] > App Configs > Environmental Variables

# Voir les variables d'environnement d'un container
docker exec srv-captain--[APP_NAME] env

# Mettre à jour une variable via CapRover API
caprover api   --path "/user/apps/appData/[APP_NAME]"   --method POST   --data '{"envVars":[{"key":"API_KEY","value":"new-value"}]}'

# Note: Après modification, redéployer l'application
# Dashboard > Apps > [APP_NAME] > Save & Update

# Mettre le service en maintenance
docker stop srv-captain--[SERVICE]

# Vérifier que le container est arrêté
docker ps --filter "name=srv-captain--[SERVICE]"

# Remettre le service en ligne
docker start srv-captain--[SERVICE]

# Forcer un nouveau déploiement via CapRover
caprover api --appName [SERVICE] --method restartApp

# Ou via Dashboard : Apps > [SERVICE] > Save & Update

# Via Dashboard CapRover :
# Apps > [SERVICE] > App Configs > Instance Count > 6

# Vérifier le scaling
docker ps --filter "name=srv-captain--[SERVICE]"

# Ou via API CapRover
caprover api --path "/user/apps/appData/[SERVICE]" --method GET

# Via Dashboard CapRover :
# Apps > [SERVICE] > App Configs > Environmental Variables
# Ajouter/modifier : LOG_LEVEL=debug

# Puis Save & Update pour appliquer les changements

# Ou via CapRover API
caprover api   --path "/user/apps/appData/[SERVICE]"   --method POST   --data '{"envVars":[{"key":"LOG_LEVEL","value":"debug"}]}'

# Les certificats Let's Encrypt sont gérés automatiquement par CapRover

# Via Dashboard CapRover :
# Apps > [APP_NAME] > HTTP Settings > Enable HTTPS

# Vérifier l'état SSL d'une application
openssl s_client -connect rewapp.fr:443 -servername rewapp.fr | openssl x509 -noout -dates

# Les certificats sont renouvelés automatiquement 30 jours avant expiration

-- Vacuum complet d'une table
VACUUM FULL VERBOSE transactions;

-- Analyze pour mettre à jour les statistiques
ANALYZE transactions;

-- Vacuum et Analyze complet
VACUUM ANALYZE;

-- Reindexer une table
REINDEX TABLE transactions;

-- Reindexer toute la base
REINDEX DATABASE rewapp_prod;

# Accès au shell d'un container Docker
docker exec -it srv-captain--[APP_NAME] /bin/sh

# Dans le container
curl -v https://api.budgetinsight.com/health
telnet postgres 5432
redis-cli -h redis PING

# Métriques Docker
docker stats srv-captain--[APP_NAME]

# Via Prometheus/Grafana
# Dashboard > Grafana > Docker Metrics

# Via CapRover Dashboard
# Apps > [APP_NAME] > App Configs > Monitor

# Via CapRover Dashboard : Apps > [APP_NAME] > Deployment
# Voir l'historique des images et sélectionner une version précédente

# Ou via Docker CLI
docker images | grep [APP_NAME]

# Redéployer une image précédente
caprover deploy --imageName [REGISTRY]/[APP_NAME]:[PREVIOUS_TAG]