Application
Application
High-level intent for a deployable, first-party application.
The engine creates the Cloud Run services or GKE Deployments, DNS and load-balancer resources, service-mesh routes, and IAM identity that run the workload. For an image built outside the workspace, use ExternalApplication.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be Application. |
| metadata | map | The engine reads reserved keys to resolve the identity and the parents, for example its Project and its parent ApplicationSet. |
| spec | ApplicationDefinition | Desired application configuration. Required. See ApplicationDefinition. |
ApplicationDefinition
Application specification.
Spec body of the Application manifest. ExternalApplication uses ExternalApplicationDefinition, because its image comes from outside the workspace.
| Property | Type | Description |
|---|---|---|
| description | string | Free text that describes what the application does. Used as documentation and as context for AI assistants. |
| target | string | Runtime the application deploys to: KUBERNETES, CLOUD_RUN, COMPUTE or CDN. CDN is a static site: the engine provisions a public Bucket behind the load balancer and Cloud CDN, through a StaticAssetRoute. For CDN, build_definition must be a REACT build whose publish stage uploads the production bundle to a STATIC ArtifactRegistry. The engine ignores cluster, and mesh_strategy must be DISABLED. |
| meshStrategy | string | SIDECAR deploys a proxy sidecar and creates mesh HTTP/gRPC routes against a SIDECAR_PROXY backend. PROXYLESS uses in-process gRPC service discovery. DISABLED keeps the application out of the mesh. Must be DISABLED when target is CDN. |
| project | string | Name of the Project manifest that receives the resources of the application. Required. It must be present in every environment of the parent ReleaseTrack. |
| accessControl | ApplicationAccessControlConfig | Access that the service account of the application gets to platform resources such as Buckets, Databases, Pub/Sub topics and Secrets. |
| bundleOnly | bool | If true, the engine does not promote the application through pre-release tracks. It records each successful build version as a deployment that release-track bundles can include. |
| jobs | list of ApplicationJobReference | Jobs that run BEFORE deploy, AFTER deploy, SCHEDULED by cron or ON_DEMAND. Each reference needs a JobConfig manifest in every environment. |
| buildDefinition | string | Name of the BuildDefinition manifest that builds the artifact of the application. Required. For compute targets, the registry and image name come from its containerize block. For target: CDN, it must be a REACT build whose publish stage uploads a static bundle to a STATIC registry. |
| cluster | string | metadata.name of the Kubernetes manifest to deploy to, in project. Required when target is KUBERNETES. Ignored for CLOUD_RUN and COMPUTE. It must exist in every environment of the parent ReleaseTrack. |
ApplicationJobReference
Job that is part of the lifecycle of an Application.
A JobConfig manifest gives the environment-specific container, schedule, and resources.
| Property | Type | Description |
|---|---|---|
| name | string | Unique name of the job in the application, for example migrate. It links to the JobConfig manifest. Required. |
| type | string | BEFORE runs before the service deploy and blocks until complete (for example DB migrations). AFTER runs after the deploy and blocks until complete. SCHEDULED runs on a Cloud Scheduler cron expression. ON_DEMAND has no schedule: a user triggers it manually or with the API. |
ApplicationAccessControlConfig
All external access rules of an application.
Each block adds IAM bindings, SQL grants, or secret access.
| Property | Type | Description |
|---|---|---|
| additionalRoles | list of string | Extra IAM roles for the application service account, beyond the roles from the other blocks. |
| pubsub | ApplicationAccessControlPubsubConfig | Publish and subscribe grants for specific Pub/Sub topics. |
| buckets | list of ApplicationAccessControlBucketConfig | Cloud Storage buckets that the application can read or write. |
| database | ApplicationAccessControlDatabaseConfig | PostgreSQL database access: instance, schema, privileges, and credential source. |
| secrets | list of SecretsEntry | Map from Secret manifest name to how the application gets the secret. |
| redis | list of ApplicationAccessControlRedisConfig | Redis instances that the application can use. |
| jobs | list of ApplicationAccessControlJobConfig | Cloud Run Jobs of other applications that this application can trigger with the RunJob API. |
ApplicationAccessControlDatabaseConfig
PostgreSQL access for a workload.
Runs CREATE USER and GRANT on the target SQL instance.
| Property | Type | Description |
|---|---|---|
| name | string | Name of the Database manifest (an AlloyDB/PostgreSQL instance) that the application needs. |
| schema | string | Database (schema) in the instance that the application connects to. |
| privileges | list of string | SQL privileges for the application database role on the schema: USAGE, CREATE, or ALL. Each one becomes a GRANT statement. |
| readOnly | bool | If true, the application has read-only access, typically to a read replica. |
| extensions | list of string | PostgreSQL extensions to enable. Each entry runs CREATE EXTENSION IF NOT EXISTS. The engine merges the lists of all applications that share a schema. |
| secretSource | SecretSourceConfig | Source of the database credentials: the Secret manifest and how the application gets it (environment variable or file mount). Required. |
SecretsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | SecretSourceConfig |
ApplicationAccessControlJobConfig
Permission to trigger a Cloud Run Job of another application.
Grants roles/run.developer on the job and injects the job resource name as an environment variable.
| Property | Type | Description |
|---|---|---|
| application | string | Name of the Application manifest that owns the target job. Required. |
| job | string | Name of the job. It matches an ApplicationJobReference.name of that application. Required. |
| envVar | string | Environment variable for the full Cloud Run resource name of the job. If empty, the caller must derive the job name. |
ApplicationAccessControlRedisConfig
Redis cache access for a workload.
Injects the connection URL as an environment variable. All instances use TLS (SERVER_AUTHENTICATION).
| Property | Type | Description |
|---|---|---|
| name | string | Name of the Redis manifest. The application deploys after the DNS record of the instance resolves. Required. |
| envVar | string | Environment variable that receives the connection URL redis[s]://memory-<redis-name>.<internal-domain>:<port>. Meshed strategies (SIDECAR, PROXYLESS) use redis:// on port 6380. Direct access (DISABLED) uses rediss:// on port 6379. Required. |
| caCertPath | string | Absolute path in the container of the server CA certificate (PEM). The application must load it into its TLS trust pool. Required. |
ApplicationAccessControlBucketConfig
Cloud Storage access for a workload.
Grants roles/storage.objectViewer or roles/storage.objectUser on a bucket.
| Property | Type | Description |
|---|---|---|
| name | string | Name of the Bucket manifest. It must exist in every environment of the parent ReleaseTrack. Required. |
| source | string | Name of a GithubRepository manifest whose contents seed the bucket through a gcloud storage rsync job in CI/CD. Optional. |
| permission | string | READ_ONLY grants roles/storage.objectViewer. WRITE grants roles/storage.objectUser. |
| mountPath | string | Absolute path in the container where Cloud Storage FUSE mounts the bucket. If omitted, the engine grants access but does not mount the bucket. |
| subPath | string | Bucket prefix that limits access, for example to mount one folder. If omitted, access covers the whole bucket. |
| promote | bool | If true, the engine promotes the bucket content through the ReleaseTrack with the application. |
| envVar | string | Environment variable that receives the bucket name, instead of a filesystem mount. Mutually exclusive with mount_path. |
ApplicationAccessControlPubsubConfig
Pub/Sub permissions for a workload.
The engine grants the roles to the service account of the workload.
| Property | Type | Description |
|---|---|---|
| publishTo | list of string | Names of PubSub manifests that the workload can publish to. Each entry grants roles/pubsub.publisher on the topic. |
| subscribeTo | list of string | Each entry, a PubSub manifest name, grants roles/pubsub.subscriber on the TOPIC. On a topic, this role only gives pubsub.topics.attachSubscription. The workload can attach a subscription, but it cannot pull from or acknowledge on any subscription, even a managed one in spec.subscriptions. To create a subscription, the workload also needs pubsub.subscriptions.create on the project, which this field does not grant. To consume from a managed subscription, use pull_from. The behavior stays unchanged for old manifests. |
| pullFrom | list of ApplicationAccessControlPubsubPullConfig | Each entry grants roles/pubsub.subscriber on one subscription from spec.subscriptions of a PubSub manifest, and nothing on the topic or the project. The topic and subscription must exist in the project of the workload, or validation fails. See ApplicationAccessControlPubsubPullConfig. |
ApplicationAccessControlPubsubPullConfig
Pub/Sub subscription that a workload consumes.
Grants roles/pubsub.subscriber on a subscription or its dead-letter subscription.
| Property | Type | Description |
|---|---|---|
| topic | string | Name of the PubSub manifest (topic) that declares the subscription. Required. |
| subscription | string | Name of the subscription in spec.subscriptions of that manifest. Required. |
| deadLetter | bool | If true, the grant targets the dead-letter subscription <topic>-<subscription>-dlq-sub. The subscription must declare deadLetter. To republish messages, the worker also needs the topic in publish_to. |
SecretSourceConfig
How to retrieve a secret and mount it into a workload.
The engine grants IAM access to the Secret Manager payload and resolves values JIT.
| Property | Type | Description |
|---|---|---|
| envVar | string | Name of the environment variable that holds the secret. Mutually exclusive with file_path: set exactly one. |
| version | string | Secret Manager version: latest or a number such as 1. Defaults to latest. |