Aller au contenu principal

Exploitation

Tout ce qu'un administrateur fait sur une installation en service passe par une seule commande : ./liberty (lancée depuis release/) avec Docker, liberty-ops avec une installation Python. Les deux ont les mêmes verbes.


Vue d'ensemble​

Exploiter./liberty start./liberty stop./liberty restart./liberty status./liberty logsContrôler./liberty doctor./liberty ssl./liberty dashboard-passwordFaire évoluer./liberty upgrade./liberty rollback./liberty apps./liberty migrateProtéger./liberty backup./liberty restoreDockerrelease/libertyPythonliberty-ops, mêmes verbesAvant une mise à jourbackup

État​

./liberty status
Liberty Next — /opt/liberty-next/release
layout full
tls letsencrypt (liberty.example.com)
apps overlay yes (/opt/liberty-next/release/apps)
image tag 7.0.58
chain docker-compose.full.yml:docker-compose.tls-letsencrypt.yml:docker-compose.apps.yml
database embedded — the bundled Postgres (pg)
container running/healthy
framework 7.0.58
apps bundle 7.0.58
/ready {"status":"ok","version":"7.0.58","pool":"default"}
migrations up to date
last upgrade stack 7.0.57 → 7.0.58 (2026-10-27T08:12:40)
LigneSignification
layout, tls, apps overlay, chainCe qui a été installé et les fichiers compose enregistrés dans .env.
image taglatest ou la version fixée.
databaseL'emplacement de la base : embedded — the bundled Postgres (le Postgres intégré), embedded — SQLite (déploiement léger), ou external — utilisateur@hôte:port/nom.
containerÉtat et santé Docker — unhealthy quand la base du framework ne répond pas.
framework, apps bundleLes versions réellement en service.
/readyLe contrôle de disponibilité du serveur.
migrationsMigrations de schéma des applications sous licence restant à appliquer.
last upgradeLa dernière entrée de Liberty Next → Déployer → Historique → Upgrades.

Diagnostic​

./liberty doctor contrôle l'installation et affiche, pour chaque problème, la commande qui le corrige. La commande se termine avec le code 1 quand quelque chose ne va pas — une demande de support commence par sa sortie.

Elle contrôle :

  • .env, les fichiers compose enregistrés et l'existence de chacun ;
  • la présence du dossier des applications sous licence dans les fichiers compose quand il est configuré — la cause habituelle d'une installation qui « paraît vide » ;
  • la longueur de la clé maître et du secret JWT ;
  • le mot de passe du tableau de bord Traefik et l'exposition du port PostgreSQL (installation complète) ;
  • les fichiers de certificat ou le domaine Let's Encrypt quand le HTTPS est actif ;
  • les volumes, le conteneur et /ready ;
  • les migrations de schéma en attente ;
  • le déchiffrement de chaque mot de passe de pool par la clé maître ;
  • l'espace disque libre.

Démarrer, arrêter, journaux​

CommandeEffet
./liberty startDémarre l'ensemble avec les fichiers compose enregistrés et attend qu'il soit en bonne santé.
./liberty stopArrête les conteneurs. Volumes et .env sont conservés.
./liberty restartRedémarre uniquement liberty-next.
./liberty logs / logs -fLes 200 dernières lignes du journal du serveur / le suivre.

Chaque ligne de journal écrite pendant le traitement d'une requête porte l'identifiant de cette requête, également renvoyé dans l'en-tête de réponse X-Request-ID : le citer permet de retrouver les lignes correspondantes.toml` écrit un objet JSON par ligne.


Sauvegarde et restauration​

./liberty backup # → release/backups/<AAAA-MM-JJ_HHMMSS>/
./liberty backup --keep 30 # et supprime les sauvegardes de plus de 30 jours
./liberty restore backups/2026-10-27_030000

Un dossier de sauvegarde contient une archive par volume (liberty-config, pg-data ou liberty-data, pgadmin-data, portainer-data), le dossier des applications sous licence (liberty-apps.tar.gz), une copie de .env (.env.snapshot, mode 0600, avec les secrets) et les fichiers compose. Une sauvegarde peut se faire pendant que l'ensemble fonctionne.

./liberty restore arrête l'ensemble, remet chaque archive du dossier dans son volume et dans le dossier des applications, puis redémarre. Tout ce qui a été écrit depuis la sauvegarde est perdu.

Une sauvegarde hebdomadaire conservée 60 jours, par cron :

0 3 * * 0 cd /opt/liberty-next/release && ./backup.sh /mnt/backup/liberty --keep 60

Copier les sauvegardes hors du serveur. .env.snapshot contient la clé maître : sans elle, la configuration restaurée ne peut pas déchiffrer ses mots de passe.

Avec une base externe, la base n'est pas dans la sauvegarde — ./liberty backup le signale : la sauvegarder sur son propre serveur (pg_dump, pg_dumpall).


Base externe​

La base du framework — et celles des applications sous licence — peuvent résider sur un serveur PostgreSQL extérieur à l'ensemble : une base managée, le serveur de bases de l'entreprise.

