Nasazení, verze a aktualizace
Verze
vX.Y.Z bez úvodních nul a přípon; první vydání v0.0.0, každé další zvýší poslední číslo
o jedna. Jediným zdrojem verze je Git tag; aplikace ji ukazuje v zápatí a v /api/health.
Tag se nikdy nepřepisuje ani nepoužije znovu – neúspěšná verze zůstává evidovaná (GitHub
Release označený jako neúspěšný) a oprava dostane další číslo.
Stage
make deploy # nebo make deploy stage, make deploy v0.0.1, make deploy stage v0.0.1
DRY_RUN=1 make deploy # jen ověří stav a spustí kontroly, nic nerezervuje
Postup: kontrola argumentů a přípustnosti verze → čistý a pushnutý commit → make check →
rezervace verze pushnutím tagu (atomicky) → workflow Vydání na stage: kontroly, sestavení
a publikace ghcr.io/scorty/lift:vX.Y.Z, kouřový test, posun tagu stage na digest
(Arcane ho převezme), čekání na /api/health s novou verzí a commitem, E2E testy, záznam
nasazení (GitHub Release s verzí, commitem, digestem a výsledkem).
make deploy vypíše odkaz na běh a identifikátor nasazení, počká na výsledek a vrátí jeho
kód. Při přerušení sledování netvrdí selhání – vypíše stav a příkaz gh run view <id>.
Produkce
make deploy prod # poslední verze ověřená na stage
make deploy prod v0.0.1
Příkaz ověří, že verze má záznam verified-stage, a vypíše
LIFT_IMAGE=ghcr.io/scorty/lift:vX.Y.Z@sha256:…. V Arcane: synchronizujte
compose-prod.yaml z commitu tagu, nastavte LIFT_IMAGE, nasaďte a ověřte
https://lift.vytahy1.cz/api/health. Migrace proběhnou v kontejneru migrate před startem.
Selhání a rollback
Rollback se podle rozhodnutí provozovatele neřeší; chyba se opravuje novým vydáním. Proto jsou migrace navrhované dopředně kompatibilně. Při selhání nasazení stejného artefaktu je možné nasazení v Arcane zopakovat (verze se nemění).
Pravidelné aktualizace
- Týdně: workflow mutačních testů; při každém push CI s
pip-audit,npm audita Trivy. - Měsíčně: aktualizace závislostí (
uv lock --upgrade,npm update) a základních obrazů (Dockerfile), potémake check build securitya vydání. - Bezpečnostní opravy kritických nálezů: mimořádné vydání bez čekání.