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
| Status | Betydelse |
|---|---|
pending | I kö — inget arbete har påbörjats ännu |
building | Källkoden kompileras och imagen byggs |
built | Bygget klart — imagen redo, väntar på att runnern ska deploya den |
deploying | Imagen rullas ut till runnern |
ready | Live och serverar trafik — detta är den nuvarande deployment |
failed | Bygg eller deploy misslyckades — serverade aldrig trafik |
superseded | Var 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