google-agents-cli-deploy

SKILL.md

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 — container-based deploy, unified FastAPI app, the /api passthrough, 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.