Recipe

Deploy Meridian on GCP Cloud Run

Cloud Run is Google's fully managed serverless container platform. It scales from zero, bills per-request, and runs any OCI image — making it a natural fit for Meridian's stateless API tier.

Prerequisites

  • Google Cloud SDK installed and authenticated
  • Docker image of Meridian pushed to Artifact Registry
  • Cloud Run Admin API enabled in your project

Step 1 — Build and push

gcloud builds submit --tag gcr.io/PROJECT/meridian:latest

Step 2 — Deploy the service

gcloud run deploy meridian \
  --image gcr.io/PROJECT/meridian:latest \
  --region us-central1 \
  --allow-unauthenticated \
  --memory 512Mi \
  --cpu 1 \
  --min-instances 0 \
  --max-instances 10

Step 3 — Wire the domain

Cloud Run issues a .run.app URL automatically. Map your custom domain via Cloud Run Domain Mappings and update DNS with the provided CNAME record.

Pro tip: Set concurrency to 1 if Meridian performs CPU-bound work per request. Cloud Run's default of 80 concurrent requests suits I/O-bound workloads best.