google-agents-cli-deploy

Deploy ADK agents to Agent Runtime, Cloud Run, or GKE with managed infrastructure and CI/CD pipelines.

- Choose deployment target based on language support, scaling model, networking, and cost: Agent Runtime (managed, Python-only), Cloud Run (custom infra, event-driven), or GKE (full Kubernetes control)

- Deploy via agents-cli deploy with flags for secrets, environment variables, service accounts, and networking (VPC, PSC, DNS peering for Agent Runtime)

- Set up production CI/CD pipelines with Workfront Identity Federation (WIF) authentication, cross-project service accounts, and automated staging-to-production promotion

- Manage infrastructure as code in Terraform; define custom resources (Cloud SQL, Pub/Sub, BigQuery, Eventarc) in version control, never manually via gcloud

- Rollback via git-based redeployment or Cloud Run traffic shifting; troubleshoot via Cloud Logging and IAM permission checks on service accounts

ADK Deployment Guide

Requires: agents-cli (uv tool install google-agents-cli) - install uv first if needed.

Prefer using the agents-cli commands throughout this guide - they wrap Terraform, Docker, and deployment into a tested pipeline. If your project isn't scaffolded yet, see /google-agents-cli-scaffold to add deployment support first.

Reference Files

For deeper details, consult these reference files in references/:

- cloud-run.md - Scaling defaults, Dockerfile, session types, networking

- agent-runtime.md - deploy.py CLI, AdkApp pattern, Terraform resource, deployment metadata, CI/CD differences

- gke.md - GKE Autopilot cluster, Kubernetes manifests, Workload Identity, session types, networking

- terraform-patterns.md - Custom infrastructure, IAM, state management, importing resources

- batch-inference.md - BigQuery Remote Function trigger; for Pub/Sub / Eventarc see /google-agents-cli-adk-code

- cicd-pipeline.md - Full CI/CD pipeline setup, infra cicd flags, runner comparison, WIF auth, pipeline stages

- testing-deployed-agents.md - Testing instructions per deployment target, curl examples, load tests

Observability: See the /google-agents-cli-observability skill for Cloud Trace, prompt-response logging, BigQuery Analytics, and third-party integrations.