Job interface

architecture

string

autoPlacement?

ManagerPB.AutoPlacement

(Optional)

availabilityDomain

string

cloud

Cloud

currentHash

bigint

description

string

extraSecurityGroups?

string[]

(Optional) Extra security-group labels this job needs on whatever node it lands on; resolved to ids by the Manager at reconcile/provision time. Derived from the placement requirements at submit time — SDK callers should carry it through unchanged. Wire shape is repeated string, so absent and empty are indistinguishable.

jobId

JobId

launchConfigJson?

string

(Optional) Host/operator launch config for the product-template path — the JSON encoding of norsk-ctl’s ProductTemplateLaunchConfig. Daemon-owned and opaque to Manager (stored, forwarded to the worker, never interpreted here). Round-tripped by fromJob/toJob so that updateJob(await jobById(id)) does not erase it. Absent ⇔ unset on the wire; "" is a present-but-empty value.

managerConfiguration?

string

(Optional) JSON configuration to be passed to the manager and stored with the job

norskCpuList?

number[]

(Optional)

norskMediaVersion

NorskVersion

norskServiceParameters?

ServiceParameters

(Optional) Service parameters to be passed to the Norsk Media container when it is started

productTemplate?

ProductTemplateRef

(Optional) Product-template-shaped jobs (task 39). If set, the worker launches the product-template stack; if absent, the legacy services/volumes path is used. Manager is opaque to the content — productTemplate and productTemplateParameters are stored and forwarded as-is.

productTemplateParameters?

Record<string, string>

(Optional) Resolved env-var overrides for the product-template compose stack (defaults already layered with operator overrides at submit time). Wire shape is a map<string,string>; absent and empty are indistinguishable.

services

Service[]

Additional services to be run as part of the job

shape

string

startDateTime

Date

Date and time for when the job should be started

state

JobState

subnet

string

tags

{ [key: string]: string; }

Tags to associate with the job

templateLaunchDefaultsJson?

string

(Optional) Template-author launch defaults (JSON), the second tier the worker fuses with launchConfigJson at launch. Same ownership and round-trip rules as launchConfigJson.

terminalState?

{ failureReason: string; }

(Optional) Durable terminal-failed verdict written back by AutoManager when it gives up on a job (restart ceiling exceeded / bronze drop). Present ⇒ the job has fully failed and must not be re-placed; absent ⇒ no terminal verdict. Survives a daemon restart (persisted by the Manager).

volumes?

string[]

(Optional)

writeFiles?

WriteFile[]

(Optional)