Skip to Content
AppTemplateDebugging

Debugging

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

Voraussetzungen

  • VSCode  mit der im Repository enthaltenen Launch-Konfiguration
  • Laufende Docker-Container (docker compose up)

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, die beim Start von Node-RED auftreten, kann der --inspect-brk Modus aktiviert werden. Dabei pausiert Node-RED sofort beim Start 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"
PluginsKonfiguration