Production Deployment

Always test in local Docker before deploying to Cloud Run!

cd apps/backend
./deploy-local-docker.sh

Wait for deployment (~30 seconds), then test:

# Health check
curl http://localhost:8090/health
 
# API docs
open http://localhost:8090/docs
 
# Test endpoints
curl http://localhost:8090/v1/leagues
 
# View logs
docker compose logs -f

Stop when done:

docker compose down

Navigate to project root and run deployment script:

cd /Users/kbselander/Developer/Notebook/mcp-servers/servers/mcp-server-altsportsleagues.ai/2.1-cloud-run-docker-mcp
 
./deploy-all.sh

Select: Option 2 (Backend only)

Wait: 4-8 minutes for build and deployment

Monitor: Watch the terminal for progress:

Building Docker image...
Pushing to Google Container Registry...
Deploying to Cloud Run...
✅ Deployment complete!

The script saves the URL to .backend-url:

cat .backend-url
# Example: https://altsportsleagues-backend-xxx-uc.a.run.app

In Google Cloud Console:

1. Go to Cloud Run Console (opens in a new tab)
2. Click service: altsportsleagues-backend
3. Click "Manage Custom Domains" tab
4. Click "Add Mapping"
5. Enter domain: api.altsportsleagues.ai
6. Select region: us-central1
7. Click Continue
8. Note the CNAME target: ghs.googlehosted.com
9. Status shows: "Pending Verification"

In Cloudflare:

1. Go to Cloudflare Dashboard (opens in a new tab)
2. Select domain: altsportsleagues.ai
3. Go to DNS → Records
4. Click Add Record
5. Configure:
   • Type: CNAME
   • Name: api
   • Target: ghs.googlehosted.com
   • Proxy status: ☁️ Proxied (orange cloud)
   • TTL: Auto
6. Click Save

Wait: 5-30 minutes for verification and SSL provisioning

Test the custom domain:

# Health check
curl https://api.altsportsleagues.ai/health | jq
 
# Expected: {"status":"healthy","timestamp":"..."}

# API root
curl https://api.altsportsleagues.ai/ | jq
 
# Expected: {"message":"AltSportsLeagues API","version":"1.0.0"}

# API docs
open https://api.altsportsleagues.ai/docs
 
# Expected: Swagger UI loads

# OpenAPI schema
curl https://api.altsportsleagues.ai/openapi.json | jq '.info'
 
# Expected: API metadata

Check logs if issues:

gcloud run services logs tail altsportsleagues-backend \
  --region us-central1 \
  --limit 50

Update clients/frontend/vercel.json:

{
  "version": 2,
  "buildCommand": "npm run build",
  "framework": "nextjs",
  "rewrites": [
    {
      "source": "/api/v1/:path*",
      "destination": "https://api.altsportsleagues.ai/v1/:path*"
    }
  ],
  "redirects": [
    {
      "source": "/documentation/:path*",
      "destination": "https://docs.altsportsleagues.ai/:path*",
      "permanent": false
    }
  ]
}

Key Changes:

• ✅ Use custom domain (api.altsportsleagues.ai)
• ✅ Clean backend path (/v1/* not /api/v1/*)
• ✅ Add redirect to docs site

In Vercel Dashboard:

1. Go to Vercel Dashboard (opens in a new tab)
2. Select your frontend project
3. Go to Settings → Environment Variables
4. Add variables for Production environment:

NEXT_PUBLIC_API_URL=https://api.altsportsleagues.ai
BACKEND_API_URL=https://api.altsportsleagues.ai
NEXT_PUBLIC_SITE_URL=https://altsportsleagues.ai

Click Save for each variable.

Option A: Via deployment script

cd /Users/kbselander/Developer/Notebook/mcp-servers/servers/mcp-server-altsportsleagues.ai/2.1-cloud-run-docker-mcp
 
./deploy-all.sh

Select: Option 3 (Frontend only)

Option B: Via Vercel CLI

cd clients/frontend
vercel --prod

Wait: 2-5 minutes for build and deployment

In Vercel Dashboard:

1. Go to your project → Settings → Domains
2. Click Add Domain
3. Enter: altsportsleagues.ai
4. Click Add
5. Vercel provides CNAME target (e.g., cname.vercel-dns.com)

In Cloudflare:

1. Go to DNS → Records
2. Add CNAME record:
   • Type: CNAME
   • Name: @ (or altsportsleagues.ai)
   • Target: cname.vercel-dns.com (from Vercel)
   • Proxy: ☁️ Proxied
3. Click Save

Optional - www subdomain:

• Name: www
• Target: cname.vercel-dns.com
• Proxy: ☁️ Proxied

Wait: 1-5 minutes for DNS propagation

# Test main site
open https://altsportsleagues.ai
 
# Test API proxy
curl https://altsportsleagues.ai/api/v1/leagues | jq
 
# Should return same data as direct backend:
curl https://api.altsportsleagues.ai/v1/leagues | jq

In Browser DevTools:

1. Open https://altsportsleagues.ai
2. Open DevTools (F12) → Network tab
3. Trigger API call (e.g., view leagues)
4. Check request:
   • URL shows: /api/v1/leagues (relative)
   • Status: 200 OK
   • No CORS errors in Console

cd apps/docs-site
 
# Install dependencies (if needed)
npm install
 
# Test build locally
npm run build
 
# Deploy to production
vercel --prod

Wait: 3-5 minutes for build

In Vercel Dashboard (separate project for docs):

1. Select the docs site project
2. Settings → Domains
3. Add: docs.altsportsleagues.ai
4. Note CNAME target from Vercel

In Cloudflare:

1. DNS → Add Record
2. Configure:
   • Type: CNAME
   • Name: docs
   • Target: cname.vercel-dns.com (from Vercel docs project)
   • Proxy: ☁️ Proxied
3. Save