Dit is een voorbeeld van het opzetten van een statische site met Docusaurus op Kinsta’s Applicatie Hosting diensten.

Docusaurus is een generator voor statische sites. Het bouwt een single-page applicatie met snelle client-side navigatie, gebruikmakend van de volledige kracht van React om je site interactief te maken. Het is ontworpen om het teams gemakkelijk te maken documentatiewebsites te publiceren zonder zich zorgen te hoeven maken over de infrastructuur en ontwerpdetails. In de praktijk hoeft een gebruiker alleen maar documentatiebestanden aan te leveren (geschreven in Markdown), aanpassing te maken aan de meegeleverde startpagina (geschreven in React), en een paar configuratie-aanpassingen te doen.

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

  1. Fork deze GitHub 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.

De app is beschikbaar zodra de build klaar is en een standaard Docusaurus My Site pagina laadt op de URL van je applicatie.

Docusaurus standaard My Site pagina na succesvolle installatie.
Docusaurus standaard My Site pagina na succesvolle installatie.

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.