n8n¶

Dans cet article

• n8n. Caractéristiques principales
• Fonctionnalités de déploiement
• Démarrage avec n8n
• Création d'un compte Administrateur n8n
• Modification des montages de volume pour n8n
• Configurer Traefik pour changer le nom de domaine n8n en un nouveau
• Transfert des conteneurs Docker vers un utilisateur non privilégié (optionnel)
• Mise à jour de n8n
• Installation auto de n8n sur Ubuntu
• Installation Facile avec un Script Bash (Déploiement SSH et Invapi)
• Commande d'un serveur avec n8n via l'API

n8n. Caractéristiques principales¶

• Flexibilité : n8n permet de créer des scripts d'automatisation complexes. L'intégration de diverses applications et services via API permet de personnaliser les flux de travail et de réduire le travail routinier.
• Facilité d'utilisation : Une bibliothèque de modules prêts à l'emploi facilite la création de nouveaux flux de travail.
• Confort : n8n offre la possibilité d'exécuter et de tester des flux de travail directement depuis l'interface. Il permet de vérifier rapidement la correction du script et de corriger les erreurs.
• Fiabilité : n8n garantit la fiabilité des processus métier en permettant de réessayer les tâches si elles échouent.
• Extensibilité : En raison de 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¶

• Temps d'installation de 15 à 20 minutes, y compris le système d'exploitation ;
• Installation conteneurisée dans la zone hostkey.in ;
• L'interface Web sera disponible à l'URL : https://n8n{server_id}.hostkey.in ;
• Un conteneur Traefik est utilisé pour gérer la routage et les certificats SSL ;
• Le fichier de configuration se trouve à /root/n8n-compose-file/compose.yml.

Démarrage avec n8n¶

Une notification sera envoyée à l'e-mail spécifié lors de l'enregistrement indiquant que le serveur est prêt une fois le paiement effectué. Elle contiendra l'adresse IP du VPS, ainsi que les identifiants de connexion (login et mot de passe). Les clients de notre entreprise gèrent le matériel dans le panneau de contrôle des serveurs et API — Invapi.

Vous pouvez trouver les données d'authentification soit dans l'onglet Info >> Tags du panneau de contrôle du serveur, soit par e-mail qui a été envoyé. - Lien d'accès au tableau de bord n8n avec interface Web : dans le tag webpanel ; - Login et Mot de passe : Envoyés à votre adresse e-mail après que le serveur soit prêt pour une utilisation suite au déploiement du logiciel.

Création d'un compte Administrateur n8n¶

Après l'installation du conteneur Docker avec n8n, un paramétrage initial est nécessaire via l'interface Web. Lors de la première visite sur l'interface Web de n8n, vous serez invité(e) à créer un compte propriétaire : - Entrez votre adresse e-mail ; - Indiquez votre prénom et nom de famille ; - Créez un mot de passe fort (au moins 8 caractères, incluant au moins une chiffre et une majuscule) ; - Activez optionnellement les notifications sur les mises à jour de sécurité et du produit ; - Cliquez sur le bouton Next.

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

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

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

Activation optionnelle d'une licence gratuite

n8n offre la possibilité d'activer gratuitement certaines fonctionnalités premium : - Capacité à consulter l'historique des flux de travail (pour les 24 dernières heures) ; - Fonctionnalités de débogage améliorées pour corriger les erreurs dans les flux de travail ; - Recherche et balisage 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 sautez 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 collez la clé dans la section des paramètres n8n correspondante.

Écran principal et notification de licence :

