Repository navigation
feat: printer CLI, GitHub releases, one-line install and self-update - #4
Conversation
…pdate - rename cmd/print-agent to cmd/printer; the binary keeps every agent and printing subcommand and adds status, start/stop/restart, log, update, rollback, version, config (show/edit/check/path), test, autoupdate, setup - update: GitHub latest release, semver comparison, sha256 check against checksums.txt, probe of the new binary, atomic rename keeping printer.prev, restart and rollback when the service does not stay up - setup: idempotent install of the binary, systemd user units, config template (never overwrites), linger; migrates the old print-agent binary - embed the units, the config template and the label scripts in the binary - install.sh downloads and verifies the release binary (gh fallback for a private repository), --from-source keeps the local Go build Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…tion) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- labels: use LABEL_SCRIPT_PATH/STICKER_SCRIPT_PATH only when the file exists (warn and fall back to the embedded copy); embed sticker.png and extract it next to print.py; config check/setup warn on missing paths - envfile: never echo a malformed line (it may hold a secret); mask user:pass@ in URLs - update: https-only downloads to GitHub hosts (redirects included, test override PRINTER_UPDATE_INSECURE=1), 100 MB limit, remember a version rolled back by the health check so the timer does not reinstall it, explicit downgrade message; lock also rollback and setup; setup keeps printer.prev when the same build is already installed - linger: fall back to $USER / id -un when user.Current fails - install.sh: run from main() (no partial curl|bash), temp dir under ~/.cache (noexec /tmp), setup with stdin from /dev/null - release workflow: tag must be on main, concurrency, actions pinned by SHA - tests: installAndRestart rollback orchestration, no secret in problems Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Retours de revue corrigés dans 3eeeca2 : Bloquants
Mineurs
Vérifications : |
Objectif
Faire de l'agent d'impression un outil simple à exploiter sur le PC de caisse : binaire publié sur GitHub, installation en une commande sans Go, service en arrière-plan qui démarre au boot, et une commande
printerpour tout gérer (état, logs, config, mise à jour avec rollback).Choix de conception
printer(sous-commandes Go, pas de script wrapper) : l'agent (printer run, lancé par systemd) et les commandes d'exploitation dans le même fichier. Une seule chose à télécharger et à vérifier,updateremplace tout d'un coup, et la logique (versions, checksum, rollback, validation de la config) est testée en Go plutôt que dans du bash. Toutes les anciennes sous-commandes (detect,receipt-test,label…) restent.print-agent.service) et la même config (~/.config/print-agent/env) : migration sans casse, historique journald conservé.StartLimitIntervalSec=0pour qu'il ne renonce jamais (réseau absent au boot).assets.go). Les scripts sont extraits au besoin dans~/.cache/print-agent/scripts/<hash>/, ce qui permet d'imprimer des étiquettes avec un binaire de release, sans clone du dépôt. Ordre de recherche inchangé :LABEL_SCRIPT_PATH/STICKER_SCRIPT_PATH, puisscripts/à côté du binaire, puis la copie embarquée.printer update:releases/latest→ comparaison semver (un build de dev est toujours remplacé) → téléchargement deprinter_linux_<arch>+checksums.txt→ vérification sha256 → exécution du nouveau binaire (version --shortdoit renvoyer le tag) →renameatomique, l'ancien est gardé enprinter.prev→ redémarrage → le service doit resteractivependant 20 s sans redémarrage automatique (NRestarts /auto-restart) → sinon rollback et redémarrage de l'ancien. Un verrouflockempêche deux mises à jour simultanées.printer rollbackéchangeprinteretprinter.prev.printer autoupdate on|off|status) : timer quotidien à 05:00 (+30 min aléatoires), non persistent, pour ne jamais mettre à jour un PC allumé en pleine ouverture. Raison : une mise à jour redémarre l'agent, et une caisse doit changer de version quand on l'a décidé.linux/amd64etlinux/arm64(CGO_ENABLED=0,-ldflags -X main.version/commit/date),checksums.txt,gh release create --generate-notes. Un tag-rc.Nproduit une pré-release, ignorée parupdate. Un workflow CI (vet, tests, build,bash -n install.sh) tourne aussi sur les PR et surmain.visibility: PUBLIC), donc rien n'est requis. S'il devient privé :install.shbascule surgh release download, etupdatelitPRINTER_GITHUB_TOKEN/GH_TOKEN/GITHUB_TOKEN(environnement ou config), puis le token degh.printer setupn'active le service au boot qu'une fois la config valide (sinon boucle de crash toutes les 5 s à chaque démarrage) ;printer config editl'active et le redémarre après validation.Commandes
printer status·start/stop/restart(refusent une config invalide, vérifient que l'agent reste démarré) ·log(suivi en temps réel ;-n Npour les N dernières lignes,-f,--since,--errors) ·update [--check] [--version vX.Y.Z]·rollback·version [--short]·config [show|edit|check|path](secrets masqués, validation : format EnvironmentFile, champs requis, valeurs d'exemple, URL, durées, variables inconnues) ·test(ticket « TEST IMPRESSION » sur l'imprimante ticket : version, poste, date, device ; sans prix, sans code-barres, sans ouverture du tiroir) ·autoupdate [on|off|status]·setup [--no-start].Installation sur un PC neuf
Pré-requis inchangés : groupe
lp(sudo usermod -aG lp $USER),python3-piletbrother_qlpour les étiquettes.setupvérifie ces points et l'affiche.Migration du PC de caisse actuel
(installé avec l'ancien
install.sh:~/.local/bin/print-agentet le serviceprint-agent)Ce que fait
setup: garde~/.config/print-agent/envtel quel (droits passés à600), réécritprint-agent.serviceavecExecStart=%h/.local/bin/printer run, déplace l'ancien binaire en~/.local/bin/print-agent.legacyet le remplace par un lienprint-agent -> printer, puis redémarre. Retour arrière documenté dans le README (remettreprint-agent.legacyet l'ancienExecStart).À faire après le merge, avant la migration : publier la première release (le script télécharge
releases/latest).Première release
Après le merge sur
main:Le workflow
Releasepublieprinter_linux_amd64,printer_linux_arm64etchecksums.txt. Vérification :gh release view v1.0.0 -R ICTools/printer-agent.Tests
go vet ./...etgo test ./...passent.checksums.txtet vérification sha256, sélection d'asset,Stagecontre un faux GitHub (binaire modifié refusé, URL API utilisée avec un token),Swap/Rollback, verrou, détection de boucle de crash systemd, parsing / validation / masquage de la config, migration de l'ancien binaire, config jamais écrasée, extraction des scripts embarqués, ticket de test sans ouverture du tiroir.HOMEisolé avec de fauxsystemctl/loginctlet un faux serveur GitHub local : migration depuis une ancienne installation, mise à jour v0.1.0 → v0.2.0, rollback automatique quand le service redémarre en boucle, checksum modifié refusé sans rien installer,printer rollback. Buildlinux/arm64vérifié.🤖 Generated with Claude Code