Troubleshooting

Haeufige Probleme beim Arbeiten mit dem AppTemplate und deren Loesungen.

Docker & Container

Container starten nicht / Healthcheck fehlgeschlagen

Die Services haben eine definierte Startreihenfolge. PostgreSQL muss bereit sein, bevor Engine und Authority starten.

# Status aller Container pruefen
docker compose ps
 
# Logs eines bestimmten Services anzeigen
docker compose logs engine
docker compose logs authority

Port-Konflikte

Falls ein Port bereits belegt ist:

# Pruefen, welcher Prozess den Port belegt
lsof -i :8000
 
# AppSDK mit alternativem Port starten
APPSDK_SAMPLE_PORT=3003 docker compose up

Datenbank zuruecksetzen

Falls die Datenbank in einen inkonsistenten Zustand geraet:

docker compose down -v
docker compose up

LowCode / Node-RED

Custom Nodes erscheinen nicht in der Palette

1. Pruefen, ob die Nodes in package.json unter node-red.nodes registriert sind
2. LowCode-Image neu bauen: docker compose build lowcode
3. Container neu starten: docker compose up -d lowcode

Dashboard-Widgets werden nicht angezeigt

1. Widget muss in package.json unter node-red.plugins registriert sein
2. Vite-Build ausfuehren: cd apps/lowcode/src && npm run build
3. Image neu bauen: docker compose build lowcode

AppSDK / Next.js

MODULE_NOT_FOUND beim Start

Abhaengigkeiten muessen installiert sein, bevor das Docker-Image gebaut wird:

cd apps/appsdk_sample
npm install
docker compose build appsdk_sample

Authentifizierung schlaegt fehl

Pruefen, ob die Umgebungsvariablen korrekt gesetzt sind:

External Task Worker verbindet sich nicht

1. Pruefen, ob withApplicationSdk({ useExternalTasks: true }) in next.config.ts gesetzt ist
2. Worker-Credentials muessen in der Authority konfiguriert sein
3. Logs pruefen: docker compose logs appsdk_sample

Fuer Details zur External-Task-Konfiguration siehe External Tasks.

Allgemein

Aenderungen werden nicht uebernommen

Nach Aenderungen am Quellcode muss das Docker-Image neu gebaut werden:

# Einzelnes Image neu bauen
docker compose build lowcode
docker compose build appsdk_sample
 
# Alle Images neu bauen
docker compose build

Fuer schnellere Entwicklung ohne Docker siehe Debugging.