- le REPL 'theme <name>' applique ET sauvegarde le theme (settings.theme dans le fichier de config actif, cree s'il manque) via persist_setting - correction racine : config::merge ignorait settings.theme - la valeur persistee n etait jamais relue au chargement, le theme par defaut etait toujours reapplique apres un redemarrage - 'am --theme <name>' reste un one-shot ; config set settings.theme <nom> fonctionne egalement - aides mises a jour (banniere, help theme) - tests de persistance + relecture au demarrage, man pages regenerees, version 0.4.3
111 lines
4.9 KiB
Markdown
111 lines
4.9 KiB
Markdown
# Publier une release
|
|
|
|
Les installateurs one-liner (`install.sh` et `install.ps1`), la commande
|
|
`am self-update` et les paquets (scoop/winget/homebrew) consomment les
|
|
**artefacts attachés à la dernière release** du dépôt Gitea
|
|
(https://git.dracodev.net/Projets/agent-manager). Sans binaire pour la
|
|
plateforme, les installateurs retombent sur `cargo install --git`.
|
|
|
|
La phase 1 (v0.4.1) a ajouté le pipeline CI (issue #42) : sur chaque tag
|
|
`v*`, `.gitea/workflows/release.yml` construit Linux (x86_64 + aarch64
|
|
musl statiques), Windows (x86_64) et macOS (x86_64 + aarch64) et publie la
|
|
release. La procédure locale ci-dessous reste disponible pour produire
|
|
manuellement les mêmes artefacts (ou les plateformes sans runner CI).
|
|
|
|
## 1. Bumper la version
|
|
|
|
Dans Cargo.toml (ex. `0.4.1`), puis `cargo check` pour mettre à jour
|
|
Cargo.lock, et lancer toute la batterie :
|
|
|
|
cargo test --locked # 240+ tests
|
|
cargo clippy --all-targets -- -D warnings # si possible
|
|
|
|
## 2. Produire les binaires et les archives
|
|
|
|
### Windows (x86_64) — natif
|
|
|
|
scripts/build-release.ps1 # target/release/am.exe -> dist/am-windows-x86_64.zip
|
|
|
|
### Linux — binaire STATIQUE (musl), compatible toutes distributions,
|
|
### y compris Debian 12 (glibc 2.36) — ne JAMAIS publier un binaire glibc
|
|
### compilé sur une base récente.
|
|
|
|
# cargo-zigbuild : zig (~50 Mo) fournit le linker croisé pour les DEUX
|
|
# cibles musl (rust:1.94-alpine n'embarque pas de compilateur croisé
|
|
# aarch64 : 'aarch64-linux-musl-gcc not found').
|
|
docker run --rm -v "${PWD}:/work" -w /work -e CARGO_TARGET_DIR=/tmp/am-target \
|
|
-e CARGO_INCREMENTAL=0 rust:1.94-alpine sh -c "apk add --no-cache build-base zip curl >/dev/null && \
|
|
rustup target add x86_64-unknown-linux-musl aarch64-unknown-linux-musl && \
|
|
curl -fsSL https://ziglang.org/download/0.14.1/zig-x86_64-linux-0.14.1.tar.xz -o /tmp/zig.tar.xz && \
|
|
tar -xf /tmp/zig.tar.xz -C /opt && \
|
|
export PATH=/opt/zig-x86_64-linux-0.14.1:\$PATH && \
|
|
cargo install cargo-zigbuild --locked && \
|
|
cargo zigbuild --release --locked --target x86_64-unknown-linux-musl --target aarch64-unknown-linux-musl && \
|
|
mkdir -p dist && \
|
|
cp /tmp/am-target/x86_64-unknown-linux-musl/release/am dist/am-linux-x86_64 && \
|
|
cp /tmp/am-target/aarch64-unknown-linux-musl/release/am dist/am-linux-aarch64 && \
|
|
cd dist && tar -czf am-linux-x86_64.tar.gz am-linux-x86_64 && \
|
|
tar -czf am-linux-aarch64.tar.gz am-linux-aarch64"
|
|
|
|
### macOS (x86_64 + aarch64) — via CI (runner macOS) :
|
|
|
|
# le job 'macos' du workflow release.yml produit :
|
|
# am-macos-x86_64.tar.gz am-macos-aarch64.tar.gz
|
|
# (compilation croisée macOS impossible depuis Windows/Linux ; sans
|
|
# runner macOS, ces archives manquent et l'install.sh compile depuis
|
|
# les sources sur macOS, ce qui reste fonctionnel.)
|
|
|
|
Vérifier chaque archive : `am version` doit répondre, et `am doctor` ne
|
|
doit signaler aucune dépendance manquante.
|
|
|
|
## 3. Rendre les manifests de packaging (issue #42)
|
|
|
|
Une fois toutes les archives dans `dist/` :
|
|
|
|
scripts/render-manifests.ps1 -Version 0.4.3
|
|
|
|
Ce script rend, avec la version et les sha256 réels :
|
|
|
|
- `dist/scoop/am.json` → `scoop install dist/scoop/am.json`
|
|
(ou à ajouter à un bucket ; checkver/autoupdate inclus)
|
|
- `dist/winget/*.yaml` → à soumettre à microsoft/winget-pkgs
|
|
(`winget install BrunoDracodev.AgentManager`)
|
|
- `dist/homebrew/am.rb` → à servir via un tap, ou à soumettre
|
|
- `dist/rpm/am.spec` → rpmbuild -bb (avec am-linux-x86_64.tar.gz
|
|
dans ~/rpmbuild/SOURCES)
|
|
- Paquet deb : `packaging/deb/make-deb.sh 0.4.3` → dist/am_0.4.3_amd64.deb
|
|
|
|
## 4. Créer la release sur Gitea
|
|
|
|
Via l'interface web : Releases > New Release, tag v0.4.3, attacher les
|
|
archives. Ou via l'API (jeton Gitea requis) :
|
|
|
|
curl -X POST -H "Authorization: token <JETON>" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"tag_name":"v0.4.3","name":"v0.4.3","body":"notes de version"}' \
|
|
https://git.dracodev.net/api/v1/repos/Projets/agent-manager/releases
|
|
|
|
curl -X POST -H "Authorization: token <JETON>" \
|
|
-F "attachment=@dist/am-windows-x86_64.zip" \
|
|
https://git.dracodev.net/api/v1/repos/Projets/agent-manager/releases/<id>/assets?name=am-windows-x86_64.zip
|
|
|
|
# idem pour am-linux-x86_64.tar.gz, am-linux-aarch64.tar.gz,
|
|
# am-macos-x86_64.tar.gz, am-macos-aarch64.tar.gz (si CI) et
|
|
# checksums.txt.
|
|
|
|
## 5. Tag git (déclenche aussi le pipeline CI)
|
|
|
|
git tag v0.4.3 && git push origin v0.4.3
|
|
|
|
## Conventions de nommage (attendues par les installateurs et self-update)
|
|
|
|
- am-windows-x86_64.zip (contient am.exe)
|
|
- am-linux-x86_64.tar.gz (contient am)
|
|
- am-linux-aarch64.tar.gz (contient am)
|
|
- am-macos-x86_64.tar.gz / am-macos-aarch64.tar.gz (contiennent am)
|
|
|
|
## Vérification finale
|
|
|
|
am self-update --check # doit annoncer la nouvelle version
|
|
am self-update # met à jour le binaire courant
|