Deployment-livscykel

Varje gång du utlöser en deploy skapar Velumi en ny deployment-post för den environment. Deployment går igenom en serie statusar medan den fortskrider.

Statusar

StatusBetydelse
pendingI kö — inget arbete har påbörjats ännu
buildingKällkoden kompileras och imagen byggs
builtBygget klart — imagen redo, väntar på att runnern ska deploya den
deployingImagen rullas ut till runnern
readyLive och serverar trafik — detta är den nuvarande deployment
failedBygg eller deploy misslyckades — serverade aldrig trafik
supersededVar tidigare nuvarande, ersatt av en nyare deployment

ready, failed och superseded är terminala — deployment kommer inte ändra status efter att ha nått en av dessa.

Cutover probe och autentiseringsmiddleware

Innan trafik växlas över till en ny deployment skickar Velumi en oautentiserad förfrågan till rotsökvägen:

GET /?__templ_cutover_probe=<timestamp>-<random>
Cache-Control: no-cache
Pragma: no-cache

Om din app använder Basic Auth, login-omdirigeringar eller annan middleware som begränsar förfrågningar, se till att denna probe får HTTP 200 istället för en autentiseringsutmaning, omdirigering eller fel. Query-parametern är __templ_cutover_probe, med två inledande understreck. Dess värde ändras mellan förfrågningar; kontrollera parameterns närvaro, inte ett specifikt värde.

Hantera proben före autentiseringsutmaningar eller omdirigeringar, genom att använda alla tre villkoren:

  • Request-metoden är GET.
  • URL-pathname är exakt /.
  • Query-strängen innehåller __templ_cutover_probe.

Returnera ett fast plain-text-svar såsom ok, med Cache-Control: private, no-store, och avsluta förfrågan omedelbart. Hoppa inte över autentisering och fortsätt in i din applikation: parametern är publik, inte en hemlighet eller bevis på att en förfrågan kom från Velumi. Returnera aldrig skyddade sidor, assets eller API-data genom detta undantag.

Håll alla andra sökvägar och metoder skyddade, även när de inkluderar samma parameter. Om nödvändig konfiguration saknas eller är ogiltig och appen inte säkert kan servera trafik, returnera ett fel istället för att rapportera redo-status. En blockerad probe kan förhindra deployment-cutover även när bygget lyckas.

Vad "nuvarande" betyder

Varje environment har exakt en nuvarande deployment — den med status ready som aktivt serverar trafik. När en ny deployment når ready, övergår den tidigare nuvarande deployment till superseded.

Utlösa en deployment

Gå till Projekt → Environment → Deployments och utlös en ny deployment. Du kan också starta om en stoppad environment eller försöka igen med en misslyckad deployment från samma vy.

En deployment utlöses också automatiskt efter att ett projekt har skapats.

En operation i taget

En environment kör en deployment eller livscykeloperation i taget. Vad som händer när du utlöser en ny åtgärd medan en redan körs beror på åtgärden:

  • Deploys köas. Både en manuell deploy och en push-utlöst auto-deploy hålls kvar och körs automatiskt när den nuvarande operationen är klar. Att utlösa en deploy manuellt under en aktiv operation visar en bekräftelse, sedan ett "Deployment queued"-meddelande. (En push till en stoppad environment är det enda undantaget — den ignoreras snarare än köas.)
  • Rollback och Stop tar över omedelbart. Dessa avbryter operationen som pågår och körs direkt — en rollback bör inte behöva vänta bakom ett trasigt bygge, och en stop bör ta ner environment nu. Du kommer att bli ombedd att bekräfta, eftersom den körande operationen avbryts.

Detaljsida

Klicka på valfri deployment i listan för att öppna dess detaljsida. Den visar:

  • Status och kort deployment-ID
  • Källa — branch, commit-hash och en länk till GitHub (eller "Archive upload" för zip-källor)
  • Utlöst av-etikett, och PR-nummer om tillämpligt
  • Byggtid
  • Bygglogg
  • Felmeddelande för misslyckade deployments
  • En Preview-knapp om deployment har en preview-URL