# Runbook — exploitation (day-2)

> En mode Coolify, les conteneurs ont le suffixe `-tdquwauzxsq0985fk9kjqqys` (cf. `deploy.conf`
> `CONTAINER_SUFFIX`). Les helpers `scripts/*.sh` le gèrent automatiquement via `cname`.

## Consulter / piloter
```bash
docker ps --filter name=ark-                       # état
docker logs -f ark-backend-<suffix>                # logs backend
docker logs -f ark-worker-<suffix>                 # logs worker (tâches)
# depuis Coolify : dashboard -> projet arkindex -> service arkindex (Deploy / Logs / Restart)
```

## Redémarrer / redéployer
```bash
# CLI :
cd ~/arkindex-deploy && docker compose restart backend
# Coolify (API) :
curl -s -X POST -H "Authorization: Bearer $(cat ~/.ark_coolify_token)" \
  "http://localhost:8000/api/v1/deploy?uuid=tdquwauzxsq0985fk9kjqqys"
```

## Mettre à jour Arkindex (nouvelle version d'image)
1. Vérifier la dernière finale (cf. Troubleshooting P1).
2. Changer les tags dans `docker-compose.coolify.yml` (backend/front) + `deploy.conf`.
3. En Coolify : mettre à jour le compose du service (UI ou API) puis redéployer.
4. **Toujours** relancer les migrations :
   ```bash
   docker exec ark-backend-<suffix> arkindex migrate
   ```

## Shell Django / admin
```bash
docker exec -it ark-backend-<suffix> arkindex shell
docker exec -it ark-backend-<suffix> arkindex createsuperuser   # (interactif)
scripts/40-create-admin.sh                                       # (scripté, idempotent)
```

## Recherche (Solr)
```bash
# (re)indexer un corpus après import de données
docker exec ark-backend-<suffix> arkindex reindex --corpus-id <UUID> --drop
# tout réindexer
docker exec ark-backend-<suffix> arkindex reindex --all
```

## Stockage S3 (Garage)
```bash
G=ark-garage-<suffix>
docker exec $G /garage bucket list
docker exec $G /garage bucket info staging
docker exec $G /garage stats
```

## Sauvegardes
```bash
scripts/99-backup-db.sh          # pg_dump + inventaire buckets -> backups/
# volumes gérés par Coolify : arkindex-deploy_* (anciens, backup) et <uuid>_* (actifs)
docker volume ls | grep -E 'arkindex-deploy_|tdquwauzxsq'
```

## Nettoyage des anciens volumes CLI (après validation Coolify)
```bash
docker volume rm arkindex-deploy_pgdata arkindex-deploy_redisdata \
                 arkindex-deploy_solrdata arkindex-deploy_garagedata
```

## Santé / vérification complète
```bash
ADMIN_PASS='…' scripts/50-verify.sh
```

## Mémoire serrée ?
- Soupape : désactiver la recherche → `features.search: no` dans `config.yml`, retirer le service
  `ark-solr`, redéployer. Solr est le plus gros consommateur (~450 Mo).
- Le swap (4 Go) absorbe les pics ; surveiller `free -h` et `docker stats`.