N8n selbst hosten mit TrueFoundry

n8n ist eine leistungsstarke Open-Source-Workflow-Automatisierungsplattform, mit der Sie komplexe Workflows mithilfe einer visuellen, knotenbasierten Oberfläche erstellen können. n8n bietet zwar eine Cloud-Version, aber die Möglichkeit Selfhost n8n gibt Ihnen die vollständige Kontrolle über Ihre Daten, Kosten und Instanzleistung.

Mit der Bereitstellungsplattform von TrueFoundry können Sie ganz einfach Selfhost n8n in Ihrer eigenen Infrastruktur, ohne sich in komplexen Kubernetes-Konfigurationen zu verlieren. Dieser Leitfaden führt Sie durch den gesamten Prozess, um Ihre n8n selbst gehostet Instanz wird ausgeführt, von der Einrichtung des Speichers bis zur Bereitstellung der Anwendung.

Voraussetzungen für die Bereitstellung von n8n

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Einstellungen vorgenommen haben. Diese sind für eine reibungslose Bereitstellung unerlässlich.

1. TrueFoundry-Konto und Cluster: Sie benötigen ein aktives TrueFoundry-Konto, das mit Ihrem Kubernetes-Cluster verbunden ist. Wenn Sie dies noch nicht getan haben, folgen Sie unserem Anleitung zur Kontoeinrichtung.
2. TrueFoundry CLI: Die TrueFoundry Command Line Interface (CLI) ist für die Bereitstellung von Ihrem Terminal aus erforderlich. Installieren und konfigurieren Sie es mit unserem Anleitung zur CLI-Einrichtung.
3. Arbeitsbereich: Alle Bereitstellungen in TrueFoundry finden innerhalb eines Workspace statt. Erstellen Sie einen neuen Workspace oder identifizieren Sie den Ziel-Workspace, in dem Sie n8n bereitstellen möchten. Mehr über Workspaces erfährst du in unserer Dokumentation zu den wichtigsten Konzepten.

Warum Self-Host n8n? Die wichtigsten Vorteile

Cloud-Plattformen bieten zwar Komfort, aber das Self-Hosting Ihrer n8n-Instance ermöglicht ein neues Maß an Leistung, Kontrolle und Effizienz, das für Unternehmen mit ernsthaften Automatisierungszielen von entscheidender Bedeutung ist. Es geht darum, von einem gemieteten Raum in eine eigene Fabrik umzuziehen.

Hier sind die wichtigsten Vorteile:

Vollständige Datensouveränität und Sicherheit

• Halten Sie Ihre Daten privat: Wenn Sie selbst hosten, verlassen Ihre vertraulichen Daten — einschließlich Anmeldeinformationen, Kundeninformationen und proprietärer Geschäftslogik innerhalb Ihrer Workflows — niemals Ihre eigene Infrastruktur.
• Treten Sie der Compliance direkt vor: Für Branchen mit strengen Datenvorschriften wie GDPR, HIPAA oder SOC 2 ist Self-Hosting oft eine Voraussetzung, nicht nur eine Präferenz. Es bietet eine klare und überprüfbare Datenverarbeitungsumgebung.
• Kontrollieren Sie Ihre Sicherheitslage: Sie definieren die Netzwerkrichtlinien, verwalten die Zugriffskontrollen und implementieren Sicherheitsprotokolle, die den Standards Ihres Unternehmens entsprechen.

Vorhersagbare Kosten und unbegrenzter Umfang

• Escape-Preise pro Ausführung: Anstatt variable Kosten für jeden Workflow-Durchlauf zu zahlen, sind Ihre Kosten an die von Ihnen bereitgestellte Infrastruktur gebunden, sodass sie vorhersehbar sind und im großen Maßstab oft deutlich niedriger sind.
• Keine künstlichen Grenzen: Beseitigen Sie die Einschränkungen in Bezug auf die Anzahl der aktiven Workflows, Benutzer oder Ausführungszeiten, die durch mehrstufige Cloud-Pläne auferlegt werden. Sie sind nur durch die Leistung der Infrastruktur begrenzt, die Sie ihr zur Verfügung stellen.

