Skip to content

feat: add GKE as deployment target #833

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
allen-stephen merged 4 commits into from
Mar 2, 2026
Merged

feat: add GKE as deployment target #833

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
e3bafad
feat: initial changes to support gke deployment
allen-stephen Feb 19, 2026
ec9bde4
fix: resolve merge conflicts
allen-stephen Feb 19, 2026
f1d5b46
feat: consolidate deployment logic to be tf focused in deployment/
allen-stephen Feb 20, 2026
046568a
Merge branch 'main' into feat/gke-deployment
allen-stephen Mar 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
224 changes: 121 additions & 103 deletions .cloudbuild/terraform/build_triggers.tf
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,74 +128,91 @@ locals {
name = "adk-cloud_run-bq-analytics"
value = "adk,cloud_run,--bq-analytics"
},
{
name = "adk-gke"
value = "adk,gke"
},
{
name = "langgraph-gke"
value = "langgraph,gke"
},
{
name = "agentic_rag-gke-vertex_ai_search"
value = "agentic_rag,gke,--datastore,vertex_ai_search"
},
{
name = "adk_live-gke"
value = "adk_live,gke"
},
{
name = "adk_a2a-gke"
value = "adk_a2a,gke"
},
{
name = "adk_go-gke"
value = "adk_go,gke"
},
{
name = "adk_java-gke"
value = "adk_java,gke"
},
{
name = "adk_ts-gke"
value = "adk_ts,gke"
},
]

