Google Agents CLI Deploy
Should be used when the user wants to "deploy an agent", "deploy my ADK agent", "set up...
Install
npx skills add google/agents-cli --skill google-agents-cli-deploy -g -a claude-code -y- Repository
- google/agents-cli6.3k
- Category
- AI and agents
- Updated
- 8d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
This skill should be used when the user wants to "deploy an agent", "deploy my ADK agent", "set up CI/CD", "configure secrets", "troubleshoot a deployment", or needs guidance on Agent Runtime, Cloud Run, or GKE deployment targets, or binding an agent to an Agent Gateway. Covers deployment workflows, service accounts, rollback, and production infrastructure. Applies to any framework agents-cli deploys (ADK, LangChain, ...). Part of the agents-cli skills suite. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), evaluation (use google-agents-cli-eval), or project scaffolding (use google-agents-cli-scaffold).
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, container-based deploy, unified FastAPI app, the/apipassthrough, 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 on ADK 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 testscmek.md, Customer-managed encryption keys on Agent Runtime in Gemini platform: key grants,deploy --keyfor dev, Terraform edits for staging/prod
Observability: See the
/google-agents-cli-observabilityskill for Cloud Trace, prompt-response logging, BigQuery Analytics, and third-party integrations.
Deployment Target Decision Matrix
Choose the right deployment target based on your requirements:
