Skip to main content

Job Config

JobConfig​

Environment-specific runtime configuration of one application job.

It matches one entry in spec.jobs of the parent Application by the name pattern <app-name>-<job-name> and provisions a Cloud Run Job. SCHEDULED jobs also get a Cloud Scheduler trigger. BEFORE and AFTER jobs run before or after the service of the DeploymentConfig.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be JobConfig.
metadatamapThe engine reads the reserved keys name, project, environment and organization to resolve the identity of the manifest, its parent Project and its dependencies.
specSpecJob configuration. See Spec.

Spec​

User-provided job configuration.

The engine takes the container image and the job type from the parent Application. These fields tune how the Cloud Run Job runs.

PropertyTypeDescription
containerContainerSpecCommand, arguments, environment variables and CPU and memory limits of the job container. Required. They apply on top of the image from the parent Application (BuildDefinition or ExternalApplication).
timeoutstringMaximum run time of one task, as a duration string, for example 600s. If empty, the platform default applies.
maxRetriesint32Maximum number of retries for a failed task. If not greater than 0, the platform default applies.
parallelismint32Number of tasks that can run in parallel. If not greater than 0, the platform default (1) applies.
taskCountint32Number of tasks for each job execution. If not greater than 0, the platform default (1) applies.
schedulestringCron expression for the Cloud Scheduler trigger, for example 0 3 * * *. Required for SCHEDULED jobs. Must be empty for BEFORE, AFTER and ON_DEMAND jobs.
timeZonestringNOT YET IMPLEMENTED. The engine ignores this field, so schedules always run in UTC. Intended use: the IANA timezone for schedule, for example America/New_York.
versionstringImage tag to deploy. Required. The engine sets it as the container image tag and as the INFRASTREAM_APP_VERSION environment variable. CD promotions update it.

ContainerSpec​

Core configuration block for a runtime container.

It overrides the entrypoint, variables and compute constraints of the base image.

PropertyTypeDescription
enabledboolNOT YET IMPLEMENTED. The engine ignores this field. Intended use: turn the container off but keep its definition.
commandlist of stringContainer entrypoint. Overrides the image entrypoint (the container command).
argslist of stringArguments for the entrypoint (the container args).
envlist of EnvVariableDefinitionStatic environment variables. The engine merges them with variables from secrets and access control.
uidstringNOT YET IMPLEMENTED. The engine ignores this field. Intended use: the user ID of the container process.
gidstringNOT YET IMPLEMENTED. The engine ignores this field. Intended use: the group ID of the container process.
resourcesContainerResourcesCPU and memory requests and limits. See ContainerResources.

EnvVariableDefinition​

Static environment variable.

The engine adds it to the environment of the container.

PropertyTypeDescription
namestringVariable name.
valuestringLiteral value.

ContainerResources​

Compute requirements and limits of a container.

They map to the resource requests and limits of Kubernetes pods or Cloud Run services.

PropertyTypeDescription
requestsContainerResourceMinimum CPU and memory guaranteed to the container.
limitsContainerResourceMaximum CPU and memory that the container can use.

ContainerResource​

Single resource boundary for a container.

It sets the requests or the limits for CPU and memory.

PropertyTypeDescription
cpustringCPU quantity in Kubernetes/Cloud Run notation, for example "500m" or "2".
memorystringMemory quantity in the same notation, for example "256Mi" or "1Gi".