n8n¶

Dans cet article

• n8n. Fonctionnalités clés
• Fonctionnalités de déploiement
• Premiers pas après le déploiement de n8n
• Création d'un compte administrateur n8n
• Modification des montages de volumes pour n8n
• Configuration de Traefik pour changer le nom de domaine n8n vers un nouveau
• Transfert des conteneurs Docker vers un utilisateur non privilégié (Facultatif)
• Mise à jour de n8n
• Installation autonome de n8n sur Ubuntu
• Tutoriel vidéo
• Commande d'un serveur avec n8n via l'API

n8n. Fonctionnalités clés¶

• Flexibilité : n8n vous permet de créer des scripts d'automatisation complexes. L'intégration de diverses applications et services via l'API vous permet de personnaliser les flux de travail et de réduire les tâches répétitives.
• Facilité d'utilisation : Une bibliothèque de modules prêts à l'emploi facilite grandement la création de nouveaux flux de travail.
• Confort : n8n offre la possibilité d'exécuter et de tester les flux de travail directement depuis l'interface. Il vous permet de vérifier rapidement la correction du script et de corriger les erreurs.
• Fiabilité : n8n assure la fiabilité des processus métier en permettant la réexécution des tâches en cas d'échec.
• Extensibilité : Grâce à son code source ouvert, n8n peut être facilement étendu en créant de nouveaux modules d'intégration avec d'autres services.

Fonctionnalités de déploiement¶

Premiers pas après le déploiement de n8n¶

Une notification sera envoyée à l'adresse e-mail spécifiée lors de l'inscription indiquant que le serveur est prêt pour le travail après le paiement de la commande. Elle contiendra l'adresse IP du VPS, ainsi que le nom d'utilisateur et le mot de passe pour la connexion. Les clients de notre entreprise gèrent le matériel dans le panneau de contrôle du serveur et de l'API — Invapi.

Vous pouvez trouver les données d'autorisation soit dans l'onglet Configuration >> Tags du panneau de contrôle du serveur, soit dans l'e-mail qui a été envoyé.

• Lien d'accès au tableau de bord n8n avec une interface Web : dans la balise webpanel ;
• Login et Password : Envoyés à votre adresse e-mail après que le serveur est prêt à être utilisé suite au déploiement du logiciel.

Création d'un compte administrateur n8n¶

Après l'installation du conteneur Docker avec n8n, une configuration initiale est requise via l'interface Web. Lors de la première visite de l'interface Web n8n, on vous demandera de créer un compte propriétaire :

• Entrez votre adresse e-mail ;
• Spécifiez votre prénom et nom de famille ;
• Créez un mot de passe fort (au moins 8 caractères, incluant au moins un chiffre et une lettre majuscule) ;
• Activez éventuellement les notifications concernant les mises à jour de sécurité et de produit ;
• Cliquez sur le bouton Next.

Ensuite, une fenêtre pour les paramètres de personnalisation s'ouvrira :

• "Quoi de mieux décrit votre entreprise ?" ;
• "Quel rôle vous décrit le mieux ?" ;
• "Pour qui vos automatisations seront-elles principalement destinées ?" ;
• "Quelle est la taille de votre entreprise ?" ;
• "Comment avez-vous entendu parler de n8n ?".

Après avoir rempli tous les champs, cliquez sur le bouton Get started.

Activation facultative d'une licence gratuite¶

n8n peut vous proposer une activation gratuite de certaines fonctionnalités premium :

• Possibilité de consulter l'historique des flux de travail (pour les 24 dernières heures) ;
• Capacités de débogage améliorées pour corriger les erreurs dans les flux de travail ;
• Recherche et étiquetage pour organiser les flux de travail exécutés.

Pour obtenir une clé de licence gratuite :

• Entrez votre e-mail dans le champ correspondant ;
• Cliquez sur Send me a free license key ou passez cette étape en cliquant sur Skip. Si vous choisissez de recevoir la clé, elle sera envoyée à l'adresse spécifiée :

• Pour activer la clé, cliquez sur Activate License Key dans l'e-mail ou copiez et entrez la clé dans la section de paramètres n8n correspondante.

Écran principal et notification de licence¶

Après avoir terminé la configuration initiale, vous atteindrez l'écran principal de n8n :

• En haut de l'écran se trouve un aperçu de tous les flux de travail, identifiants et exécutions accessibles ;
• Sur l'écran principal, vous pouvez choisir comment commencer : créer un flux de travail à partir de zéro ou tester un exemple prêt à l'emploi avec un agent IA ;
• Dans le coin inférieur droit, une notification indiquera que votre clé de licence est en cours d'envoi et que vous devez vérifier votre e-mail (si l'option d'envoi de la clé a été sélectionnée précédemment).

Modification des montages de volumes pour n8n¶

Un montage de volume correct dans les conteneurs Docker n8n est important non seulement pour la préservation des données entre les redémarrages, mais aussi pour assurer un fonctionnement ininterrompu lors des mises à jour de version, la migration vers un autre serveur, la création de sauvegardes, la simplification du débogage et du diagnostic, la possibilité de modification externe des flux de travail, l'intégration avec les processus CI/CD et le déploiement fiable dans des environnements en cluster.

