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 vostre modifiche in locale prima di applicarle in produzione.
• Verificare che i vostri script (start, build) siano correttamente definiti nel file package.json.
• Se modificate la struttura del vostro progetto, ricordate di regolare la cartella di esecuzione e i comandi associati.
• La porta di ascolto definita nel Manager deve corrispondere esattamente a quella utilizzata nel codice dell'applicazione.

Accedere alla configurazione

Ogni sito dispone di un pannello di controllo dedicato per gestire l'applicazione (avviare, fermare, riavviare), 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 prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Puoi aprire la console, fermare il progetto (verrà applicata una pagina di manutenzione) o riavviarlo.
4. Per accedere alle impostazioni avanzate, clicca su Gestisci sotto Impostazioni avanzate:
   
5. Fai clic sulla scheda Node.js per accedere alle impostazioni:
   

Applicare le modifiche

Per fare questo:

1. Registra le modifiche dall'interfaccia del Manager.
2. Riavviare la tua applicazione affinché le modifiche siano applicate.

Consultate questa altra guida in caso di problemi.

Comandi principali

Cartella di esecuzione

La cartella di esecuzione indica la posizione sul server dove verranno eseguiti i comandi di costruzione e avvio. Deve puntare alla directory radice della tua applicazione, cioè dove si trova il tuo file package.json.

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

./

o se la tua applicazione si trova in una sottocartella chiamata app:

./app

o se si trova in una cartella backend:

./backend

Comando di costruzione (facoltativo)

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

Ad esempio, puoi indicare:

npm install && npm run build

o, se usi yarn :

yarn install && yarn build

Se il tuo 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 tua applicazione. Deve essere identico a quello che usi localmente 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 tua applicazione come definito nel tuo ambiente di sviluppo.

Porta di ascolto

La tua applicazione deve ascoltare su una porta specifica che è definita nel Manager. Questa porta viene trasmessa alla tua applicazione tramite una variabile d'ambiente PORT.
Esempio nel tuo codice Node.js:

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

Assicurati che questa porta sia correttamente considerata nel tuo 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.