Skip to content

ADK on Cloud Run: Production Deployment Documentation

adk-a2a-prod-cloud-run takes the 7 ADK agents from the local IDP project and deploys them as independent A2A servers on Cloud Run. Each agent has its own URL, its own container, and scales to zero when it receives no traffic. Communication between agents is via HTTP using the A2A protocol — no shared filesystem.

AspectLocalCloud Run
FilesystemShared (/app/outputs/)Isolated per container
CommunicationFile read/writeHTTP via A2A protocol
ScalingNoneAuto scale-to-zero
AuthenticationNoneIAM + identity tokens
SecretsEnvironment variablesSecret Manager
#AgentResponsibilityCloud Run Service
1Platform ArchitectAnalyzes the task and decides the full stackplatform-architect
2InfrastructureGenerates Docker Compose from the Architect’s decisionsinfrastructure
3SecurityScans for vulnerabilities and can block the pipelinesecurity
4CI/CDGenerates build, test, deploy scripts and Jenkinsfilecicd
5ObservabilityConfigures Prometheus + Grafana dashboardsobservability
6DevExGenerates executable CLI tool with project commandsdevex
7Web PortalBuilds complete web portal with FastAPI + HTMXweb-portal
ComponentTechnology
FrameworkGoogle ADK
ProtocolA2A (Linux Foundation)
ModelGemini 2.5 Flash (or Vertex AI)
DeployCloud Run
BuildCloud Build
RegistryArtifact Registry
SecretsSecret Manager
OrchestratorPython + httpx

Next step: GCP Setup — APIs, IAM and Secret Manager →