Skip to main content

Google Cloud

Deploy agentgateway on Google Cloud Platform

Run agentgateway on GCP to leverage Vertex AI, GKE, and Google Cloud services.

Deployment options

Google Kubernetes Engine (GKE)

For GKE deployments, use Agentgateway on Kubernetes which provides native Kubernetes Gateway API support, dynamic configuration, and MCP service discovery.

Deploy on GKE

Cloud Run

Run agentgateway as a serverless container on Cloud Run.

gcloud run deploy agentgateway \
--image cr.agentgateway.dev/agentgateway:latest \
--port 3000 \
--set-env-vars "GOOGLE_CLOUD_PROJECT=my-project" \
--service-account [email protected] \
--allow-unauthenticated

GCP integrations

IntegrationPurpose
Vertex AIAccess Gemini and other models
Google GeminiDirect Gemini API access
GCP Secret ManagerSecure API key storage
Cloud Load BalancingGlobal load balancing with SSL
Cloud TraceDistributed tracing
Cloud MonitoringMetrics and alerting

IAM permissions

Create a service account with these roles:

# Create service account
gcloud iam service-accounts create agentgateway \
--display-name "agentgateway"

# Grant Vertex AI access
gcloud projects add-iam-policy-binding my-project \
--member "serviceAccount:[email protected]" \
--role "roles/aiplatform.user"

# Grant Secret Manager access
gcloud projects add-iam-policy-binding my-project \
--member "serviceAccount:[email protected]" \
--role "roles/secretmanager.secretAccessor"

Learn more