adk-deploy-guide

Guide ADK agent deployment to Google Cloud with Agent Engine, Cloud Run, and GKE.

9|1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/hq-opensource/si-mapper --skill adk-deploy-guide-hq-opensource
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adk-deploy-guide
Source: https://github.com/hq-opensource/si-mapper/tree/main/.agents/skills/adk-deploy-guide
Command: npx skills add https://github.com/hq-opensource/si-mapper --skill adk-deploy-guide-hq-opensource

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Deploying ADK agents to Google Cloud can be complex and error-prone; this guide consolidates best practices for deploying Agent Engine, Cloud Run, and GKE, plus CI/CD pipelines, secrets management, observability, and production workflows.

Core Features & Use Cases

  • Comprehensive deployment instructions for Agent Engine, Cloud Run, and GKE.
  • CI/CD pipelines setup, production deployment workflows, and operational guidance.
  • Secrets management and observability recommendations for reliable production deployments.

Quick Start

Follow the guide to initialize the ADK deployment by scaffolding and deploying the Agent Engine, Cloud Run, and related components.

Frequently Asked Questions about adk-deploy-guide

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

FAQPage Schema
How do I deploy ADK agents to Google Cloud?

To deploy ADK agents to Google Cloud, you need a scaffolded project and Terraform-based infrastructure. The guide provides end-to-end instructions for initializing the ADK deployment across supported environments.

What's the best way to deploy ADK agents to Agent Engine or Cloud Run?

Deploying ADK agents to Agent Engine or Cloud Run requires using the ADK deployment tooling alongside Terraform. This guide outlines the specific production-ready workflows for each target environment.

Can I use GKE for ADK agent deployment instead of Cloud Run?

Yes, GKE is fully supported for ADK agent deployment alongside Cloud Run and Agent Engine. The guide consolidates best practices and deployment instructions for all three compute environments.

How do I manage secrets and observability for ADK production deployments?

Managing secrets and observability for ADK production deployments involves configuring specific operational guidelines provided in the guide. It ensures reliable deployments through dedicated secrets management and monitoring recommendations.

Do I need Terraform to set up CI/CD pipelines for ADK agents?

Terraform-based infrastructure is required to scaffold the project before setting up CI/CD pipelines for ADK agents. The guide covers integrating these pipelines into your production deployment workflows.

Why are my ADK agent deployments failing on Google Cloud?

Failed ADK agent deployments often stem from missing prerequisites like a properly scaffolded project or incomplete Terraform infrastructure. Following the consolidated best practices in this guide helps avoid common configuration errors.