Après avoir terminé le paramétrage initial, vous accéderez à l'écran principal de n8n : - En haut de l'écran se trouve un aperçu de tous les flux de travail accessibles, des identifiants et des exécutions ; - Sur l'écran principal, vous pouvez choisir comment commencer : créer un flux de travail depuis 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 qu'il faut vérifier votre e-mail (si vous avez précédemment sélectionné l'option pour envoyer la clé).

Modification des montages de volume pour n8n¶

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

1. Modifier 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. Modifier la ligne de montage de volume pour n8n :

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

   

3. Mettre à jour les images des conteneurs :

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

4. Redémarrer les conteneurs :

   docker compose down
   docker compose up -d
   

Configurer Traefik pour changer le nom de domaine n8n en un nouveau¶

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

1. Modifier le fichier compose.yml :

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

2. Ajouter ou modifier les labels du 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"
   

   

3. Mettre à jour les images des conteneurs :

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

4. Redémarrer les conteneurs :

   docker compose down
   docker compose up -d
   

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

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

1. Créer un nouvel utilisateur :

   adduser n8n_user
   

2. Ajouter l'utilisateur au groupe docker :

   usermod -aG docker n8n_user
   

3. Transférer 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. Copier 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. Modifier 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. Mettre à jour les images des conteneurs :

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

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

   docker compose up -d
   

Mise à jour de n8n¶

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

1. Accédez au dossier contenant le fichier de composition n8n :

   cd /root/n8n-compose-file/
   

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

   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émarrer vos conteneurs avec Docker Compose :

   docker compose up -d
   

Installation auto de n8n sur Ubuntu¶

1. Mettre à jour les paquets du système :

   sudo apt update && sudo apt upgrade -y 
   

2. Installer le moteur Docker :

   sudo apt install docker.io -y
   

3. Vérifier l'installation de Docker :

   docker version
   

4. Créer les répertoires requis :

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

5. Générer le fichier compose.yml : Créez un fichier nommé compose.yml dans votre répertoire /root/n8n-compose-file et collez-y 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 adresse IP via la ligne de commande :

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

6. Exécuter n8n via Docker Compose :

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

7. Attendre le démarrage de n8n : Attendez environ 10 secondes pour que n8n initialise et commence à écouter sur le port 5678.

8. Accéder à l'interface Web UI de 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). Vous serez invité à effectuer une configuration initiale et à vous connecter.

Installation Facile avec un Script Bash (Déploiement SSH et Invapi)¶

#!/bin/bash
# Mettre à jour le système
sudo apt update -y
# Installer le moteur Docker
sudo apt install docker.io -y
# Vérifier l'installation de Docker
docker version
# Créer les répertoires requis
mkdir /data && mkdir /root/n8n-compose-file
chmod 700 /data && chmod 700 /root/n8n-compose-file
# Obtenir l'adresse IP du serveur
IP_ADDRESS=$(hostname -I | awk '{print $1}')
# Générer le fichier compose.yml
cat > /root/n8n-compose-file/compose.yml <<EOF
version: "3"
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: always
    user: root
    ports:
      - "5678:5678" 
    environment:
      - N8N_HOST=$IP_ADDRESS> 
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://$IP_ADDRESS/
      - GENERIC_TIMEZONE="Europe/Amsterdam"
      - N8N_SECURE_COOKIE=false
    volumes:
      - /root/.n8n:/home/node/.n8n
      - /root/local-files:/files
EOF
# Exécuter n8n via Docker Compose
cd /root/n8n-compose-file
docker compose up -d 

Utiliser le script dans la ligne de commande BASH¶

• Connectez-vous à votre serveur via SSH.
• Enregistrez le script sous un fichier .sh (par exemple, install.sh).
• Rendez-le exécutable : chmod +x install.sh.
• Exécutez le script sur votre serveur : ./install.sh.

• Utilisez http://:5678 pour vous connecter à l'interface web. Vous obtiendrez votre IP via la ligne de commande :

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

Utilisation du Script lors de la Réinstallation du Serveur¶

• Lancez le configurateur de réinstallation en cliquant sur le bouton Reinstall Server dans l'onglet Reinstall de la carte serveur Invapi.
• Sélectionnez votre OS souhaité dans l'onglet Operating System.
• Collez le script pour l'OS supporté dans le champ Post-install script dans l'onglet Advanced options.
• Démarrez la réinstallation en cliquant sur le bouton Reinstall this server

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

Pour installer ce logiciel en utilisant l'API, suivez les instructions.

Une partie du contenu de cette page a été créée ou traduite par IA.