Sommaire de la documentation

AarView · Exploiter

Mise à jour, sauvegarde, désinstallation

Exploiter l'édition autonome d'AarView : mettre à jour dans le bon ordre, sauvegarder ce qui compte, redémarrer, et désinstaller.

Sur cette page

Mettre à jour

Le schéma de la base d’abord, l’API ensuite :

git pull                                   # ou décompressez la nouvelle version
docker compose build --pull
docker compose run --rm migrate            # le schéma d'abord, l'API n'est pas encore lancée
docker compose up -d

La version installée figure sur la page À propos d’AarView.

Sauvegarder

Tout ce qui compte est à deux endroits :

  1. le fichier .env : il contient les secrets et l’identifiant d’instance. Conservez-le avec la sauvegarde, chiffré ;
  2. le volume PostgreSQL.
docker compose exec -T postgres pg_dumpall -U aarview | gzip > aarview-$(date +%F).sql.gz

Si l’installateur a créé une autorité privée, conservez aussi ca-key.DO-NOT-DEPLOY.pem, hors ligne : elle sert à signer le renouvellement du certificat.

Démarrer, arrêter, consulter

docker compose up -d          # démarrer, ou appliquer un changement de .env
docker compose ps             # état des conteneurs
docker compose logs api       # journaux d'un service
docker compose down           # arrêter la pile

Désinstaller

docker compose down arrête la pile. docker compose down -v supprime aussi les volumes de données, sans retour possible.

docker compose down -v