Self Host n8n avec TrueFoundry

n8n est une puissante plateforme d'automatisation des flux de travail open source qui vous permet de créer des flux de travail complexes à l'aide d'une interface visuelle basée sur des nœuds. Bien que n8n propose une version cloud, la possibilité de auto-hébergeur n8n vous permet de contrôler totalement vos données, vos coûts et les performances de vos instances.

Grâce à la plateforme de déploiement de TrueFoundry, vous pouvez facilement auto-hébergeur n8n dans votre propre infrastructure sans vous perdre dans des configurations complexes de Kubernetes. Ce guide vous guidera tout au long du processus pour obtenir votre n8n auto-hébergé instance en cours d'exécution, de la configuration du stockage au déploiement de l'application.

Prérequis pour le déploiement de n8n

Avant de commencer, assurez-vous de disposer de la configuration suivante. Ils sont essentiels pour une expérience de déploiement fluide.

1. Compte et cluster TrueFoundry: vous avez besoin d'un compte TrueFoundry actif connecté à votre cluster Kubernetes. Si vous ne l'avez pas encore fait, suivez notre guide de configuration du compte.
2. CLI TrueFoundry: L'interface de ligne de commande (CLI) TrueFoundry est requise pour le déploiement depuis votre terminal. Installez-le et configurez-le à l'aide de notre Guide de configuration de la CLI.
3. Espace de travail: tous les déploiements dans TrueFoundry ont lieu dans un espace de travail. Créez un nouvel espace de travail ou identifiez l'espace de travail cible dans lequel vous souhaitez déployer n8n. Vous pouvez en savoir plus sur les espaces de travail dans notre documentation sur les concepts clés.

Pourquoi Self-Host n8n ? Les principaux avantages

Bien que les plateformes cloud soient pratiques, l'auto-hébergement de votre instance n8n permet d'atteindre un nouveau niveau de puissance, de contrôle et d'efficacité, essentiel pour les entreprises qui ont de sérieux objectifs d'automatisation. Il s'agit de passer d'un espace loué à la propriété de votre propre usine.

Voici les principaux avantages :

Souveraineté et sécurité complètes des données

• Préservez la confidentialité de vos données : Lorsque vous vous auto-hébergez, vos données sensibles, notamment les informations d'identification, les informations sur les clients et la logique métier propriétaire de vos flux de travail, ne quittent jamais votre propre infrastructure.
• Découvrez Compliance Head-On : Pour les secteurs soumis à des réglementations strictes en matière de données, comme le RGPD, l'HIPAA ou le SOC 2, l'auto-hébergement est souvent une exigence, et pas seulement une préférence. Il fournit un environnement de traitement des données clair et vérifiable.
• Contrôlez votre posture de sécurité : Vous définissez les politiques réseau, gérez les contrôles d'accès et mettez en œuvre des protocoles de sécurité conformes aux normes de votre entreprise.

Coût prévisible et échelle illimitée

• Tarification par exécution d'Escape : Au lieu de payer un coût variable pour chaque exécution de flux de travail, vos coûts sont liés à l'infrastructure que vous fournissez, ce qui les rend prévisibles et souvent nettement inférieurs à grande échelle.
• Aucune limite artificielle : Supprimez les contraintes sur le nombre de flux de travail actifs, d'utilisateurs ou de temps d'exécution imposées par les plans de cloud hiérarchisé. Vous n'êtes limité que par la puissance de l'infrastructure que vous lui donnez.

Performances et personnalisation inégalées

• Performances dédiées : Votre instance n8n s'exécute sur des ressources dédiées. Cela signifie des temps d'exécution plus rapides et aucun effet de « voisin bruyant », ce qui est crucial pour les automatisations sensibles au facteur temps.
• Personnalisation complète : Vous avez besoin d'installer un nœud communautaire personnalisé ou un nœud interne privé ? Avec une instance auto-hébergée, vous êtes libre d'étendre et de personnaliser votre environnement n8n sans aucune restriction.

