Skip to Content
AppTemplateDebugging

Debugging

LowCode (Node-RED)

Das AppTemplate unterstützt VSCode-Debugging direkt im Docker-Container über den Node.js Inspector auf Port 9229.

Debugging starten

  1. Container starten:
docker compose up
  1. In VSCode: Run and Debug (Ctrl+Shift+D) öffnen
  2. Konfiguration “Attach to Node-RED” auswählen
  3. Debugger starten (F5)

VSCode Launch-Konfiguration

Die Datei .vscode/launch.json enthält die Debugging-Konfiguration:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Node-RED",
      "address": "localhost",
      "port": 9229,
      "localRoot": "${workspaceFolder}/apps/lowcode/src",
      "remoteRoot": "/package_src/",
      "smartStep": true,
      "sourceMaps": true,
      "resolveSourceMapLocations": [
        "${workspaceFolder}/**",
        "!**/node_modules/**"
      ]
    }
  ]
}

Breakpoints setzen

Breakpoints können in allen Dateien unter apps/lowcode/src/ gesetzt werden:

  • Custom Nodes — nodes/sample_node/hello.js
  • Plugins — nodes/aplugin/sample_plugin.js
  • UI-Widget Backends — nodes/ui-hello.js, nodes/ui-termo.js

Break-on-Start Debugging

Für Probleme beim Start von Node-RED den --inspect-brk Modus aktivieren — Node-RED pausiert sofort und wartet auf den Debugger.

In der docker-compose.yml die entsprechende Zeile einkommentieren:

environment:
  # Standard-Debug-Modus
  NODE_OPTIONS: "--inspect=0.0.0.0:9229 --enable-source-maps"
  # Break-on-Start (statt obiger Zeile verwenden)
  # NODE_OPTIONS: "--inspect-brk=0.0.0.0:9229 --enable-source-maps"

Docker-Konfiguration

Der Debug-Port wird in der docker-compose.yml für den LowCode-Service konfiguriert:

lowcode:
  ports:
    - "1880:1880"   # Node-RED Editor
    - "9229:9229"   # Debugger
  environment:
    NODE_OPTIONS: "--inspect=0.0.0.0:9229 --enable-source-maps"

AppSDK (Next.js)

Die AppSDK-App nutzt die Standard-Debugging-Werkzeuge von Next.js.

Lokale Entwicklung

Für Debugging ohne Docker die App lokal starten:

cd apps/appsdk_sample
npm install
npm run dev

Für lokale Entwicklung die .env.local auf localhost-URLs anpassen (siehe .env.local.example).

Server Actions debuggen

Server Actions (actions.ts) können über console.log oder den Node.js Debugger analysiert werden:

cd apps/appsdk_sample
NODE_OPTIONS='--inspect' npm run dev

Dann in VSCode: JavaScript Debug Terminal oder Attach to Node.js (Port 9229).

Nächste Schritte

  • Konfiguration — Umgebungsvariablen und Einstellungen
  • CI/CD — GitHub Actions Workflow
Docker & ServicesCI/CD