#howto - Installazione e configurazione di Docusaurus 2 con Caddy Server 2 su CentOS 8/RHEL 8

Docusaurus è una applicazione in NodeJS con cui è possibile realizzare documentazioni, ma non solo: è infatti possibile creare veri e propri siti web e blog.

In questa guida vedremo come installare Docusaurus 2 con Caddy Server 2 su CentOS 8 e RHEL 8.

In questo articolo trattiamo la seconda versione del software. Nel momento in cui scrivo, questa è in fase di svilupppo e distribuita come Alpha “potenzialmente instabile”.

Installazione

In questa guida dividiamo il procedimento in due parti:

• la compilazione sulla nostra macchina di sviluppo
• la distribuzione sul nostro server Centos 8/RHEL 8

Questa suddivisione è consigliata per evitare di portare il progetto sul server in produzione, in questo modo terremo solo la versione compilata e non avremo bisogno delle dipendenze di NodeJS.

NodeJS

Prima di tutto abbiamo bisogno di NodeJS sulla nostra piattaforma di sviluppo. Come soluzione definitiva per l’intallazione, useremo NVM (Node Version Manager). Possiamo procedere con lo script automatizzato:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.36.0/install.sh | bash

Una volta terminato il processo, potrebbe essere necessario riavviare la shell per poter usufruire del comando.

Tramite il comando nvm, installiamo l’ultima versione LTS (Long-term Support):

nvm install --lts
nvm use --lts

e verifichiamo l’effettiva installazione:

nvm run node --version

Docusaurus

Per scaricare Docusaurus, dirigiamoci in un percorso pulito, dove è possibile generare il progetto. Procediamo quindi con npx:

npx @docusaurus/init@next init il-mio-progetto classic

dove:

• il-mio-progetto è il nome del percorso che vogliamo dare al progetto
• classic il template che andremo ad usare (fate riferimento alla documentazione ufficiale per altri template)

Una volta ultimato il processo ci troveremo davanti ai file del nostro nuovo progetto. A quel punto è possibile lavorarci tramite il nostro editor (o IDE) preferito.

Possiamo avviare un server per sviluppatori da cui visualizzare la nostra installazione:

npm run start

Caddy

Spostiamoci un momento sul server che useremo per la distribuzione dei file ed installiamo/configuriamo Caddy. Vi rimando alla guida specifica avendo già trattato l’argomento.

Creiamo una nuova configurazione:

il_mio_sito.ex {
	root * /path/il_mio_sito.ex/public
    try_files {path}.html {path}
    file_server
}

dove:

• il_mio_sito.ex è il dominio che vogliamo dedicare all’installazione
• /path/il_mio_sito.ex/public il percorso dove andremo a posizionare i file

E riavviamo caddy:

systemctl restart caddy

Build e distribuzione

Sul nostro PC, portiamoci alla posizione dei file del progetto e avviamo il processo di compilazione:

npm run build

questo andrà a generare tutti i file statici da poter distribuire via Caddy.

Carichiamo sul server, nella posizione configurata nel Caddyfile, i file generati nella path /build del progetto e sistemiamo i permessi:

find ./ -type d -exec chmod 755 {} +                                     
find ./ -type f -exec chmod 644 {} +

Ora, visitando il dominio precedentemente configurato, ci troveremo davanti alla nostra installazione di Docusaurus.

Ad ogni modifica, è necessario ripetere il processo di build e caricare nuovamente i file.