Hoppa till innehållet
Stackship-dokumentation English

JobbAnvändareMaskinöversatt

Jobbinställningar

Ett jobbs fält, deras standardvärden, beräkningsplanerna, statusarna och API-vägarna.

Fält

Fält Standard Betydelse
image — (krävs) Containeravbildningen, utan tagg, till exempel ghcr.io/example/importer
tag latest Avbildningens tagg
clusterId — Klustret att köra på; det måste vara ett som boundaryn är projicerad till. Ett jobb utan det avvisas
computePlan standard CPU, minne och tillfällig disk; se Beräkningsplaner
env inga Miljövariabler som namn–värde-par, i klartext
activeDeadlineSeconds 3600 Hur länge jobbet får köra, räknat från när det skapas, inklusive tiden det väntar på sin podd och avbildning. När tiden passerat stoppas jobbet och misslyckas
ttlSecondsAfterFinished 3600 Hur länge ett avslutat jobb behålls. Sedan tas jobbet, dess podd och dess utdata bort

Jobbets namn är en del av sökvägen, inte ett fält. Ett jobb visar också dessa skrivskyddade fält:

Fält Betydelse
name, resourceGroup Var jobbet finns
status Se Statusar
createdAt När jobbet skapades
completedAt När jobbet lyckades; tomt för ett jobb som misslyckades eller inte är klart

När du läser tillbaka ett jobb visar computePlan alltid standard och clusterId är tomt, oavsett vad jobbet skapades med; jobbet körs ändå med den plan det fick.

Plattformen sätter ingen övre gräns för activeDeadlineSeconds eller ttlSecondsAfterFinished. Ett jobb kan inte ändras efter att det skapats.

Beräkningsplaner

Plan CPU Minne Tillfällig disk
nano 0,1 128 MiB 500 MiB
small 0,25 256 MiB 1 GiB
medium 0,5 512 MiB 2 GiB
standard 1 1 GiB 3 GiB
large 2 2 GiB 5 GiB
xlarge 4 4 GiB 10 GiB
2xlarge 8 8 GiB 20 GiB

Jobbet får exakt sin plan: värdena är både det som garanteras och dess gräns. Ett jobb som behöver mer minne eller tillfällig disk än sin plan stoppas och misslyckas. Andra plannamn avvisas med unknown compute plan.

Statusar

Status Betydelse
Pending Jobbet är skapat men har ingen podd än. Ett jobb vars podd aldrig skapas — till exempel för att en resurskvot är förbrukad — fortsätter att visa Pending även efter att tidsgränsen har stoppat det, tills det tas bort
Running Jobbets podd finns och är inte klar. Det gäller också en podd som fortfarande väntar på sin avbildning: ett jobb vars avbildning inte kan hämtas förblir Running tills tidsgränsen stoppar det
Succeeded Containern avslutades med slutkod 0
Failed Containern avslutades med en annan slutkod, använde mer minne eller tillfällig disk än sin plan, eller stoppades vid tidsgränsen

API

Alla vägar ligger under https://api.example.com/boundaries/{boundaryId}/resourcegroups/{resourceGroupName}/resources/jobs.

Metod och sökväg Gör Kräver
POST …/jobs/{name} Skapar jobbet från fälten ovan jobs/write
GET …/jobs Listar resursgruppens jobb, högst 50; det finns ingen sidindelning jobs/read
GET …/jobs/{name} Returnerar ett jobb jobs/read
DELETE …/jobs/{name} Tar bort jobbet, dess podd och dess utdata jobs/delete
GET …/jobs/{name}/logs Strömmar jobbets utdata som vanlig text jobs/readLogs

Ett avvisat skapande svarar 400 med något av image is required, unknown compute plan '<plan>' eller failed to create job. Ett jobb som inte finns, eller som har tagits bort efter sin livslängd, svarar 404 med job '<name>' not found. En borttagning svarar 204 även när det inte fanns något sådant jobb.