# Google Agents CLI Deploy

Should be used when the user wants to "deploy an agent", "deploy my ADK agent", "set up...

- Repository: https://github.com/google/agents-cli (6276 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/agents-cli --skill google-agents-cli-deploy -g -a claude-code -y`
Codex: `npx skills add google/agents-cli --skill google-agents-cli-deploy -g -a codex -y`
Cursor: `npx skills add google/agents-cli --skill google-agents-cli-deploy -g -a cursor -y`
Gemini CLI: `npx skills add google/agents-cli --skill google-agents-cli-deploy -g -a gemini-cli -y`

## Description

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).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Deployment Guide

> **Requires:** `agents-cli` (`uv tool install google-agents-cli`), [install uv](https://docs.astral.sh/uv/getting-started/installation/index.md) 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 on ADK 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
- **`cmek.md`**, Customer-managed encryption keys on Agent Runtime in Gemini platform: key grants, `deploy --key` for dev, Terraform edits for staging/prod

> **Observability:** See the `/google-agents-cli-observability` skill 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:

The rest: https://github.com/google/agents-cli/blob/HEAD/skills/google-agents-cli-deploy/SKILL.md