Dit is een voorbeeld van het opzetten van een statische site met Docusaurus op Kinsta’s Applicatie of Statische Site Hosting diensten vanuit een GitHub repository.

Docusaurus is een statische sitegenerator die gespecialiseerd is in het maken van documentatiewebsites die eenvoudig te bouwen zijn met minimale codeerervaring, zodat je er meteen mee aan de slag kunt. Meer informatie is beschikbaar op de Docusaurus website.

Tijdens het deploymentproces installeert Kinsta automatisch dependencies die in je package.json bestand zijn gedefinieerd.

Statische Site Hosting

  1. Log in op GitHub en maak een nieuwe repository vanuit deze template (Gebruik deze template > Create a new repository): Kinsta – Hello World – Docusaurus.
  2. Voeg in MyKinsta een statische site toe met de Hello World Docusaurus repository en de volgende Build instellingen:
    • Build commando: npm run build
    • Node versie: 18.16.0
    • Publish directory: build
  3. De site is beschikbaar zodra de build is voltooid en de Docusaurus-standaardpagina wordt geladen op de URL van de site.

Applicatie Hosting

  1. Log in op GitHub en maak een nieuwe repository aan vanuit deze template (gebruik deze template > maak een nieuwe repository): Kinsta – Hello World – Docusaurus
  2. Voeg in MyKinsta een applicatie toe met de Hello World Docusaurus repository. Het Start commando kan leeg gelaten worden voor het webproces, omdat Kinsta automatisch het vereiste commando detecteert tijdens de eerste deployment.
  3. De app is beschikbaar zodra de build is voltooid en de Docusaurus-standaardpagina wordt geladen op de URL van de applicatie.

Webserver instellen

Poort

Kinsta stelt automatisch de PORT omgevingsvariabele in. Je hoeft hem niet te definiëren of hard te coderen in de applicatie. Het serve pakket gebruikt automatisch de door Kinsta ingestelde poort.

Start commando

Wanneer je de applicatie inzet, maakt Kinsta automatisch een webproces aan met npm start als startcommando.

Deployment levenscyclus

Telkens als een deployment wordt gestart (door een applicatie te maken of opnieuw te deployen vanwege een inkomende commit), wordt het commando npm build uitgevoerd, gevolgd door het commando npm start.

Docusaurus standaardpagina

De app of site is beschikbaar zodra de build is voltooid en een standaard Docusaurus-pagina wordt geladen op de URL van de applicatie of de URL van de statische site.

Docusaurus standaardpagina na succesvol deployen.
Docusaurus standaardpagina na succesvol deployen.