Přeskočit na hlavní obsah

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 audit a Trivy.
  • Měsíčně: aktualizace závislostí (uv lock --upgrade, npm update) a základních obrazů (Dockerfile), poté make check build security a vydání.
  • Bezpečnostní opravy kritických nálezů: mimořádné vydání bez čekání.