← All docs

Google Cloud

Cloud Run + Vertex Gemini on your $150 credits, with a $100 kill switch that unlinks billing.

Google Cloud diagram

Flow

01Redeem credits
02Vertex (no API key)
03Cloud Run
04$100 kill switch

Credits and Vertex

Redeem the code on the billing account, link one project, leave GEMINI_API_KEY empty so AgentOS uses Vertex AI on that project (higher RPM/TPM, paid from the grant). Do not paste an AI Studio key on Cloud Run if you want Vertex quotas.

Kill switch at $100

Google has no hard cap. A budget at $100 (exclude credits = gross usage) publishes to Pub/Sub; a Cloud Function sets Cloud Run to zero instances and unlinks billing. Notifications can lag — the leftover $50 of $150 is the buffer. scripts/gcp-killswitch/ and docs/deploy-gcp.md.

Data and secrets

SQLite on Cloud Run disappears at scale-to-zero; use Firestore for a durable demo. SECRETS_MASTER_KEY in Secret Manager. Docker never copies .env.