Installation von Third-Party Nodes

Es gibt drei Methoden, um zusätzliche Third-Party Nodes in LowCode zu installieren. Die Wahl der Methode hängt vom Einsatzzweck ab.

Übersicht der Methoden

Methode 1: Palette Manager (UI)

Der Palette Manager ist die einfachste Methode und direkt über die Node-RED-Oberfläche erreichbar.

Schritte

1. Öffnen Sie den Node-RED-Editor (http://localhost:1880)
2. Klicken Sie auf das Hamburger-Menü (oben rechts)
3. Wählen Sie Palette verwalten (Manage palette)
4. Wechseln Sie zum Tab Installieren
5. Suchen Sie nach dem gewünschten Paket
6. Klicken Sie auf Installieren

Vorteile

• Keine Kommandozeile erforderlich
• Sofort verfügbar ohne Neustart
• Einfache Suche nach Paketen

Einschränkungen

• Installierte Nodes gehen bei Container-Neustart verloren (sofern kein Volume auf /data gemountet ist)
• Keine Versionskontrolle
• Nicht geeignet für Produktionsumgebungen

Tipp: Wenn Sie ein Volume auf /data gemountet haben, werden über den Palette Manager installierte Nodes im Verzeichnis /data/node_modules gespeichert und überleben einen Container-Neustart.

Methode 2: npm install im Container

Für schnelle Tests können Sie Pakete direkt im laufenden Container installieren.

Schritte

# In den Container wechseln
docker exec -it <container-name> /bin/bash
 
# In das Node-RED-Verzeichnis wechseln
cd /data
 
# Paket installieren
npm install node-red-contrib-postgresql
 
# Node-RED neu starten (innerhalb des Containers)
node-red-restart

Alternativ ohne interaktive Shell:

# Direkt im Container installieren
docker exec <container-name> npm install --prefix /data node-red-contrib-postgresql
 
# Container neu starten
docker restart <container-name>

Mehrere Pakete gleichzeitig

docker exec <container-name> npm install --prefix /data \
  node-red-contrib-influxdb \
  node-red-contrib-telegrambot \
  node-red-node-email

Einschränkungen

• Änderungen gehen ohne Volume-Mount bei Container-Neustart verloren
• Manuelle Installation auf jedem neuen Container erforderlich
• Keine Reproduzierbarkeit

Methode 3: Custom Docker Image (empfohlen)

Für Produktionsumgebungen erstellen Sie ein eigenes Docker Image, das alle benötigten Nodes enthält. Diese Methode ist reproduzierbar, versionierbar und CI/CD-tauglich.

Einfaches Dockerfile

FROM marketplace.processcube.io/processcube-io/processcube_lowcode:latest
 
# Zusätzliche Nodes installieren
USER root
 
# In das Data-Verzeichnis wechseln
WORKDIR /data
 
# Pakete installieren
RUN npm install \
  node-red-contrib-influxdb \
  node-red-contrib-telegrambot \
  node-red-node-email
 
# Zurück zum Node-RED-User
USER node-red
 
# Arbeitsverzeichnis zurücksetzen
WORKDIR /usr/src/node-red

Mit package.json (empfohlen)

Für bessere Versionskontrolle verwenden Sie eine eigene package.json:

{
  "name": "my-lowcode-custom-nodes",
  "version": "1.0.0",
  "description": "Zusätzliche Nodes für unser Projekt",
  "dependencies": {
    "node-red-contrib-influxdb": "^0.7.0",
    "node-red-contrib-telegrambot": "^16.0.0",
    "node-red-node-email": "^2.1.0",
    "node-red-contrib-cron-plus": "^2.1.0"
  }
}

FROM marketplace.processcube.io/processcube-io/processcube_lowcode:latest
 
USER root
 
# package.json kopieren und Abhängigkeiten installieren
COPY custom-nodes/package.json /data/package.json
WORKDIR /data
RUN npm install --production
 
USER node-red
WORKDIR /usr/src/node-red

Build und Deployment

# Image bauen
docker build -t mein-lowcode:1.0.0 .
 
# Image testen
docker run -p 1880:1880 mein-lowcode:1.0.0
 
# Image taggen und pushen
docker tag mein-lowcode:1.0.0 registry.example.com/mein-lowcode:1.0.0
docker push registry.example.com/mein-lowcode:1.0.0

Verwendung in docker-compose.yml

services:
  lowcode:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "1880:1880"
    environment:
      - ENGINE_URL=http://engine:8000
    volumes:
      - lowcode_data:/data
 
volumes:
  lowcode_data:

Versionierung von Nodes

Pinnen Sie in Produktionsumgebungen immer die Versionen Ihrer Abhängigkeiten:

{
  "dependencies": {
    "node-red-contrib-postgresql": "0.12.0",
    "node-red-contrib-modbus": "5.27.0"
  }
}

Vermeiden Sie "latest" oder Bereiche wie "^1.0.0" in Produktion, um unerwartete Änderungen zu verhindern.

Fehlerbehebung

Paket lässt sich nicht installieren

Prüfen Sie, ob native Build-Tools benötigt werden:

# Im Dockerfile zusätzliche Build-Tools installieren
RUN apk add --no-cache python3 make g++

Node erscheint nicht in der Palette

• Starten Sie Node-RED neu: docker restart <container-name>
• Prüfen Sie die Logs: docker logs <container-name>
• Stellen Sie sicher, dass das Paket im richtigen Verzeichnis installiert ist (/data/node_modules)

Inkompatibilitäten

Wenn ein Node nicht mit der aktuellen Node-RED-Version kompatibel ist, prüfen Sie die Dokumentation des Pakets auf flows.nodered.org  und verwenden Sie gegebenenfalls eine kompatible Version.

Nächste Schritte

• Eigenes Docker Image erstellen — Detaillierte Dockerfile-Anleitung
• Verfügbare Nodes — Vorinstallierte Nodes im Enterprise Image
• Beispiele — Praktische Integrationsbeispiele