Stackship-plattformenAnvändareMaskinöversatt

Operationer

Vad en operation på plattformen är, vilka tillstånd den går igenom och hur du följer en i portalen, med CLI:t och via API:et.

Att skapa, ändra, skala, driftsätta eller radera en resurs tar längre tid än ett anrop. Plattformen registrerar sådant arbete som en operation: vem som startade den, vad den gäller, dess steg och hur den slutade. En operation hör till boundaryn för resursen den gäller; en plattformsuppgradering är en operation för plattformen själv.

Vad en operation registrerar

Typ — vad som görs: Create, Update, Delete, Scale, Start, Stop, Restart, Deploy, Rollback, motsvarande varianter för appars platser, och Rollout för plattformsuppgraderingar.
Resurs — dess typ, namn och resursgrupp.
Startad av — personen eller tjänstekontot som startade den.
Steg — delarna av arbetet, var och en med egen status och eget meddelande.
Status och meddelande — hur det går, och varför när den misslyckades.
Tidpunkter för start och slut.

Statusar

Status	Betydelse
`Running`	Arbetet pågår.
`Paused`	Väntar på att återupptas — används av plattformsuppgraderingar.
`Succeeded`	Klar.
`Failed`	Avbröts med ett fel; meddelandet säger varför.
`Cancelled`	Avbröts på begäran.
`Superseded`	En nyare operation på samma resurs ersatte den innan den blev klar.
`Dismissed`	Finns på vissa äldre operationer. Att ta bort en operation från dina aviseringar sätter den inte; det döljer bara operationen för dig.

Aviseringarna och en resurs flik Operations utelämnar operationer med Superseded och Dismissed; hela historiken på boundaryns flik Åtgärder tar med dem.

En pågående operation där inget steg har startat eller avslutats på 30 minuter markeras som Failed med "Operation timed out waiting for status update." En pausad operation får ingen tidsgräns. Avslutade operationer sparas i 30 dagar om inte din plattform är konfigurerad annorlunda.

I portalen

Aviseringar (klockan i sidhuvudet) listar pågående operationer och de som avslutats under de senaste 24 timmarna, i den valda boundaryn — dina egna eller allas. Att ta bort en från listan, eller att välja Rensa slutförda, döljer den bara för dig.
Varje resurs har en flik Operations med operationerna på den resursen.
Boundaryns sida har en flik Åtgärder med hela historiken, sökbar på resursnamn och filtrerbar på status och tid.

För att se operationer krävs kernel/operations/read, som alla inbyggda roller som kan se en resurs också har.

Med CLI:t

Kommandon som ändrar en resurs väntar tills deras operation är klar, om du inte anger --no-wait. För att följa operationer själv:

bash

stsh operation list --running
stsh operation get <operation-id>
stsh operation wait <operation-id> --timeout 900

stsh operation wait avslutas med 0 när operationen lyckas, 6 när den misslyckas och 7 när tidsgränsen passeras först.

Via API:et

Några anrop svarar 202 Accepted med operationens id i operationId: att driftsätta och rulla tillbaka en statisk webbapp, att driftsätta en blueprint och att återställa en ögonblicksbild. De flesta anrop som startar arbete returnerar det inte; hitta det då bland resursens operationer. Fråga sedan efter operationen tills dess status varken är Running eller Paused:

Metod och sökväg	Returnerar
`GET /boundaries/{boundaryId}/resourcegroups/{resourceGroupName}/resources/{type}/{name}/operations`	Resursens operationer
`GET /boundaries/{boundaryId}/operations`	Pågående operationer och de som avslutats under de senaste 24 timmarna, högst 50
`GET /boundaries/{boundaryId}/operations?viewScope=History`	Hela historiken, sidindelad med `pageSize` och `pageToken`, filtrerbar på `status`, `resourceType`, `resourceName`, `search`, `from` och `to`
`GET /boundaries/{boundaryId}/operations/{operationId}`	En operation med dess steg