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.