Unübertroffene Leistung und Anpassungsfähigkeit

• Engagierte Leistung: Ihre n8n-Instance läuft auf dedizierten Ressourcen. Das bedeutet schnellere Ausführungszeiten und keinen „Noisy Neighbor“ -Effekt, was für zeitkritische Automatisierungen entscheidend ist.
• Vollständige Anpassung: Müssen Sie einen benutzerdefinierten Community-Node oder einen privaten, internen Node installieren? Mit einer selbst gehosteten Instance hast du die Freiheit, deine n8n-Umgebung ohne Einschränkungen zu erweitern und anzupassen.

Abschnitt 2: Die gemeinsamen Herausforderungen von Self-Hosting n8n

Die Vorteile liegen auf der Hand, aber die Einrichtung und Verwaltung einer produktionsbereiten, selbst gehosteten n8n-Instanz von Grund auf kann eine erhebliche technische Herausforderung sein. Entwickler und Plattformteams stehen oft vor einer steilen Lernkurve und stoßen auf mehrere häufige Hürden:

1. Komplexe Kubernetes-Konfiguration

• YAML-Überlastung: Das manuelle Schreiben und Verwalten von Kubernetes-YAML-Dateien für Bereitstellungen, Dienste, Ingress und Secrets ist mühsam und sehr fehleranfällig.
• Netzwerke und Ingress: Die korrekte Konfiguration von Netzwerkrichtlinien, die Einrichtung eines Ingress-Controllers und die Verwaltung von SSL/TLS-Zertifikaten, um n8n sicher im Internet verfügbar zu machen, ist eine komplexe Aufgabe.

2. Verwaltung persistenter Daten

• Probleme mit zustandsbehafteten Anwendungen: Als statusbehaftete Anwendung benötigt n8n ein persistentes Volume zum Speichern von Workflow- und Anmeldeinformationen. Ordnungsgemäße Konfiguration Anhaltende Volumenansprüche und sicherzustellen, dass das Volume korrekt montiert ist, kann schwierig sein.
• Datenbankverwaltung: Für den Produktionseinsatz wird eine robuste Datenbank wie PostgreSQL dem Standard-SQLite vorgezogen. Dadurch wird eine weitere Komponente hinzugefügt, die bereitgestellt, verwaltet, gesichert und eine Verbindung hergestellt werden kann.

3. Skalierung für Produktions-Workloads

• Über eine einzelne Instanz hinaus: Die Skalierung von n8n für Workflows mit hohem Volumen erfordert die Umstellung auf ein Setup mit mehreren Knoten und dedizierten Mitarbeitern. Dazu gehören die Konfiguration von Warteschlangen (wie Redis), Load Balancern und die Sicherstellung einer hohen Verfügbarkeit.
• Überwachung und Wartung: Eine selbst gehostete Instance erfordert eine aktive Überwachung, um die Ressourcennutzung (CPU/Speicher) zu verfolgen und die Verfügbarkeit sicherzustellen. Das Upgrade auf neue n8n-Versionen erfordert ebenfalls einen sorgfältigen, manuellen Prozess.

Diese Herausforderungen vergeuden oft wertvolle Entwicklungszeit von der Gebäudeautomatisierung auf die Verwaltung der Infrastruktur. Genau hier wird eine optimierte Bereitstellungsplattform unverzichtbar

Wie man n8n mit Truefoundry selbst hostet

Schritt 1: Erstellen Sie ein persistentes Volume für n8n

Irgendein n8n selbst gehostet Instanz benötigt persistenten Speicher, um Ihre Workflows, Anmeldeinformationen und Ausführungsdaten zu speichern. Wenn die Instanz neu gestartet wird, stellt dieses Volume sicher, dass alle Ihre Daten sicher sind. Sie können dieses Volume entweder mit der TrueFoundry-Benutzeroberfläche oder unserem Python-SDK erstellen.

Option A: Verwenden der TrueFoundry-Benutzeroberfläche

Für einen No-Code-Ansatz können Sie das benötigte Volumen direkt über unser Webinterface erstellen. Folgen Sie den detaillierten Schritten in unserem Anleitung zur Volumenerstellung.