CommandeEffet
./liberty dbL'emplacement actuel de la base.
./liberty db dump [fichier.sql.gz]Un pg_dumpall du Postgres intégré, pour transporter les données — par défaut sous backups/. Déploiement complet uniquement.
./liberty db external --host H [--port P] [--user U] [--name D] [--password-env VAR] [--yes]Bascule l'installation sur ce serveur : la connexion de l'application et les pools qui désignaient le serveur intégré — ceux des applications sous licence — y sont redirigés, l'ensemble redémarre, et le Postgres intégré est arrêté, son volume conservé. La commande présente le changement et demande confirmation (--yes l'évite).
./liberty db embedded [--yes]Revient au Postgres intégré (déploiement complet) ou à SQLite (déploiement léger).

Les données ne sont pas copiées. Pour déplacer une installation existante :

  1. ./liberty db dump sur l'installation actuelle ;
  2. restaurer la sauvegarde sur le nouveau serveur — gunzip -c backups/pg-dumpall-….sql.gz | psql -h <hôte> -U postgres -d postgres ;
  3. ./liberty db external --host <hôte>.

Revenir avec ./liberty db embedded ne recopie pas ce qui a été écrit entre-temps sur le serveur externe. Le choix est enregistré dans .env avec les fichiers compose : start, upgrade et backup le suivent. ./liberty doctor avertit quand le Postgres intégré fonctionne encore alors que l'application utilise le serveur externe. Une nouvelle installation va directement sur un serveur externe avec ./liberty install full --db external --db-host … — voir Options d'installation.


Tâches courantes​

TâcheCommande (Docker)
Nouveau mot de passe aléatoire pour admindocker exec -u liberty liberty-next liberty-admin set-password admin
Un autre superutilisateurdocker exec -u liberty liberty-next liberty-admin create-user alice --superuser
Vérifier la licencedocker exec -u liberty liberty-next liberty-license status
Appliquer les migrations de schéma des applications./liberty migrate (--dry-run pour les lister)
Recharger la configuration après modification d'un fichierRecharger la config (en haut de toute page d'édition de Liberty Next)
Nouveau mot de passe du tableau de bord Traefik./liberty dashboard-password
Un shell dans le conteneurdocker exec -it -u liberty liberty-next bash

-u liberty compte : le serveur s'exécute sous liberty, et une commande lancée en root laisserait des fichiers que le serveur ne peut plus modifier. ./liberty le passe de lui-même. Sans --password, set-password et create-user génèrent un mot de passe et l'affichent.


Installations Python : liberty-ops​

À lancer sous l'utilisateur du service, avec son environnement chargé (sudo -u liberty bash -c 'set -a; . /etc/liberty/secrets.env; set +a; liberty-ops status').

CommandeEffet
liberty-ops statusVersions, dossier de configuration, dossier des applications, état du service, /ready, migrations en attente, dernière mise à jour.
liberty-ops doctorVersion de Python, secrets, fichiers de configuration, applications et plugins, clé maître, service, /ready, migrations, disque — chaque problème avec sa correction.
liberty-ops start · stop · restart · logs [-f]L'unité systemd (liberty-next, ou LIBERTY_SERVICE).
liberty-ops backup [--dest DIR] [--keep JOURS]Dossier de configuration (avec son historique), dossier des applications, fichier SQLite, et un pg_dump quand le pool par défaut est PostgreSQL et que pg_dump est installé. Destination par défaut : backups/ à côté du dossier de configuration.
liberty-ops restore <dossier> [--yes]Remet une sauvegarde en place en arrêtant puis redémarrant le service. Un export PostgreSQL n'est pas restauré automatiquement : la commande à lancer est affichée.
liberty-ops migrate [--dry-run]Les migrations de schéma des applications.
liberty-ops upgrade · rollbackVoir Mise à jour et retour arrière.

Dépannage​

SymptômeCauseCorrection
L'installation paraît vide après une mise à jour ou un redémarrageLe conteneur a été recréé sans le dossier des applications sous licence (un docker compose -f … à la main)../liberty doctor, puis ./liberty apps <wheel> — et s'en tenir aux commandes ./liberty.
docker ps affiche liberty-next unhealthyLa base du framework ne répond pas à /ready../liberty logs ; sur l'installation complète, vérifier le conteneur liberty-pg.
La connexion répond Too many failed logins — try again in N sDix échecs de connexion en cinq minutes pour cet utilisateur (voir Connexion).Attendre le délai indiqué, ou réinitialiser le mot de passe.
Les pools échouent avec une erreur de déchiffrementLIBERTY_MASTER_KEY n'est pas la clé qui a chiffré les mots de passe.Remettre la clé d'origine (voir .env.snapshot dans une sauvegarde).
Le serveur signale des migrations de schéma en attenteUne nouvelle version des applications modifie la base../liberty migrate.
Un fichier modifié sur le disque n'est pas pris en compteLes fichiers sont lus au démarrage ou au rechargement.Recharger la config (en haut de toute page d'édition de Liberty Next).
Port 80 ou 8000 déjà utiliséUn autre service l'occupe.Définir TRAEFIK_HTTP_PORT (complète) ou LIBERTY_PORT (légère) dans .env, puis ./liberty start.
L'installation refuse de démarrer : stale Docker volumesDes volumes d'une installation précédente existent mais son .env a disparu.Restaurer l'ancien .env, ou ./liberty install --reset puis réinstaller.