External Application
ExternalApplication
Workload backed by an image built outside the workspace.
It mirrors Application, but the container comes from a TrustedRepository (field trusted_repository) and not from an in-workspace BuildDefinition. The engine creates the same identity, network, and service-mesh resources as for an Application.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be ExternalApplication. |
| metadata | map | The engine reads reserved keys to resolve the identity and the parents, for example its Project and its parent ApplicationSet. |
| spec | ExternalApplicationDefinition | Desired external-application configuration. Required. See ExternalApplicationDefinition. |
ExternalApplicationDefinition
External application specification.
Spec body of the ExternalApplication manifest. The image comes from a trusted external repository, not from a build.
| Property | Type | Description |
|---|---|---|
| description | string | Free text that describes the application. See ApplicationDefinition.description. |
| target | string | Runtime the application deploys to: KUBERNETES, CLOUD_RUN or COMPUTE. |
| meshStrategy | string | Mesh strategy: SIDECAR, PROXYLESS or DISABLED. See ApplicationDefinition.mesh_strategy. |
| trustedRepository | string | Name of the TrustedRepository manifest (a child of an ExternalRegistry) that hosts the image. Required. It must exist. The engine builds the image reference from the publish URL of the parent registry. |
| image | string | Name of the image in the trusted repository. Required. |
| project | string | Name of the Project manifest that receives the resources of the application. Required. See ApplicationDefinition.project. |
| accessControl | ApplicationAccessControlConfig | Access that the service account of the application gets to platform resources. See ApplicationDefinition.access_control. |
| bundleOnly | bool | If true, the engine does not promote the application through pre-release tracks. See ApplicationDefinition.bundle_only. |
| jobs | list of ApplicationJobReference | Jobs of the application. See ApplicationDefinition.jobs. |
| cluster | string | metadata.name of the Kubernetes manifest to deploy to. Required when target is KUBERNETES. Ignored for CLOUD_RUN and COMPUTE. See ApplicationDefinition.cluster. |
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. |