google-cloud-solution-guided-gke-ai-migration

Migrates existing AI inference workloads to self-hosted GKE inference using gcloud and kubectl.

19.1k|1.5k|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/google/skills --skill google-cloud-solution-guided-gke-ai-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-cloud-solution-guided-gke-ai-migration
Source: https://github.com/google/skills/tree/main/skills/cloud/google-cloud-solution-guided-gke-ai-migration
Command: npx skills add https://github.com/google/skills --skill google-cloud-solution-guided-gke-ai-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Moving an existing AI inference workload from Cloud Run, the Gemini API, or Gemini Enterprise Agent Platform to self-hosted inference on Google Kubernetes Engine involves hardware sizing, model staging, manifest authoring, and traffic cutover decisions that are easy to get wrong. This Skill guides an agent through a structured 4-phase migration workflow so nothing is missed.

Core Features & Use Cases

  • Guided 4-Phase Workflow: Discovery (inspect existing infrastructure with gcloud), Solution Design (VRAM sizing, accelerator and storage selection, manifest generation), Implementation (provisioning, model staging via cluster Jobs, kubectl deployment), and Validation and Cutover (health checks, inference tests, rollback readiness).
  • Opinionated Golden Path: Defaults to vLLM serving, Custom Compute Classes for accelerator obtainability, Cloud Storage FUSE or Managed Lustre for model weights, GKE Gateway API for routing, Workload Identity for security, and Managed Service for Prometheus for observability.
  • Deterministic VRAM Sizing: Calculates GPU memory requirements from parameter count, quantization, and KV cache overhead with a 20% safety margin to recommend the right accelerator (L4, A100, H100).
  • Use Case: A team running a Gemma 2 9B model on Cloud Run wants to cut inference costs by self-hosting on GKE. The Skill inspects the Cloud Run service, sizes an L4 node pool, stages weights to a GCS-backed PVC, generates vLLM and Gateway manifests, and walks through validation and traffic cutover.

Quick Start

Ask the agent to migrate my existing Cloud Run AI inference service to self-hosted vLLM inference on GKE.

Frequently Asked Questions about google-cloud-solution-guided-gke-ai-migration

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

FAQPage Schema
How do I migrate a Cloud Run AI workload to GKE inference?

Use a 4-phase workflow: discover the existing Cloud Run configuration with gcloud, design the target architecture with VRAM sizing and manifest generation, provision and deploy with kubectl, then validate inference and cut over traffic. The Skill generates vLLM, ComputeClass, storage, and Gateway manifests for you.

How do I calculate GPU VRAM requirements for vLLM model serving?

Multiply model parameters by 2 bytes, divide by the quantization factor (1 for FP16, 2 for INT8, 4 for INT4), add KV cache overhead, then apply a 1.2 safety margin. Compare the result against full card memory, such as 24 GB for an NVIDIA L4.

When should I use this migration skill instead of gke-inference?

Use this skill only when you have an existing AI workload on Cloud Run, Gemini API, Agent Platform, or a custom VM to migrate. For brand new GKE inference deployments with no existing workload, use the gke-inference skill instead.

Can I automate the GKE migration with Gemini Cloud Assist MCP?

This skill covers manual, architect-guided migration with gcloud and kubectl only. If you want automated infrastructure analysis or resource mutation, the workflow stops and directs you to the Gemini Cloud Assist MCP server documentation.

Why does my vLLM pod fail to mount Cloud Storage FUSE volumes?

The pod must carry the annotation gke-gcsfuse/volumes: "true" to inject the FUSE sidecar, and its Kubernetes ServiceAccount must be bound via Workload Identity to a Google service account with roles/storage.objectUser on the model bucket. Missing either causes mount or read failures.

Why is HPA autoscaling unreliable for vLLM inference workloads?

vLLM preallocates VRAM for KV caching, so CPU, memory, and GPU utilization metrics appear constantly high and mislead standard autoscalers. Scale on custom server metrics like vllm:num_requests_waiting or queue depth using GKE Custom Metrics or KEDA.