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.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be JobConfig. |
| metadata | map | The engine reads the reserved keys name, project, environment and organization to resolve the identity of the manifest, its parent Project and its dependencies. |
| spec | Spec | Job 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.
| Property | Type | Description |
|---|---|---|
| container | ContainerSpec | Command, 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). |
| timeout | string | Maximum run time of one task, as a duration string, for example 600s. If empty, the platform default applies. |
| maxRetries | int32 | Maximum number of retries for a failed task. If not greater than 0, the platform default applies. |
| parallelism | int32 | Number of tasks that can run in parallel. If not greater than 0, the platform default (1) applies. |
| taskCount | int32 | Number of tasks for each job execution. If not greater than 0, the platform default (1) applies. |
| schedule | string | Cron expression for the Cloud Scheduler trigger, for example 0 3 * * *. Required for SCHEDULED jobs. Must be empty for BEFORE, AFTER and ON_DEMAND jobs. |
| timeZone | string | NOT 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. |
| version | string | Image 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.
| Property | Type | Description |
|---|---|---|
| enabled | bool | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: turn the container off but keep its definition. |
| command | list of string | Container entrypoint. Overrides the image entrypoint (the container command). |
| args | list of string | Arguments for the entrypoint (the container args). |
| env | list of EnvVariableDefinition | Static environment variables. The engine merges them with variables from secrets and access control. |
| uid | string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: the user ID of the container process. |
| gid | string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: the group ID of the container process. |
| resources | ContainerResources | CPU and memory requests and limits. See ContainerResources. |
EnvVariableDefinition
Static environment variable.
The engine adds it to the environment of the container.
| Property | Type | Description |
|---|---|---|
| name | string | Variable name. |
| value | string | Literal value. |
ContainerResources
Compute requirements and limits of a container.
They map to the resource requests and limits of Kubernetes pods or Cloud Run services.
| Property | Type | Description |
|---|---|---|
| requests | ContainerResource | Minimum CPU and memory guaranteed to the container. |
| limits | ContainerResource | Maximum 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.
| Property | Type | Description |
|---|---|---|
| cpu | string | CPU quantity in Kubernetes/Cloud Run notation, for example "500m" or "2". |
| memory | string | Memory quantity in the same notation, for example "256Mi" or "1Gi". |