micsapp Deepgram Deploy Integration
Table of Contents
Overview
Deploy Deepgram integrations to various cloud platforms and container environments including Docker, Kubernetes, AWS Lambda, Google Cloud Run, and Vercel.
Prerequisites
- Production API key ready
- Infrastructure access configured
- Secret management in place
- Monitoring configured
Instructions
Step 1: Containerize with Docker
Build a multi-stage Dockerfile with non-root user, health checks, and production optimizations.
Step 2: Configure Orchestration
Choose deployment target: Docker Compose (simple), Kubernetes (scale), or serverless (event-driven).
Step 3: Manage Secrets
Use platform-native secret management (K8s Secrets, AWS Secrets Manager, GCP Secret Manager).
Step 4: Set Up Health Checks
Configure liveness and readiness probes against /health endpoint.
Step 5: Configure Auto-scaling
Set up HPA (Kubernetes) or managed scaling with CPU-based thresholds at 70% utilization.
Step 6: Create Deploy Script
Build environment-aware deploy script that runs build, tests, deploys, and smoke tests.
Output
- Dockerfile with multi-stage build and health checks
- Docker Compose or Kubernetes manifests
- Serverless configuration (Lambda/Cloud Run/Vercel)
- Deploy script with environment selection
- Auto-scaling configuration
Error Handling
| Issue | Cause | Resolution |
|---|---|---|
| Container fails to start | Missing secret or env var | Check secret mounts and env config |
| Health check failing | Service not ready | Increase initialDelaySeconds |
| OOM kills | Memory limit too low | Increase memory limit (512Mi minimum) |
| Connection refused | Wrong port mapping | Verify containerPort matches app |
Examples
Quick Docker Build & Run
set -euo pipefail
docker build -t deepgram-service .
docker run -p 3000:3000 -e DEEPGRAM_API_KEY=$DEEPGRAM_API_KEY deepgram-service # 3000: 3 seconds in ms
Deploy Script Usage
./scripts/deploy.sh staging # Deploy to staging
./scripts/deploy.sh production # Deploy to production
See detailed implementation for advanced patterns.