Ce guide détaillé explique le processus pour déployer l'outil d'automatisation n8n en utilisant l'image Docker officielle sur votre plateforme PaaS Jelastic Cloud chez Infomaniak.

Préambule

• n8n est une application Node.js souvent déployée via Docker pour garantir un environnement cohérent et isolé (conteneurisation).
• L'image utilisée est n8nio/n8n, disponible sur le Docker Hub, assurant une installation standardisée.
• Bien que n8n utilise SQLite pour le stockage par défaut, une base de données externe (PostgreSQL ou MariaDB) est obligatoire pour la production afin d'assurer la performance, la résilience et la mise à l'échelle.
• Le port d'écoute interne par défaut de n8n est le 5678/TCP.

1. Création de l'environnement Jelastic, déploiement du conteneur

Pour mettre en place l'environnement :

1. Connectez-vous au tableau de bord de votre Jelastic Cloud.
2. Cliquez sur le bouton Nouvel Environnement.
3. Dans le sélecteur de topologie :
   • Sélectionnez l'onglet Docker Engine (le conteneur d'application).
   • Dans le champ Sélectionner l'image, utilisez la fonction de recherche pour trouver et ajouter l'image officielle : n8nio/n8n (vous pouvez spécifier un tag comme latest).
4. (Recommandation de production) : Ajoutez un nœud de base de données.
   • Sélectionnez le nœud SQL (ex : PostgreSQL ou MariaDB).
   • Configurez ses ressources (Cloudlets) et les identifiants d'accès.
5. Ajustez les ressources du conteneur Docker (n8n) : définissez le nombre de Cloudlets (ressources allouées) pour le conteneur n8n en fonction de la charge attendue (mémoire vive et CPU).
6. Spécifiez un nom d'environnement et cliquez sur le bouton Créer. Jelastic provisionne les nœuds.

2. Configuration du stockage persistant et des variables d'environnement

Une fois l'environnement actif, la configuration est essentielle :

1. Localisez votre conteneur Docker Engine (n8n) dans la liste des nœuds de l'environnement Jelastic.
2. Cliquez sur l'icône Configuration (l'engrenage) à côté du conteneur n8n.

Configuration des Volumes (stockage persistant)

1. Allez dans la section Volumes.
2. Ajoutez un nouveau volume de type Montage de volume pour persister les données de n8n (workflows, clés d'API, etc.).
3. Chemin interne du conteneur (destination) : /home/node/.n8n.
4. Chemin externe sur le nœud (source) : Choisissez un dossier sur le nœud (ex: /mnt/n8n_data) ou un volume de stockage partagé (NFS) si disponible.

Configuration des Variables d'Environnement

1. Allez dans la section Variables d'Environnement.
2. Ajoutez au minimum les variables de sécurité et de réseau :
   • N8N_HOST : Le nom d'hôte ou l'URL publique de votre environnement Jelastic (ex: n8n-env.jpc.infomaniak.cloud).
   • WEBHOOK_URL : L'URL complète et accessible publiquement par laquelle n8n reçoit les webhooks (ex: https://n8n-env.jpc.infomaniak.cloud/).
   • N8N_BASIC_AUTH_ACTIVE : true (pour protéger l'interface).
   • N8N_BASIC_AUTH_USER : Un identifiant administrateur sécurisé.
   • N8N_BASIC_AUTH_PASSWORD : Un mot de passe sécurisé.
3. Si vous avez ajouté une base de données externe, configurez les variables de connexion (exemples pour PostgreSQL) :
   • DB_TYPE : postgresdb
   • DB_HOST : L'adresse IP ou le nom d'hôte du nœud PostgreSQL.
   • DB_USER, DB_PASSWORD, DB_DATABASE : Les identifiants de la base de données.
4. Après la modification, retournez au tableau de bord et utilisez l'option Redémarrer le nœud sur le conteneur n8n pour appliquer toutes les nouvelles configurations.

D'autres paramétrages sont possibles:

• Définir GENERIC_TIMEZONE pour la timezone souhaitée.
• Ajouter EXECUTIONS_PROCESS=main si nécessaire.
• Définir N8N_ENCRYPTION_KEY avec une clé forte pour chiffrer les credentials.
• S’assurer que le volume persistant est monté avant le démarrage du conteneur.

3. Accès et vérification

L'accès final à l'application :

1. Dans le tableau de bord Jelastic, cliquez sur le bouton Ouvrir dans le navigateur à côté du conteneur Docker Engine ou du Load Balancer (si vous en avez configuré un devant n8n).
2. Le navigateur devrait charger l'interface utilisateur de n8n.
3. Si l'authentification de base est active (via N8N_BASIC_AUTH_ACTIVE: true), le navigateur demandera immédiatement les identifiants configurés.

Vérification du stockage

Après avoir créé un premier workflow, connectez-vous au conteneur Docker via SSH (WebSSH Jelastic ou client externe) et vérifiez que les fichiers de configuration et les workflows sont bien stockés sur le volume persistant dans le chemin /home/node/.n8n.

Vérifiez également que le port 5678 est exposé publiquement ou via un Load Balancer HTTPS pour les webhooks. Utilisez HTTPS en production (certificat Let’s Encrypt via Jelastic/Infomaniak).