Jamdesk Documentation logo

Bereitstellungs-Workflow

Erfahren Sie, wie Jamdesk die Bereitstellung per GitHub-Push oder CLI automatisiert, inklusive Statusverfolgung, manuellem Neuaufbau, Build-Logs und Rollbacks.

Pushen Sie in Ihren verbundenen GitHub-Branch. Ihre Dokumentation ist innerhalb weniger Minuten live.

CLI-Bereitstellung

Stellen Sie direkt aus dem Terminal bereit, ohne zu GitHub zu pushen. Das eignet sich für schnelle Iterationen, zum Testen von Änderungen oder für Projekte ohne verbundenes Repository.

jamdesk login     # First time only
jamdesk deploy

Die CLI packt Ihre Dateien und lädt sie hoch. Dabei wird der Build-Fortschritt live angezeigt. Mit --detach wird der Build in die Warteschlange gestellt und die CLI sofort beendet.

CLI-Bereitstellungsleitfaden

Vollständige Pipeline-Anleitung, Build-Phasen, Fehlerreferenz und Fehlerbehebung

Der Workflow

1
Änderungen lokal vornehmen

Bearbeiten Sie Ihre MDX-Dateien und zeigen Sie eine Vorschau mit jamdesk dev an.

2
Zu GitHub pushen

Committen und pushen Sie in Ihren verbundenen Branch:

git add .
git commit -m "Update authentication docs"
git push
3
Automatische Bereitstellung

Jamdesk erkennt Ihren Push und baut Ihre Dokumentation. Anschließend wird sie im CDN bereitgestellt. Die meisten Seiten werden in 30 bis 90 Sekunden erstellt.

Bereitstellungsstatus

Prüfen Sie den Status im Dashboard unter Deployments:

StatusBedeutung
BuildingBuild läuft
DeployedUnter Ihrer Domain live
FailedBuild-Fehler – Logs prüfen
QueuedWartet auf den vorherigen Build

Manueller Build

Lösen Sie einen Neuaufbau aus, ohne zu pushen:

  1. Öffnen Sie Settings in Ihrem Projekt
  2. Klicken Sie auf Rebuild

Verwenden Sie dies nach Änderungen an Umgebungsvariablen oder um einen hängenden Build zu beheben.

Build-Logs

Öffnen Sie Deployments, klicken Sie auf eine Bereitstellung und lesen Sie die Logs. Häufige Fehler:

  • Ungültige MDX-Syntax
  • Fehlende Bilder
  • Defekte interne Links
  • Konfigurationsfehler

Rollbacks

  1. Öffnen Sie Deployments
  2. Suchen Sie die Bereitstellung, die wiederhergestellt werden soll
  3. Klicken Sie auf Rollback

Die vorherige Version wird sofort live geschaltet.

Wie geht es weiter?

CLI-Bereitstellung

Direkt aus dem Terminal bereitstellen, ohne zu GitHub zu pushen

Build- und Deploy-Zyklus

Detaillierter Build-Prozess, Auslöser und Umgebungsvariablen

Eigene Domains

docs.ihredomain.com einrichten

CLI-Übersicht

Lokale Tools und Befehle

Lokale Vorschau

Dokumentation vor dem Pushen ansehen