Questa guida spiega come deployare n8n utilizzando la sua immagine Docker ufficiale sulla piattaforma Jelastic Cloud (PaaS Infomaniak).

Premessa

• A differenza di strumenti come Zapier o Make, n8n, strumento di automazione dei workflow “fair-code”, può essere auto-hosted, il che ti permette di mantenere un controllo totale sui tuoi dati collegando centinaia di servizi tramite un'interfaccia visiva intuitiva.
• L'immagine ufficiale utilizzata è n8nio/n8n.
• L'uso di un database esterno (PostgreSQL) è vivamente consigliato per la stabilità e la gestione di grandi volumi di dati.
• La porta interna predefinita è la 5678.
• In caso di necessità, partner locali e referenziati da Infomaniak possono occuparsi di queste pratiche: lancia un appalto gratuito; si occupano di tutto, liberandoti dai dettagli tecnici — scopri anche il ruolo dell'hosting provider.

1. Creazione dell'ambiente Jelastic

Procedi come segue per configurare la tua topologia:

1. Accedi al pannello di controllo Jelastic Cloud.
2. Clicca su Nuovo ambiente.
3. Nell'assistente di creazione:
   • Vai alla scheda Docker.
   • Clicca su Seleziona un'immagine e cerca n8nio/n8n. Fissa una versione (es: latest o una versione specifica come 1.75.0).
   • Load Balancer: aggiungi un nodo (es: Nginx) per gestire il SSL e l'accesso pubblico.
   • Database: aggiungi un nodo PostgreSQL (versione 14+ consigliata).
4. Assegna un numero sufficiente di Cloudlets (8 min. consigliati per n8n in picco) e nomina il tuo ambiente.
5. Clicca su Crea.

2. Configurazione dello storage e della persistenza

Per impostazione predefinita, i dati Docker sono effimeri. È imperativo montare un volume:

1. Sul nodo n8n, clicca sull'icona Configurazione (l'ingranaggio).
2. Vai alla sezione Volumi.
3. Clicca su Aggiungi:
   • Percorso locale: /home/node/.n8n
4. Salva; i file di configurazione e il cifrario locale saranno ora preservati.

3. Variabili d'ambiente essenziali

Accedi alla sezione Variabili d'ambiente del contenitore n8n per definire i seguenti parametri:

Connessione con PostgreSQL

Per utilizzare il database esterno, aggiungi anche:

• DB_TYPE: postgresdb
• DB_POSTGRESDB_HOST: Indirizzo IP interno o DNS del nodo Postgres.
• DB_POSTGRESDB_PORT: 5432
• DB_POSTGRESDB_DATABASE: Nome del database (es: n8n).
• DB_POSTGRESDB_USER: Il tuo utente.
• DB_POSTGRESDB_PASSWORD: La tua password.

4. Primo accesso e sicurezza

1. Una volta riavviato il contenitore, apri l'URL del tuo ambiente.
2. Creazione dell'account: n8n ti chiederà di creare il primo account amministratore.
3. SSL: se utilizzi un dominio personalizzato, installa l'add-on Let's Encrypt sul nodo Load Balancer.

5. Verifica post-installazione

• Crea un workflow di test con un nodo Webhook e verifica che l'URL generata sia in https.
• Verifica nei log del contenitore che non compaiano errori di connessione al database.