deploy.service.bind-config

Resolve deployment target, release, environment, and runtime config into a Cloud Run service contract.

Overview

Property	Value
Workflow type	Atomic
Library	App-deployments
Version	1.0

Input Schema

Field	Type	Required	Default	Description
workflow_run_id	string	No	—	Engine-stamped DAG step run ID.
organization_uuid	uuid	Yes	—	Organization UUID.
deployment_target_uuid	uuid	Yes	—	Deployment target UUID.
release_uuid	uuid	No	—	Existing DeploymentRelease UUID.
service_name	string	Yes	—	Logical service name.
environment	string	No	—	Deployment environment name.
image_reference	string	No	—	Image tag or digest reference for backend services.
runtime_overrides	json	No	—	Caller overrides for resources, env, traffic, or labels.
database_binding	json	No	—	Output from deploy.database.provision-postgres.

Output Schema

Field	Type	Required	Default	Description
workflow_run_id	string	No	—	Engine-stamped DAG step run ID.
organization_uuid	uuid	Yes	—	Echoed organization UUID.
deployment_target_uuid	uuid	Yes	—	Echoed target UUID.
release_uuid	uuid	No	—	Release UUID when present.
connection_uuid	uuid	Yes	—	GCP connection UUID resolved from target.
project_id	string	No	—	Effective GCP project.
region	string	Yes	—	Cloud Run region.
service_name	string	Yes	—	Provider service name.
image_reference	string	No	—	Resolved image reference.
env	json	No	—	Plain runtime environment variables.
secret_requirements	list	No	—	Secrets required by the service.
secret_env	json	No	—	Pre-existing Secret Manager env mappings, if any.
service_account	string	No	—	Runtime service account.
cloud_sql_instances	list	No	—	Cloud SQL connection names to mount.
resources	json	No	—	CPU, memory, concurrency, timeout, and scaling config.
vpc	json	No	—	VPC connector and egress config.
traffic	json	No	—	Initial traffic policy.
iam_bindings	list	No	—	Cloud Run service IAM bindings.
labels	json	No	—	Provider labels.
annotations	json	No	—	Provider annotations.
failure_reason	string	No	—	Failure reason.
error	string	No	—	Error message.
error_type	string	No	—	Error class.

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "deploy.service.bind-config",
  "initial_data": {
    "organization_uuid": "value",
    "deployment_target_uuid": "value",
    "service_name": "value"
  }
}