feat: migrate to Vercel free deployment

Neil Munoz · Neil Munoz · commit bdbd785a766f · 2025-09-02T17:56:39.000+02:00
- Replace Railway with Vercel for free hosting
- Add vercel.json configuration for Python/FastAPI
- Create api/index.py as Vercel entry point
- Update GitHub Actions workflow for Vercel deployment
- Add vercel_setup.sh script for easy configuration
- Create comprehensive deployment guide
- Optimize requirements.txt for Vercel deployment
- Configure environment variables for production

Benefits:
- Free hosting with 100GB bandwidth/month
- Global edge network for fast responses
- Automatic HTTPS and custom domains
- Built-in CI/CD with GitHub integration
- Better Python support than Railway
diff --git a/.github/workflows/production-pipeline.yml b/.github/workflows/production-pipeline.yml
@@ -12,6 +12,11 @@ on:
         required: false
         default: false
         type: boolean
+      deploy_to_vercel:
+        description: 'Deploy to Vercel (only for testing)'
+        required: false
+        default: false
+        type: boolean
 
 # Add permissions for CodeQL/SARIF upload
 permissions:
@@ -313,11 +318,11 @@ jobs:
   # ============================================================================
   # 6. RAILWAY DEPLOYMENT (Production Only)
   # ============================================================================
-  railway-deployment:
-    name: 🚀 Railway Production Deployment
+  vercel-deployment:
+    name: 🚀 Vercel Production Deployment
     runs-on: ubuntu-latest
     needs: [pre-deployment]
-    if: (github.ref == 'refs/heads/main' && github.event_name == 'push') || github.event.inputs.deploy_to_railway == 'true'
+    if: (github.ref == 'refs/heads/main' && github.event_name == 'push') || github.event.inputs.deploy_to_vercel == 'true'
     environment:
       name: production
       url: ${{ steps.deploy.outputs.url }}
@@ -326,105 +331,98 @@ jobs:
       - name: 📥 Checkout Repository
         uses: actions/checkout@v4
 
-      - name: 🐍 Setup Node.js for Railway CLI
+      - name: 🟢 Setup Node.js for Vercel CLI
         uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
 
-      - name: 🚂 Deploy to Railway
+      - name: 🚀 Deploy to Vercel
         id: deploy
         env:
-          RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
         run: |
-          echo "🚀 Starting Railway deployment process..."
-
-          # Method 1: Try npm installation first (most reliable)
-          echo "📦 Installing Railway CLI via npm..."
-          npm install -g @railway/cli || {
-            echo "❌ npm installation failed, trying alternative method..."
-
-            # Method 2: Download from GitHub releases with better error handling
-            echo "⬇️ Downloading Railway CLI from GitHub releases..."
-            RAILWAY_VERSION="v3.17.1"
-
-            # Try multiple download URLs
-            if curl -L -o railway "https://github.com/railwayapp/cli/releases/download/${RAILWAY_VERSION}/railway-linux-amd64"; then
-              echo "✅ Download successful"
-            elif curl -L -o railway "https://github.com/railwayapp/cli/releases/download/${RAILWAY_VERSION}/railway_linux_amd64"; then
-              echo "✅ Download successful (alternative URL)"
-            else
-              echo "❌ All download methods failed"
-              exit 1
-            fi
-
-            # Verify the downloaded file
-            if [ ! -f "railway" ]; then
-              echo "❌ Downloaded file not found"
-              exit 1
-            fi
-
-            # Check if file is a valid binary (not HTML error page)
-            if head -n 1 railway | grep -q "Not Found\|404\|HTML"; then
-              echo "❌ Downloaded file appears to be an error page, not a binary"
-              cat railway
-              exit 1
-            fi
+          echo "🚀 Starting Vercel deployment process..."
 
-            # Make executable and move to PATH
-            chmod +x railway
-            sudo mv railway /usr/local/bin/railway
-          }
+          # Install Vercel CLI
+          echo "📦 Installing Vercel CLI..."
+          npm install -g vercel
 
           # Verify installation
-          echo "🔍 Verifying Railway CLI installation..."
-          if ! command -v railway &> /dev/null; then
-            echo "❌ Railway CLI not found in PATH"
-            which railway || echo "railway command not found"
-            exit 1
-          fi
-
-          echo "✅ Railway CLI installed successfully"
-          railway --version || railway version
+          echo "🔍 Verifying Vercel CLI installation..."
+          vercel --version
 
-          # Authenticate with Railway
-          echo "🔐 Authenticating with Railway..."
-          if [ -z "$RAILWAY_TOKEN" ]; then
-            echo "❌ RAILWAY_TOKEN environment variable is not set"
+          # Authenticate with Vercel
+          echo "🔐 Authenticating with Vercel..."
+          if [ -z "$VERCEL_TOKEN" ]; then
+            echo "❌ VERCEL_TOKEN environment variable is not set"
             exit 1
           fi
 
           # Login with token
-          if ! railway login --token "$RAILWAY_TOKEN"; then
-            echo "❌ Railway authentication failed"
+          if ! vercel login --token "$VERCEL_TOKEN"; then
+            echo "❌ Vercel authentication failed"
             exit 1
           fi
 
-          echo "✅ Successfully authenticated with Railway"
+          echo "✅ Successfully authenticated with Vercel"
 