1. Modifiez le fichier compose.yml :

   nano /root/n8n-compose-file/compose.yml
   

   Pour vérifier l'emplacement du fichier, utilisez la commande :

   find / -name "docker-compose.yml" -o -name "compose.yml" 2>/dev/null
   

2. Modifiez la ligne de montage de volume pour n8n :

   - /root/.n8n:/root/.n8n
   

   

3. Mettez à jour les images des conteneurs :

   cd /root/n8n-compose-file/
   docker compose pull
   

   4. Redémarrez les conteneurs :

   docker compose down
   docker compose up -d
   

Configuration de Traefik pour changer le nom de domaine n8n vers un nouveau¶

Pour assurer l'accès à n8n via le nouveau nom de domaine, il est nécessaire de configurer Traefik pour la redirection du trafic.

1. Modifiez le fichier compose.yml :

   nano /root/n8n-compose-file/compose.yml
   

   2. Ajoutez ou modifiez les étiquettes pour le conteneur n8n :

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.n8n.rule=Host(`your-domain.com`)"
     - "traefik.http.routers.n8n.entrypoints=websecure"
     - "traefik.http.routers.n8n.tls=true"
     - "traefik.http.services.n8n.loadbalancer.server.port=5678"
   

   

2. Mettez à jour les images des conteneurs :

   cd /root/n8n-compose-file/
   docker compose pull
   

   4. Redémarrez les conteneurs :

   docker compose down
   docker compose up -d
   

Transfert des conteneurs Docker vers un utilisateur non privilégié (Facultatif)¶

Pour améliorer la sécurité, il est recommandé d'exécuter les conteneurs Docker non en tant qu'utilisateur root.

1. Créez un nouvel utilisateur :

   adduser n8n_user
   

   2. Ajoutez l'utilisateur au groupe docker :

   usermod -aG docker n8n_user
   

   3. Transférez les données n8n :

   mkdir -p /home/n8n_user/n8n
   cp -r /root/.n8n/* /home/n8n_user/n8n/
   chown -R n8n_user:n8n_user /home/n8n_user/n8n
   

   4. Copiez les fichiers de configuration :

   cp -r /root/n8n-compose-file /home/n8n_user/
   chown -R n8n_user:n8n_user /home/n8n_user/n8n-compose-file
   

   5. Modifiez le chemin de montage dans compose.yml :

   sed -i 's|/root/.n8n:/root/.n8n|/home/n8n_user/n8n:/root/.n8n|g' /home/n8n_user/n8n-compose-file/compose.yml
   

   6. Mettez à jour les images des conteneurs :

   su - n8n_user
   cd ~/n8n-compose-file
   docker compose pull
   

   7. Démarrez les conteneurs en tant que nouvel utilisateur :

   docker compose up -d
   

Mise à jour de n8n¶

Pour mettre à jour l'image Docker pour n8n, suivez ces étapes :

1. Changez de répertoire vers le dossier de votre fichier Compose n8n :

   cd /root/n8n-compose-file/
   

2. Arrêtez le conteneur n8n en cours d'exécution :

   docker stop n8n-compose-file-n8n-1
   

3. Supprimez le conteneur arrêté :

   docker rm n8n-compose-file-n8n-1
   

4. Téléchargez la dernière image Docker pour n8n :

   docker pull docker.n8n.io/n8nio/n8n:latest
   

5. Redémarrez vos conteneurs en utilisant Docker Compose :

   docker compose up -d
   

Installation autonome de n8n sur Ubuntu¶

1. Mettez à jour les packages système :

   sudo apt update && sudo apt upgrade -y 
   

2. Installez le moteur Docker :

   sudo apt install docker.io -y
   

3. Vérifiez l'installation de Docker :

   docker version
   

4. Créez les répertoires requis :

   mkdir /data && mkdir /root/n8n-compose-file
   chmod 700 /data && chmod 700 /root/n8n-compose-file
   

5. Générez le fichier compose.yml :

   Créez un fichier nommé compose.yml dans votre répertoire /root/n8n-compose-file et collez le contenu suivant :

   version: "3"
   services:
     n8n:
       image: docker.n8n.io/n8nio/n8n:latest
       restart: always
       user: root
       ports:
         - "5678:5678" 
       environment:
         - N8N_HOST=<you-server-ip> 
         - N8N_PORT=5678
         - N8N_PROTOCOL=http
         - NODE_ENV=production
         - WEBHOOK_URL=http://<you-server-ip>/
         - GENERIC_TIMEZONE="Europe/Amsterdam"
         - N8N_SECURE_COOKIE=false
       volumes:
         - /root/.n8n:/home/node/.n8n
         - /root/local-files:/files
   

   Remplacez <your-server-ip> par l'adresse IP réelle de votre serveur. Vous obtiendrez votre IP via la ligne de commande :

   hostname -I | awk '{print $1}'
   

6. Exécutez n8n via Docker Compose :

   cd /root/n8n-compose-file
   docker compose up -d 
   

7. Attendez que n8n démarre :

   Attendez environ 10 secondes que n8n s'initialise et commence à écouter sur le port 5678.

8. Accédez à l'interface Web n8n :

   Ouvrez un navigateur Web et accédez à https://your-server-ip:443. (Remplacez your-server-ip par l'adresse IP réelle de votre serveur). On vous demandera une configuration initiale et les identifiants de connexion.

Tutoriel vidéo¶

Commande d'un serveur avec n8n via l'API¶