# Go-specific included files (different paths from Python)
# Only triggers when Go-specific template files change
# Go-specific included files - auto-derives deployment target from combo value
go_agent_testing_included_files = {
"adk_go-cloud_run" = [
# Go agent-specific files
for combo in local.agent_testing_combinations :
combo.name => [
"agent_starter_pack/agents/adk_go/**",
# Shared base template (affects all languages)
"agent_starter_pack/base_templates/_shared/**",
# Go base template
"agent_starter_pack/base_templates/go/**",
# Go deployment target (Cloud Run only for Go)
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/go/**",
# Common files
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/go/**",
"agent_starter_pack/cli/**",
"tests/integration/test_template_linting.py",
"tests/integration/test_templated_patterns.py",
"agent_starter_pack/resources/locks/**",
"pyproject.toml",
"uv.lock",
]
] if endswith(split(",", combo.value)[0], "_go")
}

# Java-specific included files (different paths from Python)
# Only triggers when Java-specific template files change
# Java-specific included files - auto-derives deployment target from combo value
java_agent_testing_included_files = {
"adk_java-cloud_run" = [
# Java agent-specific files
for combo in local.agent_testing_combinations :
combo.name => [
"agent_starter_pack/agents/adk_java/**",
# Shared base template (affects all languages)
"agent_starter_pack/base_templates/_shared/**",
# Java base template
"agent_starter_pack/base_templates/java/**",
# Java deployment target (Cloud Run only for Java)
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/java/**",
# Common files
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/java/**",
"agent_starter_pack/cli/**",
"tests/integration/test_template_linting.py",
"tests/integration/test_templated_patterns.py",
"pyproject.toml",
"uv.lock",
]
] if endswith(split(",", combo.value)[0], "_java")
}

# TypeScript-specific included files (different paths from Python)
# Only triggers when TypeScript-specific template files change
# TypeScript-specific included files - auto-derives deployment target from combo value
ts_agent_testing_included_files = {
"adk_ts-cloud_run" = [
# TypeScript agent-specific files
for combo in local.agent_testing_combinations :
combo.name => [
"agent_starter_pack/agents/adk_ts/**",
# Shared base template (affects all languages)
"agent_starter_pack/base_templates/_shared/**",
# TypeScript base template
"agent_starter_pack/base_templates/typescript/**",
# TypeScript deployment target (Cloud Run only for TypeScript)
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/typescript/**",
# Common files
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/typescript/**",
"agent_starter_pack/cli/**",
"tests/integration/test_template_linting.py",
"tests/integration/test_templated_patterns.py",
"agent_starter_pack/resources/locks/**",
"pyproject.toml",
"uv.lock",
]
] if endswith(split(",", combo.value)[0], "_ts")
}

agent_testing_included_files = {
Expand All @@ -213,11 +230,9 @@ locals {
# Shared and Python base templates only (not Go/Java/TypeScript)
"agent_starter_pack/base_templates/_shared/**",
"agent_starter_pack/base_templates/python/**",
# Python deployment targets only (not Go/Java/TypeScript)
"agent_starter_pack/deployment_targets/agent_engine/_shared/**",
"agent_starter_pack/deployment_targets/agent_engine/python/**",
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/python/**",
# Deployment target derived from combo value
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/python/**",
"tests/integration/test_template_linting.py",
"tests/integration/test_templated_patterns.py",
"agent_starter_pack/resources/locks/**",
Expand Down Expand Up @@ -295,74 +310,75 @@ locals {
name = "adk_ts-cloud_run"
value = "adk_ts,cloud_run"
},
{
name = "adk-gke"
value = "adk,gke"
},
{
name = "langgraph-gke"
value = "langgraph,gke"
},
{
name = "agentic_rag-gke-vertex_ai_search"
value = "agentic_rag,gke,--datastore,vertex_ai_search"
},
{
name = "adk_live-gke"
value = "adk_live,gke"
},
{
name = "adk_a2a-gke"
value = "adk_a2a,gke"
},
{
name = "adk_go-gke"
value = "adk_go,gke"
},
{
name = "adk_java-gke"
value = "adk_java,gke"
},
{
name = "adk_ts-gke"
value = "adk_ts,gke"
},
]

# Go-specific E2E included files
# Only triggers when Go-specific template files change
# Sentinel combos watch broad paths (cli, templates, pyproject.toml, etc.)
# All other combos only watch agent-specific + deployment-target-specific paths.
e2e_sentinel_combos = toset(["adk-agent_engine", "adk-cloud_run", "adk-gke"])

# Go-specific E2E included files - auto-derives deployment target from combo value
go_e2e_agent_deployment_included_files = {
"adk_go-cloud_run" = [
# Go agent-specific files
for combo in local.e2e_agent_deployment_combinations :
combo.name => [
"agent_starter_pack/agents/adk_go/**",
# Shared base template
"agent_starter_pack/base_templates/_shared/**",
# Go base template
"agent_starter_pack/base_templates/go/**",
# Go deployment target (Cloud Run only for Go)
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/go/**",
# Common files
"agent_starter_pack/cli/**",
"tests/cicd/test_e2e_deployment.py",
"agent_starter_pack/resources/locks/**",
"pyproject.toml",
"uv.lock",
".cloudbuild/**",
]
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/go/**",
] if endswith(split(",", combo.value)[0], "_go")
}

# Java-specific E2E included files
# Only triggers when Java-specific template files change
# Java-specific E2E included files - auto-derives deployment target from combo value
java_e2e_agent_deployment_included_files = {
"adk_java-cloud_run" = [
# Java agent-specific files
for combo in local.e2e_agent_deployment_combinations :
combo.name => [
"agent_starter_pack/agents/adk_java/**",
# Shared base template
"agent_starter_pack/base_templates/_shared/**",
# Java base template
"agent_starter_pack/base_templates/java/**",
# Java deployment target (Cloud Run only for Java)
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/java/**",
# Common files
"agent_starter_pack/cli/**",
"tests/cicd/test_e2e_deployment.py",
"pyproject.toml",
"uv.lock",
".cloudbuild/**",
]
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/java/**",
] if endswith(split(",", combo.value)[0], "_java")
}

# TypeScript-specific E2E included files
# Only triggers when TypeScript-specific template files change
# TypeScript-specific E2E included files - auto-derives deployment target from combo value
ts_e2e_agent_deployment_included_files = {
"adk_ts-cloud_run" = [
# TypeScript agent-specific files
for combo in local.e2e_agent_deployment_combinations :
combo.name => [
"agent_starter_pack/agents/adk_ts/**",
# Shared base template
"agent_starter_pack/base_templates/_shared/**",
# TypeScript base template
"agent_starter_pack/base_templates/typescript/**",
# TypeScript deployment target (Cloud Run only for TypeScript)
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/typescript/**",
# Common files
"agent_starter_pack/cli/**",
"tests/cicd/test_e2e_deployment.py",
"agent_starter_pack/resources/locks/**",
"pyproject.toml",
"uv.lock",
".cloudbuild/**",
]
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/typescript/**",
] if endswith(split(",", combo.value)[0], "_ts")
}

# Create a safe trigger name by replacing underscores with hyphens and dots with hyphens
Expand All @@ -385,33 +401,35 @@ locals {
# Cloud SQL is Python Cloud Run only
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/python/**",
"pyproject.toml",
] : substr(combo.name, 0, 11) == "agentic_rag" ? [
"agent_starter_pack/agents/agentic_rag/**/*",
"agent_starter_pack/agents/agentic_rag/data_ingestion/**/*",
"pyproject.toml",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/python/**",
] : substr(combo.name, 0, 8) == "adk_live" ? [
"agent_starter_pack/agents/adk_live/**/*",
"pyproject.toml",
] : [
# Only include files for the specific agent being tested
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/python/**",
] :
contains(local.e2e_sentinel_combos, combo.name) ? [
# Sentinel: broad paths - catches CLI, template, and dependency changes
"agent_starter_pack/agents/${split(",", combo.value)[0]}/**",
# Common files that affect all agents
"agent_starter_pack/cli/**",
# Shared and Python base templates only (not Go/Java/TypeScript)
"agent_starter_pack/base_templates/_shared/**",
"agent_starter_pack/base_templates/python/**",
"agent_starter_pack/agents/agentic_rag/data_ingestion/**",
# Python deployment targets only (not Go/Java/TypeScript)
"agent_starter_pack/deployment_targets/agent_engine/_shared/**",
"agent_starter_pack/deployment_targets/agent_engine/python/**",
"agent_starter_pack/deployment_targets/cloud_run/_shared/**",
"agent_starter_pack/deployment_targets/cloud_run/python/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/python/**",
"tests/cicd/test_e2e_deployment.py",
"agent_starter_pack/resources/locks/**",
"pyproject.toml",
"uv.lock",
".cloudbuild/**",
] : [
# Non-sentinel: only agent + deployment target paths
"agent_starter_pack/agents/${split(",", combo.value)[0]}/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/_shared/**",
"agent_starter_pack/deployment_targets/${split(",", combo.value)[1]}/python/**",
]
)
}
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Agent Starter Pack is a **template generator**, not a runtime framework. The CLI
Templates are processed in order, with later layers overriding earlier ones:

1. **Base Templates** (`agent_starter_pack/base_templates/<language>/`) - Core Jinja scaffolding (Python, Go, more coming)
2. **Deployment Targets** (`agent_starter_pack/deployment_targets/`) - Environment-specific overrides (cloud_run, agent_engine)
2. **Deployment Targets** (`agent_starter_pack/deployment_targets/`) - Environment-specific overrides (cloud_run, gke, agent_engine)
3. **Frontend Types** (`agent_starter_pack/frontends/`) - UI-specific files
4. **Agent Templates** (`agent_starter_pack/agents/*/`) - Agent-specific logic and configurations

Expand Down
16 changes: 13 additions & 3 deletions GEMINI.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Template processing follows this hierarchy (later layers override earlier ones):
| Layer | Directory | Purpose |
|-------|-----------|---------|
| 1. Base | `agent_starter_pack/base_templates/<language>/` | Core Jinja scaffolding (Python, Go, more coming) |
| 2. Deployment | `agent_starter_pack/deployment_targets/` | Environment overrides (cloud_run, agent_engine) |
| 2. Deployment | `agent_starter_pack/deployment_targets/` | Environment overrides (cloud_run, gke, agent_engine) |
| 3. Frontend | `agent_starter_pack/frontends/` | UI-specific files |
| 4. Agent | `agent_starter_pack/agents/*/` | Agent-specific logic and configurations |

Expand All @@ -54,7 +54,8 @@ agent_starter_pack/
│ └── go/ # Go project template
├── deployment_targets/ # Environment-specific overrides
│ ├── agent_engine/ # Agent Engine deployment
│ └── cloud_run/ # Cloud Run deployment
│ ├── cloud_run/ # Cloud Run deployment
│ └── gke/ # GKE Autopilot deployment
├── frontends/ # UI templates
└── cli/ # CLI implementation
├── commands/ # create, setup-cicd, enhance, etc.
Expand Down Expand Up @@ -368,7 +369,7 @@ some_code()
| Dimension | Options |
|-----------|---------|
| Agents | adk, adk_a2a, adk_go, adk_live, agentic_rag, langgraph |
| Deployments | cloud_run, agent_engine |
| Deployments | cloud_run, gke, agent_engine |
| Session types | in_memory, cloud_sql, agent_engine |
| Features | data_ingestion, frontend_type |

Expand Down Expand Up @@ -402,9 +403,15 @@ _TEST_AGENT_COMBINATION="adk,agent_engine" make lint-templated-agents
_TEST_AGENT_COMBINATION="adk_live,agent_engine" make lint-templated-agents
_TEST_AGENT_COMBINATION="langgraph,agent_engine" make lint-templated-agents

# GKE combinations (Python)
_TEST_AGENT_COMBINATION="adk,gke,--session-type,in_memory" make lint-templated-agents

# Go template testing
_TEST_AGENT_COMBINATION="adk_go,cloud_run" make lint-templated-agents

# Go template testing (GKE)
_TEST_AGENT_COMBINATION="adk_go,gke" make lint-templated-agents

# With session type variations
_TEST_AGENT_COMBINATION="adk,cloud_run,--session-type,agent_engine" make lint-templated-agents
```
Expand Down Expand Up @@ -663,6 +670,9 @@ uv run agent-starter-pack create test-$(date +%s) -p -s -y -d agent_engine --out
# Cloud Run with session type
uv run agent-starter-pack create test-$(date +%s) -p -s -y -d cloud_run --session-type in_memory --output-dir target

# GKE with session type
uv run agent-starter-pack create test-$(date +%s) -p -s -y -d gke --session-type in_memory --output-dir target

# Full project with CI/CD
uv run agent-starter-pack create test-$(date +%s) -s -y -d agent_engine --cicd-runner google_cloud_build --output-dir target
```
Expand Down
2 changes: 1 addition & 1 deletion agent_starter_pack/agents/adk/.template/templateconfig.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ example_question: "What's the weather in San Francisco?"
settings:
requires_data_ingestion: false
requires_session: true
deployment_targets: ["agent_engine", "cloud_run", "none"]
deployment_targets: ["agent_engine", "cloud_run", "gke", "none"]
extra_dependencies: ["google-adk>=1.15.0,<2.0.0"]
tags: ["adk"]
frontend_type: "None"
Expand Down
2 changes: 1 addition & 1 deletion agent_starter_pack/agents/adk_a2a/.template/templateconfig.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ description: "ReAct agent with A2A protocol [experimental]"
example_question: "What's the weather in San Francisco?"
settings:
requires_data_ingestion: false
deployment_targets: ["agent_engine", "cloud_run", "none"]
deployment_targets: ["agent_engine", "cloud_run", "gke", "none"]
extra_dependencies: ["google-adk>=1.16.0,<2.0.0", "a2a-sdk~=0.3.22", "nest-asyncio>=1.6.0,<2.0.0"]
tags: ["adk", "a2a"]
frontend_type: "None"
Loading