Skip to main content

Deployment Config

DeploymentConfig​

Defines the runtime configuration of an application for one environment.

It overrides settings of an Application manifest, for example resource limits and volume mounts.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be DeploymentConfig.
metadatamapThe engine reads the reserved keys name and project to resolve this manifest and its parent Project.
specSpecDesired configuration. See Spec.

BucketMountsEntry​

PropertyTypeDescription
keystring
valueVolumeMountBucketRef

EventArcNotificationsEntry​

PropertyTypeDescription
keystring
valuestring

PortsEntry​

PropertyTypeDescription
keyint64
valuestring

VolumeMountsEntry​

PropertyTypeDescription
keystring
valueContainerVolumeMount

Spec​

User-provided deployment overrides.

Environment-specific settings that the engine layers on the shared Application definition.

PropertyTypeDescription
descriptionstringOptional free text. The engine copies it to the compute resource. AI assistants use it as context.
deleteBeforeCreateboolNOT YET IMPLEMENTED. The engine ignores this field and always does rolling updates. It will remove the old revision first.
statefulboolNOT YET IMPLEMENTED. The engine ignores this field. It will signal that the application needs durable storage. For VMs, use the stateful block of VirtualMachine.
containerContainerSpecOverrides for the main container (command, args, environment variables, resource limits and requests). They merge over the BuildDefinition or ExternalApplication definition.
portslist of PortsEntryMap of port number (1-65535) to protocol (http, grpc or tcp). Each entry creates a backend endpoint and a mesh route.
healthHealthHealth probe settings. If unset, the platform default applies. See Health.
volumeslist of VolumesEntryMap of container mount path to volume source, for example a bucket-backed volume. Validation rejects mount paths under /tmp.
scalingScalingConfigMin and max instance count. See ScalingConfig.
versionstringImage tag to deploy. The container also gets it in the INFRASTREAM_APP_VERSION environment variable. Required.
requestTimeoutint64Request timeout in seconds, from 0 to 3600. Applies only if greater than 0, otherwise the platform default applies (Cloud Run: 300). Kubernetes and Compute set the backend service timeout.
terminationGracePeriodSecondsint64Seconds, from 0 to 3600, between SIGTERM and the forced stop of the container. Kubernetes sets Pod.spec.terminationGracePeriodSeconds. Compute sets the TERMINATION_GRACE_PERIOD_SECONDS environment variable. If 0, the platform default applies.
gpuDeploymentGpuConfigAttaches one GPU to the application container. Only for target: CLOUD_RUN. Validation rejects this block on any other target, even an empty block. container.resources.limits must meet the CPU and memory minimum of the accelerator. The region of the parent Project must serve it.
invokerslist of stringApplications allowed to call this service directly. Cloud Run only. If empty (default), invoker IAM is off. Only the ingress setting limits access, so an internal service accepts calls from any workload in the VPC.
allowDirectIngressboolNOT RECOMMENDED for general use. If true, an HttpRoute with ingress_path DIRECT can send traffic to this service. The default is false. The service declares that it checks every caller itself. A DIRECT route skips the mesh gateway, so the mesh does not check the caller.

Health​

Container health probes.

Startup and liveness probes gate the deployment and detect hung containers.

PropertyTypeDescription
startupHostHealthConfigNOT YET IMPLEMENTED. The engine ignores this field. The startup probe comes from liveness.
livenessHostHealthConfigProtocol, port, path and timing settings. The engine uses them for the startup probe and the liveness probe.

PortsEntry​

PropertyTypeDescription
keyint64
valuestring

ScalingConfig​

Instance autoscaling bounds.

Lower and upper limits on the number of instances.

PropertyTypeDescription
minint64Minimum number of warm instances. Applies only if greater than 0. A value of 0 allows scale to zero.
maxint64Maximum number of instances. Applies only if greater than 0.
hasBackgroundOperationsboolIf true, the service does background work outside requests, for example timers or queue consumers. CPU stays always allocated, so request-based (CPU-idle) billing does not apply. Default: false (CPU throttled between requests).
maxConcurrencyint64Maximum concurrent requests for one instance. Applies only if greater than 0, otherwise the platform default (80) applies. Ignored on Kubernetes and Compute targets.

VolumesEntry​

PropertyTypeDescription
keystring
valueContainerVolumeMount

DeploymentGpuConfig​

GPU accelerator for the application container of a deployment.

Cloud Run attaches at most one GPU to one container, so the block has no count or container selector. Validation rejects the block on targets other than CLOUD_RUN, even when accelerator is empty.

PropertyTypeDescription
acceleratorstringAccelerator model, nvidia-l4 or nvidia-rtx-pro-6000. Required when this block is present. nvidia-l4 has 24 GB VRAM and needs at least 4 CPU and 16Gi memory. nvidia-rtx-pro-6000 (RTX PRO 6000 Blackwell) has 96 GB VRAM and needs at least 20 CPU and 80Gi memory. The container resources.limits.cpu and resources.limits.memory must meet the minimum. Validation rejects a smaller container and does not raise the values. nvidia-l4 must also fit the Cloud Run matrix: 4, 6 or 8 CPU with at most 16Gi, 24Gi or 32Gi of memory. For nvidia-rtx-pro-6000, validation enforces only the minimum and a whole number of vCPU.
zonalRedundancyDisabledboolOpt out of GPU zonal redundancy. Zonal redundancy reserves GPU capacity in a second zone for zonal outages. It is the Cloud Run default and costs more. If true, you pay less but get a weaker SLA and no protection from a zonal outage.

HostHealthConfig​

Health check for host endpoints.

Sets the probes and backend health checks for GCP load balancers.

PropertyTypeDescription
protocolstringHealth check protocol: http, http2, https, grpc, or tcp. It applies to container probes (Cloud Run, GKE) and the VM backend health check.
portint64TCP port that the health check targets.
checkIntervalSecint64Interval between checks, in seconds. The default is 30 for generated probes. Default 30
timeoutSecint64Seconds to wait for a probe response before it fails. The engine sets 10 for generated probes. Default 5
healthyThresholdint64Consecutive successful probes that mark the endpoint healthy. The default is 1. Default 1
unhealthyThresholdint64Consecutive failed probes that mark the endpoint unhealthy. The default is 2. Default 2
enableLogsboolNOT YET IMPLEMENTED. The engine ignores this field. Intended to enable health-check logs.
pathstringHTTP request path for HTTP-family probes. The default is /. Default "/"

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.

ContainerVolumeMount​

Generated files for a container volume.

The files typically become config maps or secrets on Kubernetes, or files on Cloud Run.

PropertyTypeDescription
fileslist of FilesEntryMap of relative file path to file content. Each entry becomes a file in the volume.

VolumeMountBucketRef​

Bucket mounted as a volume.

Describes the Cloud Storage FUSE mount of a bucket.

PropertyTypeDescription
namestringName of the Bucket manifest to mount with Cloud Storage FUSE.
pathstringPath where the container mounts the bucket.
canWriteboolIf true, the mount is read-write and the service account of the container gets object-write permission on the bucket. If false, the mount is read-only.

FilesEntry​

PropertyTypeDescription
keystring
valueVolumeMountFile

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.

VolumeMountFile​

Generated file in a volume mount.

Startup scripts write the file to disk.

PropertyTypeDescription
mimeTypestringMIME type of the file. If empty, the engine sets a default.
contentstringFile content: plain text, or base64 if base64_encoded is true.
base64EncodedboolIf true, the engine decodes content from base64 before it writes the file.

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".