From 49d17536c2ee2ce68b4c1798c4d6c8905a04b200 Mon Sep 17 00:00:00 2001 From: chrischristiansen-glitch Date: Wed, 27 May 2026 23:27:27 +0200 Subject: [PATCH] chore(step1): remove duplicate GCPBestPractices.md (archived) --- docs/GCPBestPractices.md | 77 ---------------------------------------- 1 file changed, 77 deletions(-) delete mode 100644 docs/GCPBestPractices.md diff --git a/docs/GCPBestPractices.md b/docs/GCPBestPractices.md deleted file mode 100644 index 668059a..0000000 --- a/docs/GCPBestPractices.md +++ /dev/null @@ -1,77 +0,0 @@ -# GCP Best Practices — propane-will-491900-m5 - -## Platform context (2025–2026) -- **Vertex AI Agent Engine** has been rebranded as **Gemini Enterprise Agent Platform**. - Agent runtimes are fully managed serverless — no VM management required. -- **ADK (Agent Development Kit)** 2.0 is open-source, supports Python/TypeScript/Go/Java/Kotlin. - Agents run locally for dev, then deploy to Agent Runtime, Cloud Run, or GKE. -- Region: **us-central1** for all resources (low latency, widest feature availability). - -## Required APIs (enable once, idempotent) -``` -aiplatform.googleapis.com # Vertex AI / Gemini Agent Platform -storage.googleapis.com # Cloud Storage staging -cloudbilling.googleapis.com # Billing Budget API -cloudresourcemanager.googleapis.com -iam.googleapis.com -run.googleapis.com # If using Cloud Run as deploy target -monitoring.googleapis.com -logging.googleapis.com -cloudtrace.googleapis.com -secretmanager.googleapis.com -artifactregistry.googleapis.com -cloudbuild.googleapis.com -``` - -## ADK install -```bash -pip install google-adk>=2.0.0 google-cloud-aiplatform[adk,agent_engines]>=1.112.0 -gcloud components update -gcloud auth application-default login -``` - -## Deploy targets — decision matrix -| Target | Best for | Cost model | Auth | -|---|---|---|---| -| **Agent Runtime** (managed) | Production agents, Memory Bank, Sessions | Per vCPU-second + GiB-second | ADC / SA | -| **Cloud Run** | Custom containers, public API endpoints, lower ops | Pay-per-request, scales to 0 | ADC / SA | -| **GKE** | Complex multi-agent meshes, custom networking | Cluster uptime + node cost | Workload Identity | - -## ADK 2.0 — new in 2026 -- Graph workflows and collaborative agents (coordinator + sub-agents) -- **ADK Kotlin** — new language support -- `adk deploy cloud_run` and `adk deploy agent_engine` CLI commands -- Native MCP client and server support -- A2A (Agent-to-Agent) protocol support -- `SecretManagerClient` integration (requires ADK ≥ 1.29) - -## Four platform pillars (Gemini Enterprise Agent Platform) -| Pillar | Key features | -|---|---| -| **Build** | ADK 2.0, Agent Studio (visual designer), Agents CLI, 200+ models via Model Garden | -| **Scale** | Agent Runtime, Sessions, Memory Bank, Code Execution, multi-day workflows | -| **Govern** | Agent Identity, Agent Registry, Agent Gateway, Model Armor, Agent Security dashboard | -| **Optimize** | Agent Evaluation, Agent Optimizer (auto-clusters failures), Example Store, Observability | - -## Model landscape (May 2026) -| Model | Status | Recommended use | -|---|---|---| -| `gemini-2.5-flash` | GA | Balanced cost/quality — **recommended default** | -| `gemini-3-flash` | Public preview | Cheapest option for dev/test | -| `gemma-4` | GA (open-source) | Self-hosted / fine-tuning | -| ~~`gemini-1.5-*`~~ | **Discontinued** | Migrate immediately | -| ~~`claude-3.5-haiku`~~ | **Deprecated** (shutdown Jul 2026) | Migrate immediately | - -## agent-starter-pack (Google official) -```bash -uvx agent-starter-pack enhance # add CI/CD + eval + observability to existing agent -uvx agent-starter-pack create my-agent # scaffold from scratch -``` -Provides: CI/CD (Cloud Build), Evaluation, Observability, Terraform IaC out of the box. -GitHub: https://github.com/GoogleCloudPlatform/agent-starter-pack - -## Key constraints -- Never use GPU instances (A100/V100) unless business-critical. -- Default compute: `e2-micro` for background tasks, up to `e2-standard-4` for Colab. -- Agent Runtimes bill when deployed — always run `03-teardown.sh` at end of day. -- Cloud Storage buckets do NOT auto-delete — lifecycle rules are mandatory.