Build- und Deploy-Zyklus
Die vollständige Build-Pipeline von git push bis zur Live-Seite: Klonen, Validieren, Upload nach R2, ISR-Revalidierung, Monitoring und Rollback-Strategien.
Push zu GitHub. Jamdesk baut und veröffentlicht deine Dokumentation innerhalb weniger Minuten.
Die Screenshots zeigen die Benutzeroberfläche auf Englisch.
Build-Zyklus
Build-Auslöser
| Auslöser | So funktioniert es | Anwendungsfall |
|---|---|---|
| Git Push | Webhook wird beim Push auf den verbundenen Branch ausgelöst | Normale Entwicklung |
| Dashboard | Klicke in den Projekteinstellungen auf „Rebuild“ | Erzwungene Aktualisierung nach Konfigurationsänderungen |
Builds werden entprellt. Commits, die innerhalb von 10 Sekunden aufeinander folgen, landen in einem einzigen Build.
Was während eines Builds passiert
Jamdesk klont dein Repository und validiert docs.json sowie die MDX-Syntax. Es kompiliert die Seiten zu HTML mit einem Suchindex. Das Ergebnis wird nach Cloudflare R2 deployt. Die meisten Seiten werden in 30–90 Sekunden gebaut.
Die vollständige Pipeline und das Architekturdiagramm findest du unter So funktioniert Jamdesk.
Bereitstellungsstatus
Das Dashboard zeigt für jeden Build einen dieser Status an:
| Status | Bedeutung |
|---|---|
| Building | Build läuft |
| Deployed | Live unter deiner Domain |
| Failed | Build-Fehler – Logs prüfen |
| Queued | Wartet auf den vorherigen Build |
Der Abschnitt Build History listet die letzten Deployments mit ihrem Status auf. Von dort aus kannst du einen manuellen Rebuild auslösen:
Manueller Build
Löse einen Rebuild aus, ohne Änderungen zu pushen:
- Öffne dein Projekt im Dashboard
- Öffne Settings
- Klicke auf Rebuild
Verwende dies, wenn:
- ein hängender Build behoben werden soll
- nach Plattform-Updates aktualisiert werden soll
Build-Logs
- Gehe in deinem Projekt zu Deployments
- Klicke auf ein Deployment
- Lies das vollständige Build-Log
Häufige Fehler im Log:
- Ungültige MDX-Syntax
- Fehlende Bilder oder Assets
- Defekte interne Links
- Konfigurationsfehler
Rollbacks
- Gehe zu Deployments
- Suche das Deployment, das du wiederherstellen möchtest
- Klicke auf Rollback
Die vorherige Version geht sofort live. Gleichzeitig startet ein neuer Build.
Branch-Bereitstellungen
Branch-Deployments sind in den Pro-Tarifen verfügbar.
Änderungen vor dem Merge in der Vorschau prüfen:
- Push auf einen Feature-Branch
- Jamdesk erstellt eine Vorschau unter
branch-name.your-project.jamdesk.app - Prüfen und mergen, sobald es bereit ist