google-agents-cli-deploy
Installation
Summary
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 deploywith 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
SKILL.md
ADK Deployment Guide
Requires:
agents-cli(uv tool install google-agents-cli) — install uv first if needed.
Prefer using the
agents-clicommands throughout this guide — they wrap Terraform, Docker, and deployment into a tested pipeline. If your project isn't scaffolded yet, see/google-agents-cli-scaffoldto add deployment support first.
Reference Files
For deeper details, consult these reference files in references/:
cloud-run.md— Scaling defaults, Dockerfile, session types, networkingagent-runtime.md— deploy.py CLI, AdkApp pattern, Terraform resource, deployment metadata, CI/CD differencesgke.md— GKE Autopilot cluster, Kubernetes manifests, Workload Identity, session types, networkingterraform-patterns.md— Custom infrastructure, IAM, state management, importing resourcesbatch-inference.md— BigQuery Remote Function trigger; for Pub/Sub / Eventarc see/google-agents-cli-adk-codecicd-pipeline.md— Full CI/CD pipeline setup,infra cicdflags, runner comparison, WIF auth, pipeline stagestesting-deployed-agents.md— Testing instructions per deployment target, curl examples, load tests
Observability: See the
/google-agents-cli-observabilityskill for Cloud Trace, prompt-response logging, BigQuery Analytics, and third-party integrations.