Questa guida spiega come regolare la configurazione di un sito Node.js ospitato sull'infrastruttura Infomaniak per adattare il comportamento della tua applicazione in base alla sua evoluzione, alle sue dipendenze o alle tue preferenze tecniche.

Prerequisiti

• Installare un sito Node.js sul tuo hosting.
• Testare le modifiche in locale prima di applicarle in produzione.
• Verificare che i tuoi script (start, build) siano definiti correttamente nel file package.json.
• Se modifichi la struttura del tuo progetto, ricorda di regolare la cartella di esecuzione e i comandi associati.
• La porta di ascolto definita nel Manager deve corrispondere a quella utilizzata nel codice dell'applicazione.

Accedere alla configurazione

Ogni sito dispone di un pannello di controllo dedicato per controllare l'applicazione (avvia, arresta, riavvia), consultare la console di esecuzione, gestire le versioni di Node.js, configurare i domini e attivare i certificati SSL:

1. Clicca qui per accedere alla gestione del tuo sito sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al sito interessato.
3. Puoi aprire la console, arrestare il progetto (verrà applicata una pagina di manutenzione) o riavviarlo.
4. Clicca su Gestisci sotto Impostazioni avanzate:
   
5. Clicca sulla scheda Node.js per accedere alle impostazioni:
   

Applicare le modifiche

Per fare questo:

1. Salvare le modifiche dall'interfaccia del Manager.
2. Riavviare la propria applicazione affinché le modifiche vengano applicate.

Consultare questa altra guida in caso di problemi.

Comandi principali

Cartella di esecuzione

La cartella di esecuzione indica la posizione sul server in cui verranno eseguiti i comandi di costruzione e di avvio. Deve puntare alla directory principale della propria applicazione, ovvero dove si trova il file package.json.

Ad esempio, è possibile specificare per la radice del progetto:

./

o se la propria applicazione si trova in una sottocartella denominata app:

./app

o se si trova in una cartella backend:

./backend

Comando di costruzione (facoltativo)

Se la propria applicazione Node.js richiede una fase di compilazione prima di essere eseguita, specificare un comando di costruzione nel campo previsto a tale scopo. Questo comando verrà eseguito automaticamente prima dell'avvio dell'applicazione.

Ad esempio, è possibile indicare:

npm install && npm run build

o, se si utilizza yarn :

yarn install && yarn build

Se il proprio progetto non richiede alcuna compilazione, questo campo può essere lasciato vuoto.

Comando di avvio

Il comando di avvio corrisponde all'istruzione utilizzata per avviare la propria applicazione. Deve essere identico a quello utilizzato in locale per eseguire il progetto.

Ad esempio, è possibile indicare:

node index.js

npm start

o

yarn start

Questo comando deve consentire di avviare direttamente il server o il punto di ingresso della propria applicazione come definito nel proprio ambiente di sviluppo.

Porta di ascolto

La propria applicazione deve ascoltare su una porta specifica che viene definita nel Manager. Questa porta viene trasmessa alla propria applicazione tramite una variabile di ambiente PORT.
Esempio nel codice Node.js:

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log(`Application lancée sur le port ${port}`);
});

Assicurarsi che questa porta venga presa in considerazione nel codice.

Versione di Node.js

È possibile selezionare la versione di Node.js che il sito deve utilizzare. È consigliabile utilizzare una versione stabile e sempre supportata per garantire la sicurezza e la compatibilità della tua applicazione.