-          # Deploy to Railway
-          echo "🚀 Deploying application to Railway..."
-          if ! railway up --detach; then
-            echo "❌ Railway deployment failed"
-            railway status || echo "Could not get deployment status"
+          # Link to project (if needed)
+          echo "🔗 Linking to Vercel project..."
+          if [ -n "$VERCEL_ORG_ID" ] && [ -n "$VERCEL_PROJECT_ID" ]; then
+            vercel link --project "$VERCEL_PROJECT_ID" --org "$VERCEL_ORG_ID" --yes || true
+          fi
+
+          # Deploy to Vercel
+          echo "🚀 Deploying application to Vercel..."
+          if ! vercel --prod --yes; then
+            echo "❌ Vercel deployment failed"
             exit 1
           fi
 
-          echo "✅ Railway deployment initiated successfully!"
+          echo "✅ Vercel deployment initiated successfully!"
 
           # Get deployment URL
           echo "🔗 Getting deployment URL..."
           sleep 10
-          railway status || echo "Could not get deployment status"
+          DEPLOYMENT_URL=$(vercel ls | grep "https://" | head -n 1 | awk '{print $2}')
+          if [ -n "$DEPLOYMENT_URL" ]; then
+            echo "url=$DEPLOYMENT_URL" >> $GITHUB_OUTPUT
+            echo "✅ Deployment URL: $DEPLOYMENT_URL"
+          else
+            echo "⚠️ Could not retrieve deployment URL"
+          fi
 
       - name: 🏥 Post-Deployment Health Check
         run: |
           echo "⏳ Waiting for deployment to stabilize..."
           sleep 60
 
-          echo "🔍 Checking Railway deployment status..."
-          railway status || echo "⚠️ Could not retrieve deployment status"
+          # Try to get the deployment URL from Vercel
+          DEPLOYMENT_URL=$(vercel ls 2>/dev/null | grep "https://" | head -n 1 | awk '{print $2}' || echo "")
+
+          if [ -n "$DEPLOYMENT_URL" ]; then
+            echo "🔍 Checking Vercel deployment health at: $DEPLOYMENT_URL"
+
+            # Health check
+            if curl -f -s "$DEPLOYMENT_URL/api/health" > /dev/null 2>&1; then
+              echo "✅ Health check passed!"
+            else
+              echo "⚠️ Health check failed, but deployment may still be initializing"
+            fi
+
+            # Check main application
+            if curl -f -s "$DEPLOYMENT_URL/" > /dev/null 2>&1; then
+              echo "✅ Main application accessible"
+            else
+              echo "⚠️ Main application not yet accessible"
+            fi
+          else
+            echo "⚠️ Could not determine deployment URL for health checks"
+          fi
 
-          echo "✅ Railway deployment process completed!"
+          echo "✅ Vercel deployment process completed!"
 
       - name: 📢 Deployment Notification
         if: always()
@@ -442,7 +440,7 @@ jobs:
   post-deployment-monitoring:
     name: 📊 Post-Deployment Monitoring
     runs-on: ubuntu-latest
-    needs: [railway-deployment]
+    needs: [vercel-deployment]
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     
     steps:
@@ -489,7 +487,7 @@ jobs:
           echo "  ✅ Docker Security & Build Validation"
           echo "  ✅ Frontend Asset Optimization"
           echo "  ✅ Pre-Deployment Validation"
-          echo "  ✅ Railway Production Deployment"
+          echo "  ✅ Vercel Production Deployment"
           echo "  ✅ Post-Deployment Monitoring"
           echo ""
           echo "🚀 Banking application successfully deployed to Railway!"
diff --git a/VERCEL_DEPLOYMENT_GUIDE.md b/VERCEL_DEPLOYMENT_GUIDE.md
diff --git a/api/index.py b/api/index.py
@@ -0,0 +1,35 @@
+import os
+import sys
+from pathlib import Path
+
+# Add the project root to Python path
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+# Set environment variables for production
+os.environ.setdefault('ENVIRONMENT', 'production')
+os.environ.setdefault('SECRET_KEY', os.environ.get('SECRET_KEY', 'vercel-production-key-change-in-env'))
+
+# Import the FastAPI app
+from app.main import app
+
+# Vercel expects the app to be named 'app'
+# If your FastAPI app is named differently, change this
+app = app
+
+# Optional: Add Vercel-specific middleware or configuration
+@app.middleware("http")
+async def add_vercel_headers(request, call_next):
+    response = await call_next(request)
+    response.headers["X-Vercel-Cache"] = "MISS"
+    return response
+
+# Health check endpoint for Vercel
+@app.get("/api/health")
+async def health_check():
+    return {"status": "healthy", "platform": "vercel", "app": "NeuroBank FastAPI"}
+
+# For local development
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=int(os.environ.get("PORT", 8000)))
diff --git a/api/requirements.txt b/api/requirements.txt
@@ -0,0 +1,11 @@
+fastapi==0.115.6
+uvicorn[standard]==0.29.0
+pydantic==2.7.0
+pydantic-settings==2.2.1
+python-dotenv==1.0.1
+loguru==0.7.2
+jinja2==3.1.6
+python-multipart==0.0.18
+requests==2.32.4
+starlette==0.41.3
+python-json-logger==2.0.7
diff --git a/vercel.json b/vercel.json
@@ -0,0 +1,29 @@
+{
+  "version": 2,
+  "builds": [
+    {
+      "src": "api/index.py",
+      "use": "@vercel/python",
+      "config": {
+        "maxLambdaSize": "50mb"
+      }
+    }
+  ],
+  "routes": [
+    {
+      "src": "/(.*)",
+      "dest": "api/index.py"
+    }
+  ],
+  "functions": {
+    "api/index.py": {
+      "maxDuration": 30
+    }
+  },
+  "env": {
+    "ENVIRONMENT": "production"
+  },
+  "regions": [
+    "iad1"
+  ]
+}
diff --git a/vercel_setup.sh b/vercel_setup.sh
