Docusaurus

Dies ist ein Beispiel dafür, wie du eine statische Website mit Docusaurus auf dem Statische-Seiten-Hosting Diensr von Kinsta aus einem GitHub-Repository einrichtest.

Docusaurus ist ein Generator für statische Websites, der sich auf die Erstellung von Dokumentations-Websites spezialisiert hat, die einfach zu erstellen sind und nur minimale Programmierkenntnisse erfordern, damit du sie sofort nutzen kannst. Weitere Informationen findest du auf der Docusaurus-Website.

Du kannst diese Schnellstartvorlage auch auf dem Anwendungs-Hosting von Kinsta ohne zusätzliche Konfiguration verwenden. Wenn du das Anwendungs-Hosting verwendest, kann der Start-Befehl für den Webprozess leer gelassen werden, da Kinsta den erforderlichen Befehl bei der ersten Bereitstellung automatisch erkennt.

Voraussetzungen

  • Die Schnellstartvorlagen von Kinsta werden in GitHub gespeichert und verwaltet. Daher benötigst du ein GitHub-Konto, um darauf zuzugreifen.
  • Um die Anwendung bereitzustellen, musst du ein MyKinsta-Konto erstellen.

Bereitstellen einer statischen Docusaurus-Site

  1. Melde dich bei GitHub an und erstelle ein neues Repository aus dieser Vorlage (Diese Vorlage verwenden > Neues Repository erstellen): Kinsta – Hello World – Docusaurus.
  2. Klicke in MyKinsta auf Statische Seiten > Seite hinzufügen > wähle GitHub, klicke auf Git-Anbieter verbinden > Autorisieren und melde dich bei deinem GitHub-Konto an.
  3. Wähle das Hello World Docusaurus Repository, klicke auf Weiter und gib in den Build-Einstellungen Folgendes ein:
    • Build-Befehl: npm run build
    • Node Version: 18.16.0
    • Verzeichnis veröffentlichen: build

Während des Deployment-Prozesses installiert Kinsta automatisch die in deiner package.json-Datei definierten Abhängigkeiten. Die Website ist verfügbar, sobald die Bereitstellung abgeschlossen ist und die Docusaurus-Standardseite unter der URL deiner Website geladen wird.

Docusaurus-Standardseite nach erfolgreicher Bereitstellung
Docusaurus-Standardseite nach erfolgreicher Bereitstellung

Lebenszyklus der Bereitstellung

Immer wenn eine Bereitstellung initiiert wird (durch das Erstellen einer Anwendung oder eine erneute Bereitstellung aufgrund eines eingehenden Commits), wird der Befehl npm build ausgeführt, gefolgt von dem Befehl npm start.

War dieser Artikel hilfreich?