---

name: deploy description: "Use this sub-skill when deploying agents-cli projects to Agent Runtime, Cloud Run, or GKE; provisioning infrastructure; setting up CI/CD; running deployed smoke tests; or troubleshooting production deployment failures." metadata: disco-role: operating author: Google license: Apache-2.0 version: 1.3.1 requires: bins: - agents-cli install: "uv tool install google-agents-cli" disable-model-invocation: true license: Apache 2.0

Deployment and Infrastructure

Use this sub-skill inside the google-agents-cli repo skill. It is a router plus operating checklist; move into the bundled references for full command flags, schemas, and examples.

When to Use

• The user wants to deploy to Agent Runtime, Cloud Run, or GKE.
• The task mentions Terraform, CI/CD, Cloud Build, GitHub Actions, IAP, PSC, load tests, or remote run --url.
• You need to troubleshoot deployment target, IAM, network, timeout, or endpoint issues.

Workflow

1. Confirm target, project, region, credentials, IAM, cost, and whether Terraform/CI-CD is desired.
2. Use scaffold/enhance first if deployment files are missing.
3. Deploy with agents-cli deploy or provision infra with the documented infra commands.
4. Smoke-test the deployed URL with agents-cli run --url before publishing or load testing.

Read These References

• references/deploy-guide.md — read for deploy guide details.
• references/agent-runtime.md — read for agent runtime details.
• references/batch-inference.md — read for batch inference details.
• references/cicd-pipeline.md — read for cicd pipeline details.
• references/cloud-run.md — read for cloud run details.
• references/gke.md — read for gke details.
• references/terraform-patterns.md — read for terraform patterns details.
• references/testing-deployed-agents.md — read for testing deployed agents details.

Verification and Safety

Safe checks: agents-cli deploy --help; live deploy/infra/load tests need cloud credentials and cost approval.

Boundaries

• Does not publish to Gemini Enterprise; use publish after deployment.
• Does not execute cloud/Terraform/GitHub mutations without explicit approval.

Related Sub-Skills

• ../workflow/SKILL.md — lifecycle routing and approval gates.
• ../scaffold/SKILL.md — project creation/enhancement.
• ../adk-code/SKILL.md — ADK Python implementation patterns.
• ../eval/SKILL.md — evaluation loops and metrics.
• ../deploy/SKILL.md — deployment and infrastructure.
• ../publish/SKILL.md — Gemini Enterprise registration.
• ../observability/SKILL.md — logging, tracing, and analytics.