Section 2 : Les défis courants de l'auto-hébergement n8n

Bien que les avantages soient évidents, la configuration et la gestion d'une instance n8n auto-hébergée et prête à être mise en production à partir de zéro peuvent représenter un défi technique important. Les développeurs et les équipes des plateformes sont souvent confrontés à une courbe d'apprentissage abrupte et rencontrent plusieurs obstacles courants :

1. Configuration complexe de Kubernetes

• Surcharge YAML : L'écriture et la gestion manuelles de fichiers YAML Kubernetes pour les déploiements, les services, les entrées et les secrets sont fastidieuses et très sujettes aux erreurs.
• Mise en réseau et entrée : La configuration correcte des politiques réseau, la configuration d'un contrôleur d'entrée et la gestion des certificats SSL/TLS pour exposer n8n à Internet en toute sécurité sont des tâches complexes.

2. Gestion des données persistantes

• Problèmes d'application graves : En tant qu'application dynamique, n8n nécessite un volume persistant pour stocker les données de flux de travail et d'identification. Configuration correcte Réclamations de volume persistantes et il peut être difficile de s'assurer que le volume est correctement monté.
• Gestion des bases de données : Pour une utilisation en production, une base de données robuste telle que PostgreSQL est recommandée plutôt que SQLite par défaut. Cela ajoute un autre composant à déployer, à gérer, à sécuriser et à connecter.

3. Adaptation aux charges de travail de production

• Au-delà d'une seule instance : La mise à l'échelle de n8n pour les flux de travail à volume élevé nécessite de passer à une configuration multi-nœuds avec des collaborateurs dédiés, ce qui implique de configurer des files d'attente (comme Redis), des équilibreurs de charge et de garantir une haute disponibilité.
• Surveillance et maintenance : Une instance auto-hébergée nécessite une surveillance active pour suivre l'utilisation des ressources (CPU/mémoire) et garantir la disponibilité. La mise à niveau vers les nouvelles versions de n8n nécessite également un processus manuel minutieux.

Ces défis font souvent perdre un temps d'ingénierie précieux consacré à l'automatisation des bâtiments à la gestion de l'infrastructure. C'est précisément là qu'une plateforme de déploiement rationalisée devient essentielle.

Comment auto-héberger n8n à l'aide de Truefoundry

Étape 1 : Création d'un volume persistant pour n8n

N'importe lequel n8n auto-hébergé L'instance nécessite un stockage permanent pour enregistrer vos flux de travail, vos informations d'identification et vos données d'exécution. Si l'instance redémarre, ce volume garantit la sécurité de toutes vos données. Vous pouvez créer ce volume à l'aide de l'interface utilisateur TrueFoundry ou de notre SDK Python.

Option A : Utilisation de l'interface utilisateur TrueFoundry

Pour une approche sans code, vous pouvez créer le volume requis directement via notre interface Web. Suivez les étapes détaillées dans notre guide de création de volumes.

Option B : Utilisation du déploiement Python

Pour une configuration répétable basée sur du code, vous pouvez définir le volume dans un script Python.

1. Créez un fichier nommé volume_deploy.py.
2. Ajoutez le code suivant. N'oubliez pas de remplacer les valeurs d'espace réservé pour classe_de stockage et ventilateur de l'espace de travail.

import logging
from truefoundry.deploy import (
    DynamicVolumeConfig,
    Volume,
)

logging.basicConfig(level=logging.INFO)

# Define the persistent volume for n8n data
volume = Volume(
    name="n8n-volume",
    # Replace with your cluster's storage class size
    config=DynamicVolumeConfig(storage_class="efs-sc", size=2),
    workspace_fqn="<your-workspace-fqn>", # Paste your Workspace FQN here
)

# Deploy the volume to your workspace
volume.deploy(workspace_fqn="<your-workspace-fqn>", wait=False)

3. Exécutez le script depuis votre terminal :

python volume_deploy.py

