Build- und Bereitstellungslebenszyklus
Die vollständige Build-Pipeline vom Git-Push bis zur Live-Site: Klonen, Validierung, Upload zu R2, ISR-Revalidierung, Monitoring und Rollback-Strategien.
Jamdesk verarbeitet den gesamten Build- und Bereitstellungslebenszyklus automatisch. Pushen Sie zu GitHub, und Ihre Dokumentation ist innerhalb weniger Minuten live.
Die Screenshots zeigen die Benutzeroberfläche auf Englisch.
Build-Lebenszyklus
Build-Trigger
| Trigger | Funktionsweise | Anwendungsfall |
|---|---|---|
| Git Push | Webhook wird beim Push in den verbundenen Branch ausgelöst | Normale Entwicklung |
| Dashboard | Klicken Sie in den Projekteinstellungen auf „Rebuild“ | Aktualisierung nach Konfigurationsänderungen erzwingen |
Builds werden entprellt. Mehrere Commits innerhalb von 10 Sekunden werden zu einem einzigen Build zusammengefasst.
Was während eines Builds geschieht
Jamdesk klont Ihr Repository, validiert die Syntax von docs.json und MDX, kompiliert alles mit Suchindexierung zu optimiertem HTML und stellt es anschließend in Cloudflare R2 bereit. Die meisten Websites werden in 30–90 Sekunden erstellt.
Eine vollständige Aufschlüsselung der Pipeline mit Architekturdiagramm finden Sie unter Funktionsweise von Jamdesk.
Bereitstellungsstatus
Prüfen Sie den Build-Status im Dashboard:
| Status | Bedeutung |
|---|---|
| Building | Build wird ausgeführt |
| Deployed | Unter Ihrer Domain live |
| Failed | Build-Fehler – prüfen Sie die Logs |
| Queued | Wartet auf den vorherigen Build |
Der Abschnitt „Build History“ zeigt die letzten Bereitstellungen mit ihrem Status sowie die Möglichkeit, manuelle Builds auszulösen:
Manueller Build
Lösen Sie einen Build aus, ohne Änderungen zu pushen:
- Öffnen Sie Ihr Projekt im Dashboard.
- Öffnen Sie Settings.
- Klicken Sie auf Rebuild.
Verwenden Sie diese Funktion in folgenden Fällen:
- Aktualisieren von Umgebungsvariablen
- Beheben eines festgefahrenen Builds
- Aktualisieren nach Plattformänderungen
Umgebungsvariablen
Legen Sie Build-Variablen unter Settings → Environment fest:
ANALYTICS_ID=G-XXXXXXXXXX
API_BASE_URL=https://api.example.comDie Variablen sind während des Build-Prozesses verfügbar und können in Ihren Dateien docs.json oder MDX referenziert werden.
Build-Logs
Rufen Sie detaillierte Build-Logs zur Fehlerbehebung auf:
- Öffnen Sie Deployments in Ihrem Projekt.
- Klicken Sie auf eine bestimmte Bereitstellung.
- Rufen Sie das vollständige Build-Log auf.
Häufige Probleme werden in den Logs angezeigt:
- Ungültige MDX-Syntax
- Fehlende Bilder oder Assets
- Fehlerhafte interne Links
- Konfigurationsfehler
Rollbacks
Kehren Sie zu einer vorherigen Version zurück:
- Öffnen Sie Deployments.
- Suchen Sie die Bereitstellung, die Sie wiederherstellen möchten.
- Klicken Sie auf Rollback.
Die vorherige Version wird sofort live geschaltet, während ein neuer Build gestartet wird.
Branch-Bereitstellungen
Branch-Bereitstellungen sind in Pro-Tarifen verfügbar.
Sehen Sie sich Änderungen vor dem Mergen in der Vorschau an:
- Pushen Sie in einen Feature-Branch.
- Jamdesk erstellt eine Vorschau unter
branch-name.your-project.jamdesk.app. - Prüfen und mergen Sie die Änderungen, sobald sie bereit sind.