Questa guida spiega come regolare la configurazione di un sito Node.js ospitato sull'infrastruttura Infomaniak. Imparerai ad 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, pensa ad aggiornare la cartella di esecuzione e i comandi associati.
• Importante: 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 i log di esecuzione, gestire le versioni di Node.js 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. Clicca su Gestisci sotto Impostazioni avanzate:
   
4. Clicca sulla scheda Node.js per accedere alle impostazioni:
   

Comandi e automatizzazione

Cartella di esecuzione

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

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Comando di costruzione (Build)

Se la tua applicazione richiede una fase di preparazione (installazione delle dipendenze, compilazione TypeScript, minificazione), specifica qui il comando da eseguire. Questo è il metodo consigliato per distribuire i tuoi aggiornamenti.

A differenza di un'esecuzione manuale tramite SSH, questa interfaccia utilizza un ambiente con prestazioni potenziate per garantire una costruzione rapida senza influire sulle risorse del tuo sito in produzione. Puoi concatenare più compiti (come un git pull seguito da un build) e monitorare l'avanzamento e i log del processo in tempo reale direttamente dal Manager.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Nota: Se il tuo progetto è già compilato o non richiede alcuna fase intermedia, questo campo può rimanere vuoto.

Comando di avvio

Questo comando avvia il tuo server. Deve essere identico a quello utilizzato nel tuo ambiente di sviluppo locale per avviare il punto di ingresso dell'applicazione.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Porta di ascolto

La tua applicazione deve ascoltare obbligatoriamente sulla porta dinamica assegnata dal Manager. Questa porta viene trasmessa al tuo codice tramite la variabile d'ambiente PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Versione di Node.js

Puoi selezionare la versione desiderata di Node.js nelle impostazioni. È consigliabile privilegiare una versione stabile (LTS) per garantire la sicurezza e la longevità del tuo progetto.

Applica e valida le modifiche

Una volta salvate le modifiche nel Manager, devi riavviare la tua applicazione dal cruscotto affinché i nuovi parametri (nuova versione di Node, nuova porta o nuovo comando di build) vengano presi in considerazione.

In caso di difficoltà all'avvio, puoi consultare la console di esecuzione o fare riferimento a questa altra guida per la risoluzione dei problemi.