google-agents-cli-deploy

Deploy agents to Agent Runtime, Cloud Run, or GKE using agents-cli.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aki2022/skills --skill google-agents-cli-deploy-aki2022
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-agents-cli-deploy
Source: https://github.com/Aki2022/skills/tree/main/google-agents-cli-deploy
Command: npx skills add https://github.com/Aki2022/skills --skill google-agents-cli-deploy-aki2022

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deploying AI agents to Google Cloud involves coordinating Terraform, Docker, service accounts, secrets, and CI/CD pipelines, which is error-prone when done manually. This Skill guides the full deployment workflow through the agents-cli tool, covering target selection, sizing, secrets, rollback, and troubleshooting. ## Core Features & Use Cases - Multi-target deployment: Deploy agents to Agent Runtime, Cloud Run, or GKE with a decision matrix comparing scaling, networking, session state, and cost trade-offs. - CI/CD pipeline setup: Configure staging-to-production pipelines with GitHub Actions or Cloud Build using Workload Identity Federation authentication. - Production operations: Manage secrets via Secret Manager, size deployments (CPU, memory, concurrency), bind agents to Agent Gateways, and handle rollback and common 403/timeout failures. - Use Case: After building an ADK agent, ask the assistant to deploy it to Cloud Run with secrets configured, then set up a CI/CD pipeline that promotes builds from staging to production with manual approval. ## Quick Start Deploy my agent to Cloud Run in project my-gcp-project using agents-cli with min-instances set to 1.

Frequently Asked Questions about google-agents-cli-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an ADK agent to Cloud Run?

Run agents-cli deploy after scaffolding your project with a deployment target. Pass flags like --project, --region, --service-account, and --secrets to configure the deployment, and use --dry-run to preview the generated gcloud command.

Agent Runtime vs Cloud Run vs GKE for agent deployment?

Agent Runtime is a managed Vertex AI service with minimal ops and managed sessions. Cloud Run offers full networking control and VPC support. GKE provides complete Kubernetes control but requires the most expertise. All three are container-based.

Why does my Cloud Run deployment return 403 errors?

Cloud Run deploys with --no-allow-unauthenticated by default, so requests need an Authorization: Bearer header with an identity token from gcloud auth print-identity-token. Also verify the runtime service account has required IAM roles.

How do I fix Agent Runtime deploy timeouts?

Agent Runtime deployments take 5-10 minutes and continue server-side even if the command times out. Run agents-cli deploy --status to poll progress every 60 seconds until it reports completion or failure.

Can I set up CI/CD with GitLab instead of GitHub?

The agents-cli infra cicd command only supports GitHub via the gh CLI and Terraform github provider. For GitLab, use the scaffolded Terraform as a starting point, replace the github provider resources, and run terraform apply directly.

How do I pass API keys securely to a deployed agent?

Store keys in GCP Secret Manager and pass them at deploy time with agents-cli deploy --secrets using ENV_VAR=SECRET_ID or ENV_VAR=SECRET_ID:VERSION format. Grant secretmanager.secretAccessor to the app service account first.