Konfiguration

Docker Compose Varianten

Alle Services starten


docker compose up

Nur Infrastruktur


docker compose up -d postgres engine authority whodb

Nur LowCode


docker compose up -d postgres engine authority whodb lowcode

Nur AppSDK


APPSDK_SAMPLE_PORT=3000 docker compose up -d postgres engine authority whodb appsdk_sample

AppSDK mit benutzerdefiniertem Port


APPSDK_SAMPLE_PORT=3003 docker compose up -d

Umgebungsvariablen

LowCode-Service

Variable	Beschreibung	Standardwert
`NODE_OPTIONS`	Node.js Optionen (Debugging)	`--inspect=0.0.0.0:9229 --enable-source-maps`
`_NODERED_AUTH_DISABLED`	Authentifizierung deaktivieren	`true` (Entwicklung)
`NODERED_CUSTOM_SETTINGS_PATH`	Pfad zu Custom Settings	`/lowcode/src/custom_settings.js`
`NODERED_FLOW_STORAGE_OUTPUT_FORMAT`	Flow-Speicherformat	`yaml`

AppSDK-Service

Variable	Beschreibung	Standardwert
`PROCESSCUBE_ENGINE_URL`	Engine-URL	`http://engine:8000`
`PROCESSCUBE_AUTHORITY_URL`	Authority-URL	`http://authority:11560`
`PROCESSCUBE_EXTERNAL_TASK_WORKER_CLIENT_ID`	OAuth2 Client-ID für Worker	`external_task_worker`
`PROCESSCUBE_EXTERNAL_TASK_WORKER_CLIENT_SECRET`	OAuth2 Client-Secret für Worker	`external_task_worker_secret`
`APPSDK_SAMPLE_PORT`	Port der AppSDK-App	`3000`

Engine-Service

Variable	Beschreibung	Standardwert
`engine__database__dialect`	Datenbank-Typ	`postgres`
`engine__database__host`	Datenbank-Host	`postgres`
`engine__processModelSeedDir`	BPMN-Seed-Verzeichnis	`/processes/`

Authority-Service

Die Authority-Konfiguration befindet sich in .processcube/authority/config/ mit User-Seeding-Daten und OIDC-Einstellungen.

Custom Settings (LowCode)

Die Datei apps/lowcode/src/custom_settings.js konfiguriert Node-RED:


module.exports = {
  editorTheme: {
    page: {
      title: "LowCode AppTemplate"
    },
    palette: {
      categories: [
        'MyProject', 'subflows', 'common', 'function',
        'network', 'sequence', 'parser', 'storage'
      ]
    }
  },
  functionGlobalContext: {
    os: require('os')
  }
}

Einstellung	Beschreibung
`editorTheme.page.title`	Titel des Node-RED Editors
`editorTheme.palette.categories`	Reihenfolge der Palette-Kategorien (eigene zuerst)
`functionGlobalContext`	Module, die in Function-Nodes global verfügbar sind

Flow-Speicherformat

Das AppTemplate verwendet YAML als Speicherformat für Flows:


NODERED_FLOW_STORAGE_OUTPUT_FORMAT: yaml

YAML bietet gegenüber JSON bessere Lesbarkeit und eignet sich besser für Versionskontrolle mit Git.

next.config.ts (AppSDK)


import { withApplicationSdk } from '@5minds/processcube_app_sdk/server';
 
const nextConfig = {
  serverExternalPackages: ['esbuild'],
};
 
export default withApplicationSdk(nextConfig);

withApplicationSdk() — Aktiviert External Task Worker Auto-Discovery
serverExternalPackages: ['esbuild'] — Pflicht für native Module

Nächste Schritte

Debugging — VSCode Debugging einrichten
CI/CD — GitHub Actions Workflow