Skip to content

🚀 Cloudflare Deployment Guide

🔐 SECURITY FIRST - G100 KONZEPT Phase

VOR JEDEM DEPLOYMENT: Cloudflare Access mit One-Time PIN einrichten!

📘 Setup Guide: Security Cloudflare Access

Warum critical?

  • G100 ist KONZEPT in Early Stage
  • NDA-pflichtige Business-Logik enthalten
  • Nur invited Team & Investors sollen Zugriff haben
  • Compliance & Audit Logs erforderlich

Was geschützt wird:

  • ✅ MkDocs Documentation (docs.g100.dev)
  • ✅ API Staging (api-staging.g100.dev)
  • ✅ XPipe MCP Server (xpipe.g100.dev)

5 Minuten Setup:

  1. Zero Trust aktivieren
  2. One-Time PIN Provider enable
  3. Access Application erstellen
  4. Email Whitelist pflegen
  5. Deployment starten!

📦 MkDocs auf Cloudflare Pages

Step 1: GitHub Repository vorbereiten

cd /Users/gm/Documents/Visual_Code_SHARED/ContractPlattformWhiteLabel/docs

# Git initialisieren (falls noch nicht geschehen)
git init
git add .
git commit -m "docs: Add G100 MEGA ECOSYSTEM documentation"

# GitHub Repository erstellen und pushen
# (Manuell auf GitHub: New Repository → ContractPlattform-Docs)
git remote add origin https://github.com/YOUR_USERNAME/ContractPlattform-Docs.git
git push -u origin main

Step 2: Cloudflare Pages erstellen

  1. Gehe zu Cloudflare Dashboard: 

    https://dash.cloudflare.com/edeaf72f08c3145711f257893d9ddab1/pages

  2. Click "Create a project"

  3. Connect to Git:

  4. Wähle "Connect to Git"
  5. Autorisiere GitHub

  6. Wähle Repository: ContractPlattform-Docs

  7. Build Configuration: 

    Framework preset:     None (Custom)
Build command:        mkdocs build
Build output directory: site
Root directory:       / (oder /docs falls Monorepo)

  8. Environment Variables: 

    PYTHON_VERSION = 3.11

  9. Click "Save and Deploy"

Step 3: Custom Domain (Optional)

Option A: Subdomain (Empfohlen für Dev) 

docs-dev.contractplattform.com

Option B: Cloudflare Workers Domain (kostenlos) 

contractplattform-docs.pages.dev

Konfiguration: 1. Pages Dashboard → Settings → Custom domains 2. Add custom domain: docs-dev.contractplattform.com 3. DNS wird automatisch konfiguriert

Step 4: Preview Deployments

Jeder Git Branch bekommt eine Preview URL: 

main branch:         https://contractplattform-docs.pages.dev
develop branch:      https://develop.contractplattform-docs.pages.dev
feature/g100 branch: https://feature-g100.contractplattform-docs.pages.dev

🔧 Troubleshooting

Build Failed?

Problem: Python dependencies nicht gefunden

Lösung: 

# requirements.txt erstellen
mkdocs>=1.5.0
mkdocs-material>=9.5.0
pymdown-extensions>=10.0

Problem: mkdocs.yml nicht gefunden

Lösung: Root directory auf /docs setzen (falls Monorepo)

✅ Deployment Checklist

  • [ ] GitHub Repository erstellt
  • [ ] Code gepusht
  • [ ] Cloudflare Pages Projekt erstellt
  • [ ] Build erfolgreich
  • [ ] Preview URL funktioniert
  • [ ] Custom Domain konfiguriert (optional)
  • [ ] SSL Zertifikat aktiv (automatisch)

📊 Deployment Status

Environment URL Status
Production https://docs.contractplattform.com 🔄 Pending
Preview (main) https://contractplattform-docs.pages.dev 🔄 Pending
Local http://localhost:8000 ✅ Running

🚀 Next: API Deployment

Siehe API_DEPLOYMENT.md für Cloudflare Workers Setup.