[Do not merge] Add initial Google Cloud Run code - still working through API-to-Engine comms.

.gitignore

@@ -0,0 +1 @@
+.env

cloud/google/cloud-run/.env.example

@@ -0,0 +1,64 @@
+# Copy this file to .env and fill in your values before running deploy.sh.
+# deploy.sh will source .env automatically if it exists.
+# Never commit .env to source control — it contains sensitive values.
+
+# ── Required ──────────────────────────────────────────────────────────────────
+
+# Google Cloud project ID
+GCP_PROJECT_ID=my-project-id
+
+# GCS bucket containing your Deepgram model files.
+# The bucket must already exist and be populated with model files before deploying.
+# Example bucket layout:
+#   gs://my-models-bucket/nova-2-general/
+#   gs://my-models-bucket/aura-asteria-en/
+DEEPGRAM_MODELS_BUCKET=my-models-bucket
+
+# Your Deepgram self-hosted API key.
+# Obtain from https://developers.deepgram.com/docs/self-hosted-self-service-tutorial
+DEEPGRAM_API_KEY=your_deepgram_api_key_here
+
+# ── Optional (defaults shown) ──────────────────────────────────────────────────
+
+# GCP region. Must support Cloud Run GPU (L4).
+# Supported regions: https://cloud.google.com/run/docs/configuring/services/gpu
+# GCP_REGION=us-central1
+
+# Container image tag for all Deepgram services.
+# IMAGE_TAG=release-260305
+
+# Name of the Secret Manager secret that stores your Deepgram API key.
+# The secret is created automatically by deploy.sh if it does not exist.
+# DEEPGRAM_API_KEY_SECRET=deepgram-api-key
+
+# Email of the service account created by deploy.sh for the Cloud Run services.
+# Override this if you want to use a pre-existing service account instead.
+# SERVICE_ACCOUNT_NAME=deepgram-cloud-run
+
+# Cloud Run Engine service name.
+# ENGINE_SERVICE_NAME=deepgram-engine
+
+# Cloud Run API service name.
+# API_SERVICE_NAME=deepgram-api
+
+# Container image registry. Defaults to quay.io/deepgram (public).
+# If your GCP project restricts images to Artifact Registry, set this to your
+# AR remote repo path (created with --remote-docker-repo=https://quay.io):
+# IMAGE_REGISTRY=us-central1-docker.pkg.dev/YOUR_PROJECT/deepgram-quay/deepgram
+
+# VPC network for Cloud Run Direct VPC Egress.
+# If VPC_NETWORK does not exist, deploy.sh creates it automatically.
+# Set both variables to use a pre-existing VPC and subnet instead.
+# VPC_NETWORK=deepgram-vpc
+# VPC_SUBNETWORK=deepgram-subnet
+# VPC_SUBNET_RANGE=10.8.0.0/24
+
+# Proxy-only subnet required by the internal HTTP load balancer.
+# Created automatically if it does not exist.
+# VPC_PROXY_SUBNET=deepgram-proxy-subnet
+# VPC_PROXY_SUBNET_RANGE=10.8.1.0/24
+
+# Internal HTTP load balancer placed in front of the Engine.
+# The API uses the LB's internal IP (HTTP, no TLS) to reach the Engine.
+# ENGINE_LB_NAME=deepgram-engine-lb
+# ENGINE_LB_IP_NAME=deepgram-engine-lb-ip