Option B: Python-Bereitstellung verwenden

Für ein codebasiertes, wiederholbares Setup können Sie das Volumen in einem Python-Skript definieren.

1. Erstellen Sie eine Datei mit dem Namen volume_deploy.py.
2. Fügen Sie den folgenden Code hinzu. Denken Sie daran, die Platzhalterwerte durch zu ersetzen Speicherklasse und workspace_fan.

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. Führen Sie das Skript von Ihrem Terminal aus:

python volume_deploy.py

Schritt 2: Bereitstellen des n8n-Dienstes

Wenn das Speichervolume bereit ist, können Sie jetzt die n8n-Anwendung selbst bereitstellen. Dieser Dienst führt den n8n-Docker-Container aus und verbindet ihn mit dem von Ihnen erstellten Volume.

1. Erstellen Sie eine neue Datei mit dem Namen service_deploy.py.
2. Fügen Sie den folgenden Code ein. Sie müssen die Platzhalter ersetzen für Wirt, volume_fan, und workspace_fan.

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)

Hinweise zur Konfiguration:

• Wirt: Dies ist die öffentliche URL, unter der Sie auf n8n zugreifen. Finden Sie Ihre verfügbare Hostdomain, indem Sie unseren folgen Leitfaden für Ports und Domänen.
• volume_fan: Dies ist der vollqualifizierte Name des Volumes, das Sie in Schritt 1 erstellt haben. Sie finden ihn auf der Seite des Volumes im TrueFoundry-Dashboard.
• workspace_fan: Der FQN des Workspace, in dem Sie den Service bereitstellen möchten.

3. Führen Sie das Skript aus, um den n8n-Dienst bereitzustellen:

python service_deploy.py

Schritt 3: Greifen Sie auf Ihre n8n-Instance zu

Sobald die Bereitstellung abgeschlossen ist, navigieren Sie zu der Host-URL, die Sie in der service_deploy.py Datei. Sie werden vom n8n-Setup-Bildschirm begrüßt.

Sie können jetzt:

• Erstellen Sie leistungsstarke Workflow-Automatisierungen.
• Stellen Sie eine Verbindung zu Hunderten verschiedener Dienste und APIs her.
• Erstellen Sie komplexe Datenverarbeitungspipelines.
• Richten Sie geplante Aufgaben und Auslöser für Ihre Jobs ein.

Ihre n8n-Instance ist jetzt voll funktionsfähig und läuft auf Ihrer eigenen Infrastruktur mit persistentem Speicher, wodurch sichergestellt wird, dass Ihre Workflows und Anmeldeinformationen bei allen Neustarts erhalten bleiben.

Funktionen von n8n Enterprise freischalten

Dieses Handbuch stellt die Community Edition von n8n bereit. Wenn Sie über eine Unternehmenslizenz verfügen, können Sie zusätzliche Funktionen freischalten, indem Sie Ihren Lizenzschlüssel dem env Wörterbuch in der service_deploy.py Datei.

Weitere Informationen zu Umgebungsvariablen finden Sie in der offizielle n8n-Dokumentation.

Problembehebung

Wenn Sie auf Probleme stoßen, sollten Sie zuerst die folgenden Dinge überprüfen:

• Ungültige Speicherklasse: Stellen Sie sicher, dass Speicherklasse du hast angegeben in volume_deploy.py ist verfügbar und mit Ihrem Cluster kompatibel.
• Falsches FQN: Vergewissern Sie sich, dass workspace_fan und volume_fan Die Werte sind korrekt und enthalten keine Tippfehler.
• Bereitstellungsprotokolle: Wenn eine Bereitstellung fehlschlägt, überprüfen Sie die Serviceprotokolle im TrueFoundry-Dashboard auf detaillierte Fehlermeldungen.

Fazit

Herzlichen Glückwunsch! Sie haben erfolgreich gelernt, wie Selfhost n8n mit TrueFoundry. Das n8n selbst gehostet Setup gibt Ihnen nicht nur die vollständige Kontrolle über Ihre Workflows und Daten, sondern bietet auch eine skalierbare und robuste Grundlage für all Ihre Automatisierungsanforderungen.