Étape 2 : Déploiement du service n8n

Le volume de stockage étant prêt, vous pouvez désormais déployer l'application n8n elle-même. Ce service exécutera le conteneur Docker n8n et le connectera au volume que vous avez créé.

1. Créez un nouveau fichier nommé service_deploy.py.
2. Collez le code suivant. Vous devrez remplacer les espaces réservés pour hôte, ventilateur de volume, et ventilateur de l'espace de travail.

import logging
from truefoundry.deploy import (
    Image,
    VolumeMount,
    Service,
    Port,
)

logging.basicConfig(level=logging.INFO)

service = Service(
    name="n8n-svc",
    image=Image(image_uri="docker.n8n.io/n8nio/n8n"),
    ports=[
        Port(
            port=5678,
            protocol="TCP",
            expose=True,
            app_protocol="http",
            host="<your-host-name>", # e.g., n8n.your-company.com
        )
    ],
    env={}, # Add license keys or other env vars here
    mounts=[
        VolumeMount(
            mount_path="/home/node/.n8n",
            volume_fqn="<your-volume-fqn>", # Paste the FQN of the volume from Step 1
        )
    ],
    workspace_fqn="<your-workspace-fqn>", # Paste your Workspace FQN here
)

service.deploy(workspace_fqn="<your-workspace-fqn>", wait=False)

Remarques sur la configuration :

• hôte: il s'agit de l'URL publique à laquelle vous accéderez à n8n. Trouvez votre domaine hôte disponible en suivant notre guide des ports et des domaines.
• ventilateur de volume: Il s'agit du nom complet du volume que vous avez créé à l'étape 1. Vous pouvez le trouver sur la page du volume dans le tableau de bord TrueFoundry.
• ventilateur de l'espace de travail: le FQN de l'espace de travail dans lequel vous souhaitez déployer le service.

3. Exécutez le script pour déployer le service n8n :

python service_deploy.py

Étape 3 : Accédez à votre instance n8n

Une fois le déploiement terminé, accédez à l'URL de l'hôte que vous avez configurée dans le service_deploy.py dossier. Vous serez accueilli par l'écran de configuration du n8n.

Vous pouvez désormais :

• Créez de puissantes automatisations des flux de travail.
• Connectez-vous à des centaines de services et d'API différents.
• Créez des pipelines de traitement de données complexes.
• Configurez des tâches planifiées et des déclencheurs pour vos tâches.

Votre instance n8n est désormais pleinement opérationnelle et fonctionne sur votre propre infrastructure avec un stockage permanent, garantissant ainsi la préservation de vos flux de travail et de vos informations d'identification lors de chaque redémarrage.

Débloquer les fonctionnalités du n8n Enterprise

Ce guide déploie l'édition communautaire de n8n. Si vous possédez une licence d'entreprise, vous pouvez débloquer des fonctionnalités supplémentaires en ajoutant votre clé de licence au env dictionnaire dans le service_deploy.py dossier.

Vous trouverez plus de détails sur les variables d'environnement dans documentation officielle du N8n.

Résolution des problèmes

Si vous rencontrez des problèmes, voici quelques points à vérifier en premier lieu :

• Classe de stockage non valide: Assurez-vous que classe_de stockage vous avez spécifié dans volume_deploy.py est disponible et compatible avec votre cluster.
• FQN incorrect: Vérifiez que ventilateur de l'espace de travail et ventilateur de volume les valeurs sont correctes et ne contiennent pas de fautes de frappe.
• Journaux de déploiement: Si un déploiement échoue, consultez les journaux de service dans le tableau de bord TrueFoundry pour obtenir des messages d'erreur détaillés.

Conclusion

Félicitations ! Vous avez appris avec succès comment auto-hébergeur n8n à l'aide de TrueFoundry. Ce n8n auto-hébergé La configuration vous donne non seulement un contrôle total sur vos flux de travail et vos données, mais fournit également une base évolutive et robuste pour tous vos besoins d'automatisation.