Écrire la marche à suivre : mise en production et montée de version

PUBLICATION.md donne les gestes pas à pas, avec le contrôle attendu à
chaque étape : première mise en production, montée de version (0.1.0 →
0.1.1), retour arrière si la mise à jour échoue, désinstallation.

Deux points qui se paient cher s'ils sont oubliés y sont explicites :
`--version` est obligatoire pour une nouvelle version applicative (sans
lui le script reproduit celle du manifeste), et la sauvegarde de sécurité
pré-upgrade ne contient PAS le répertoire de données.

README et A_FAIRE renvoient au fichier plutôt que de tripler la
procédure. Dernière URL fictive éliminée : gitea.exemple.org subsistait
dans l'exemple CI de publier-release.sh.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-18 21:05:56 +02:00
co-authored by Claude Opus 5
parent 7ab423783f
commit 54a22b1579
4 changed files with 318 additions and 120 deletions
+9 -2
View File
@@ -25,7 +25,7 @@ Le serveur ne compile jamais : il télécharge une archive déjà produite. La c
```bash
# Depuis ce dépôt, avec le dépôt du code à côté (../mabibli)
./build/publier-release.sh --version 0.2.0 --base-url https://gitea.exemple.org/mathieu/mabibli/releases/download
./build/publier-release.sh --version 0.1.1
```
Le script :
@@ -38,7 +38,12 @@ Le script :
5. réécrit `version`, `amd64.url` et `amd64.sha256` dans `manifest.toml`.
Restent à faire à la main : créer le tag et la release sur Gitea, y téléverser l'archive, puis
committer `manifest.toml`.
committer et **pousser** `manifest.toml` — YunoHost lit le manifeste depuis Gitea, pas la copie
locale.
📖 **La marche à suivre complète est dans [`PUBLICATION.md`](PUBLICATION.md)** : première mise en
production, montée de version (avec les contrôles à chaque étape), retour arrière, et
désinstallation.
Le script ne dépend d'aucun environnement de CI : tout passe par des options ou des variables
d'environnement (`MABIBLI_SOURCE_DIR`, `MABIBLI_VERSION`, `MABIBLI_BASE_URL`,
@@ -68,3 +73,5 @@ copier le seul fichier `.db` d'une base active peut ne rien sauvegarder du tout.
- `doc/DESCRIPTION.md` — présentation affichée dans le catalogue YunoHost
- `doc/ADMIN.md` — authentification, emplacement des données, sauvegarde, contraintes
- `PUBLICATION.md` — mise en production et montée de version, pas à pas
- `A_FAIRE.md` — contraintes permanentes et journal des points réglés