Questa guida dettagliata spiega il processo per distribuire lo strumento di automazione n8n utilizzando l'immagine Docker ufficiale sulla tua piattaforma PaaS Jelastic Cloud di Infomaniak.

Premessa

• n8n è un'applicazione Node.js spesso distribuita tramite Docker per garantire un ambiente coerente e isolato (containerizzazione).
• L'immagine utilizzata è n8nio/n8n, disponibile su Docker Hub, che assicura un'installazione standardizzata.
• Sebbene n8n utilizzi SQLite per l'archiviazione predefinita, un database esterno (PostgreSQL o MariaDB) è obbligatorio per la produzione per garantire le prestazioni, la resilienza e la scalabilità.
• La porta di ascolto interna predefinita di n8n è 5678/TCP.

1. Creazione dell'ambiente Jelastic, distribuzione del contenitore

Per configurare l'ambiente:

1. Accedi al pannello di controllo del tuo Jelastic Cloud.
2. Clicca sul pulsante Nuovo Ambiente.
3. Nel selezionatore di topologia:
   • Seleziona la scheda Docker Engine (il contenitore dell'applicazione).
   • Nel campo Seleziona l'immagine, usa la funzione di ricerca per trovare e aggiungere l'immagine ufficiale: n8nio/n8n (puoi specificare un tag come latest).
4. (Raccomandazione di produzione): Aggiungi un nodo di database.
   • Seleziona il nodo SQL (ad esempio, PostgreSQL o MariaDB).
   • Configura le sue risorse (Cloudlets) e le credenziali di accesso.
5. Regola le risorse del contenitore Docker (n8n): definisci il numero di Cloudlets (risorse allocate) per il contenitore n8n in base al carico previsto (memoria e CPU).
6. Specifica un nome per l'ambiente e clicca sul pulsante Crea. Jelastic provisiona i nodi.

2. Configurazione dello storage persistente e delle variabili d'ambiente

Una volta che l'ambiente è attivo, la configurazione è essenziale:

1. Localizza il tuo motore Docker (n8n) nell'elenco dei nodi dell'ambiente Jelastic.
2. Clicca sull'icona Configurazione (l'ingranaggio) accanto al contenitore n8n.

Configurazione dei Volumi (archiviazione persistente)

1. Vai alla sezione Volumi.
2. Aggiungi un nuovo volume di tipo Montaggio del volume per persistere i dati di n8n (flussi di lavoro, chiavi API, ecc.).
3. Percorso interno del contenitore (destinazione): /home/node/.n8n.
4. Percorso esterno sul nodo (origine): scegli una cartella sul nodo (es: /mnt/n8n_data) o un volume di archiviazione condiviso (NFS) se disponibile.

Configurazione delle Variabili d'Ambiente

1. Vai alla sezione Variabili d'Ambiente.
2. Aggiungi almeno le variabili di sicurezza e di rete:
   • N8N_HOST: il nome host o l'URL pubblica del tuo ambiente Jelastic (es: n8n-env.jpc.infomaniak.cloud).
   • WEBHOOK_URL: l'URL completa e accessibile pubblicamente attraverso la quale n8n riceve i webhook (es: https://n8n-env.jpc.infomaniak.cloud/).
   • N8N_BASIC_AUTH_ACTIVE: true (per proteggere l'interfaccia).
   • N8N_BASIC_AUTH_USER: un identificativo amministratore sicuro.
   • N8N_BASIC_AUTH_PASSWORD: una password sicura.
3. Se hai aggiunto un database esterno, configura le variabili di connessione (esempi per PostgreSQL):
   • DB_TYPE: postgresdb
   • DB_HOST: l'indirizzo IP o il nome host del nodo PostgreSQL.
   • DB_USER, DB_PASSWORD, DB_DATABASE: le credenziali del database.
4. Dopo la modifica, tornare alla dashboard e utilizzare l'opzione Riavvia il nodo sul contenitore n8n per applicare tutte le nuove configurazioni.

Altre configurazioni sono possibili:

• Impostare GENERIC_TIMEZONE per il fuso orario desiderato.
• Aggiungere EXECUTIONS_PROCESS=main se necessario.
• Impostare N8N_ENCRYPTION_KEY con una chiave forte per cifrare le credenziali.
• Assicurarsi che il volume persistente sia montato prima dell'avvio del contenitore.

3. Accesso e verifica

L'accesso finale all'applicazione:

1. Nella dashboard Jelastic, fare clic sul pulsante Apri nel browser accanto al contenitore Docker Engine o al Load Balancer (se ne hai configurato uno davanti a n8n).
2. Il browser dovrebbe caricare l'interfaccia utente di n8n.
3. Se l'autenticazione di base è attiva (via N8N_BASIC_AUTH_ACTIVE: true), il browser richiederà immediatamente le credenziali configurate.

Verifica dello storage

Dopo aver creato un primo workflow, connettersi al contenitore Docker tramite SSH (WebSSH Jelastic o client esterno) e verificare che i file di configurazione e i workflow siano memorizzati correttamente sul volume persistente nel percorso /home/node/.n8n.

Verificare anche che la porta 5678 sia esposta pubblicamente o tramite un Load Balancer HTTPS per i webhook. Utilizzare HTTPS in produzione (certificato Let’s Encrypt tramite Jelastic/Infomaniak).