gcp-deployments

name	gcp-deployments
description	Guide and workflow for GCP Deployments Reference. Use when you need GCP Deployments Reference.

GCP Deployments Reference

Project Information

• GCP Project: worldarchitecture-ai
• Region: us-central1

Deployed Services

Development Environment (mvp-site-app-dev)

• Service Name: mvp-site-app-dev
• URL: https://mvp-site-app-dev-i6xf2p72ka-uc.a.run.app/
• Current Revision: mvp-site-app-dev-00084-2t9
• Last Deployed: 2025-08-30 17:23:11
• Image SHA: sha256:6977cf297ece931d6ef2eb5e9849762780ceffc9992da46fd602ee60cf2b8c6d
• Status: ⚠️ Very outdated (3+ months behind main)

Stable/Production Environment (mvp-site-app-stable)

• Service Name: mvp-site-app-stable
• URL: https://mvp-site-app-stable-i6xf2p72ka-uc.a.run.app/
• Test URL: https://test---mvp-site-app-stable-i6xf2p72ka-uc.a.run.app
• Current Revision: mvp-site-app-stable-00055-bpr
• Last Deployed: 2025-11-12 01:02:59
• Image SHA: sha256:69879c67d6d16252585031b10067e64ee548e65f4ac8803d43e11ae5083751e0
• Git Commit: 2e881735d - "fix: remove default rate limits to prevent CSS/JS loading failures"
• Status: ✅ Working (10 commits behind main)

Staging Environment (mvp-site-app-staging)

• Status: ✅ Available via deploy.sh
• URL: https://mvp-site-app-staging-i6xf2p72ka-uc.a.run.app
• Purpose: Safe iteration environment for testing fixes without affecting dev/stable

Current Main Branch

• Latest Commit: 7809a215c - "Fix all rate limits - increase to sanity-check thresholds"
• Commits Ahead of Stable: 10 commits

Key Commits (Post-Stable Deployment)

1. 7809a215c - Fix all rate limits - increase to sanity-check thresholds (#2018)
2. ed4d1e959 - Clarify agent directives in processmsgs command (#2017)
3. cb779920b - Fix auth script path in secondo-cli.sh (#2013)
4. ff798af6d - Sync improvements from global ~/.claude configuration (#2012)
5. caf1d3124 - Revert gh CLI installation hooks (#2011)
6. 665b68556 - Add npm installation instructions to claude.md (#2002)
7. e95c5eb43 - fix: reduce max instances to 6 and fix deploy script gcloud flag (#2001)
8. cb77f0d14 - Clarify copilot slash command documentation (#2009)
9. 2fc3e1e73 - Set up hook method for GitHub CLI installation (#2003)
10. 12784dd69 - docs: add git submodule slash command path to CLAUDE.md (#1999)

CSS Issue History

Original Introduction (Sep 21, 2025 - Commit defc63897)

• Commit: defc63897 - "🚨 CRITICAL SECURITY FIXES: Production-ready security hardening"
• Purpose: Security hardening to prevent DoS/financial attacks
• Configuration Added:

  default_limits=["200 per day", "50 per hour", "10 per minute"]
  

• Unintended Consequence: 10/min limit applied to ALL routes including static CSS/JS

The Problem (Sep 21 - Nov 12, 2025)

• Root Cause: Aggressive default rate limits (10 per minute) blocked parallel browser requests for static assets
• Symptom: 429 errors when loading multiple CSS/JS files
• Impact: HTML error pages returned instead of CSS/JS, causing MIME type errors
• Duration: ~2 months of CSS loading issues in production

The Fix (Commit 2e881735d - Nov 11, 2025)

• Removed default_limits from Flask-Limiter configuration
• Static files and frontend routes completely unrate-limited
• Added explicit rate limits only to API routes needing protection
• Status: ✅ Deployed to stable, working correctly

Latest Enhancement (Commit 7809a215c - Nov 14, 2025)

• Increased rate limits to sanity-check thresholds
• Changed from restrictive limits to high thresholds (e.g., 30000/hour, 1000/min)
• Status: ⚠️ Not yet deployed to any environment

Quick Reference Commands

List All Services

gcloud run services list --platform managed --format="table(name,region,status)"

Get Service Details

# Dev environment
gcloud run services describe mvp-site-app-dev --region us-central1

# Stable environment
gcloud run services describe mvp-site-app-stable --region us-central1

Get Current Deployment Commit

# Find image SHA
gcloud run services describe mvp-site-app-stable --region us-central1 \
  --format="value(spec.containers[0].image)"

# List recent image tags
gcloud container images list-tags gcr.io/worldarchitecture-ai/mvp-site-app \
  --limit=20 --format="table(digest,tags,timestamp)"

Deploy to Environment

# From project root
./deploy.sh mvp_site dev      # Deploy to dev
./deploy.sh mvp_site staging  # Deploy to staging
./deploy.sh mvp_site stable   # Deploy to stable/production

# Or from mvp_site directory (note: no '.' needed when in app directory)
cd mvp_site
../deploy.sh dev      # Deploy to dev
../deploy.sh staging  # Deploy to staging
../deploy.sh stable   # Deploy to stable/production

Manual Staging Deployment (Advanced)

# Use deploy.sh for normal deployments (recommended)
# Manual deployment (if needed for debugging):
cd mvp_site
gcloud builds submit . --tag gcr.io/worldarchitecture-ai/mvp-site-app:staging
gcloud run deploy mvp-site-app-staging \
  --image gcr.io/worldarchitecture-ai/mvp-site-app:staging \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --memory=2Gi \
  --timeout=300s \
  --min-instances=1 \
  --max-instances=6 \
  --concurrency=10

Deployment Architecture

Git Commits
     ↓
Cloud Build (automatic on deploy.sh)
     ↓
Container Registry (gcr.io/worldarchitecture-ai/mvp-site-app)
     ↓
Cloud Run Services
     ├── mvp-site-app-dev (outdated - Aug 30)
     ├── mvp-site-app-staging (✅ available - latest main)
     └── mvp-site-app-stable (production - 10 commits behind)

Notes

• Dev environment is significantly outdated (Aug 30 vs current Nov 14)
• Stable is 10 commits behind main branch
• Staging environment (mvp-site-app-staging) is now available for safe iteration
• CSS loading issues were fixed in commit 2e881735d (deployed to stable and staging)
• Latest rate limit improvements in 7809a215c deployed to staging, not yet on stable