Engine-Verbindung
Das ProcessCube® Studio kann mit beliebig vielen Engine-Instanzen verbunden werden. Dies ermöglicht die Arbeit mit verschiedenen Umgebungen (Entwicklung, Test, Produktion) aus einem Studio heraus.
Übersicht
Studio-interne Engine
Das Studio wird mit einer integrierten Engine ausgeliefert, die automatisch beim Start gestartet wird:
- URL:
http://localhost:8000 - Automatische Verbindung: Wird beim Studio-Start automatisch verbunden
- Verwendung: Lokale Entwicklung und Tests
- Isolation: Komplett isoliert von anderen Engines
Diese integrierte Engine ist ideal für die Entwicklung und das Testen von Prozessen, ohne eine separate Engine-Instanz aufsetzen zu müssen.
Externe Engines
Zusätzlich zur integrierten Engine können Sie beliebig viele externe Engine-Instanzen verbinden:
- Remote Engines: Verbindung zu Engines in der Cloud oder auf anderen Servern
- Team-Engines: Gemeinsame Engine für Teamarbeit
- Produktiv-Engines: Deployment direkt auf Produktivsysteme
- Test-Umgebungen: Separate Engines für verschiedene Test-Stages
Weitere Engines verbinden
So verbinden Sie eine zusätzliche Engine mit dem Studio:
Connections Panel öffnen
Öffnen Sie das Connections Panel in der linken Seitenleiste des Studios.
Neue Engine hinzufügen
Klicken Sie auf das Plus-Symbol (+) im Connections Panel.
Engine-URL eingeben
Geben Sie die vollständige URL der Engine ein:
http://localhost:8000oder für Remote-Engines:
https://engine.example.comDie URL muss mit http:// oder https:// beginnen und auf die Root-URL der Engine zeigen.
Verbindung testen
Nach Eingabe der URL testet das Studio automatisch die Verbindung zur Engine. Bei erfolgreicher Verbindung wird die Engine in der Liste angezeigt.
Engine auswählen
Wenn mehrere Engines mit dem Studio verbunden sind, können Sie auswählen, auf welche Engine Sie deployen möchten:
Engine-Dropdown
Im oberen rechten Bereich des Studios, direkt neben dem Deploy-Button, finden Sie ein Dropdown-Menü mit allen verbundenen Engines.
Dropdown öffnen
Klicken Sie auf das Engine-Dropdown neben dem Deploy-Button.
Engine auswählen
Wählen Sie die gewünschte Engine aus der Liste aus.
Deployment durchführen
Alle nachfolgenden Deployments werden auf die ausgewählte Engine durchgeführt.
Stellen Sie sicher, dass die richtige Engine ausgewählt ist, bevor Sie Prozesse deployen. Ein falsches Deployment auf eine Produktiv-Engine kann zu unerwünschten Effekten führen.
Engine-Verwaltung
Engine umbenennen
Engines können für eine bessere Übersicht umbenannt werden:
- Öffnen Sie das Connections Panel
- Klicken Sie auf das Bearbeiten-Symbol (Stift) neben der Engine
- Geben Sie einen neuen Namen ein (z.B. “Entwicklung”, “Test”, “Produktion”)
- Speichern Sie die Änderung
Engine entfernen
So entfernen Sie eine Engine-Verbindung:
- Öffnen Sie das Connections Panel
- Klicken Sie auf das Entfernen-Symbol (Mülleimer) neben der Engine
- Bestätigen Sie die Entfernung
Das Entfernen einer Engine-Verbindung löscht keine Daten auf der Engine selbst. Es entfernt nur die Verbindung im Studio.
Verbindungsstatus
Das Studio zeigt den Verbindungsstatus für jede Engine an:
- Grün (Verbunden): Engine ist erreichbar und funktioniert
- Gelb (Warnung): Verbindung hat Probleme
- Rot (Nicht verbunden): Engine ist nicht erreichbar
- Grau (Unbekannt): Verbindungsstatus wird noch ermittelt
Authentifizierung
Authentifizierung erforderlich
Wenn eine Engine Authentifizierung erfordert, müssen Sie sich anmelden:
Login-Dialog öffnen
Klicken Sie auf den Sign In-Button in der Engine-Ansicht.
Authentifizierung durchführen
Je nach Engine-Konfiguration stehen verschiedene Authentifizierungsmethoden zur Verfügung:
- Authority Login: Anmeldung über ProcessCube® Authority
- OAuth/OIDC: Anmeldung über externe Identity Provider
- Basic Auth: Benutzername und Passwort
Token-Verwaltung
Das Studio speichert Authentifizierungs-Token sicher und erneuert sie automatisch bei Bedarf.
Für die studio-interne Engine ist der Standard-Benutzer admin mit Passwort admin konfiguriert.
OAuth konfigurieren
Über die Schaltfläche Configure OAuth können Sie OAuth-Einstellungen anpassen:
- Client ID: ID der OAuth-Anwendung
- Scopes: Angefragte Berechtigungen
- Response Type: OAuth Response Type (meist
code)
Die Standardkonfiguration funktioniert mit der ProcessCube® Authority und sollte für die meisten Fälle ausreichen.
Mehrere Prozesse deployen
Das Studio unterstützt das gleichzeitige Deployment mehrerer Prozessmodelle auf eine Engine:
Prozesse auswählen
Wählen Sie im Explorer mehrere BPMN-Dateien aus (Strg/Cmd + Klick).
Multi-Deploy durchführen
Klicken Sie auf den Deploy-Button oder verwenden Sie das Kontextmenü Deploy Selected.
Deployment überwachen
Das Studio zeigt den Deployment-Status für jede Datei einzeln an.
Best Practices
Namenkonventionen
Verwenden Sie eindeutige Namen für Ihre Engine-Verbindungen:
- Entwicklung - Lokale Engine für Entwicklung
- Test-Team - Gemeinsame Test-Engine
- Staging - Pre-Production Umgebung
- Produktion - Produktiv-Engine
Farbkodierung
Nutzen Sie Custom Themes, um verschiedene Umgebungen visuell zu unterscheiden (z.B. roter Hintergrund für Produktiv-Engine).
Deployment-Strategie
- Lokal entwickeln: Nutzen Sie die studio-interne Engine für Entwicklung
- Team testen: Deployen Sie auf eine gemeinsame Test-Engine
- Staging validieren: Testen Sie auf einer Staging-Umgebung
- Produktion deployen: Deployen Sie nur getestete Prozesse auf Produktion
Sicherheit
Wichtige Sicherheitshinweise:
- Nutzen Sie sichere Verbindungen (HTTPS) für Remote-Engines
- Verwenden Sie starke Authentifizierung für Produktiv-Engines
- Speichern Sie keine Produktiv-Credentials im Studio
- Trennen Sie Entwicklungs- und Produktiv-Umgebungen
Troubleshooting
Engine nicht erreichbar
Problem: Engine wird als “Nicht verbunden” angezeigt
Lösungen:
- Prüfen Sie die URL auf Tippfehler
- Stellen Sie sicher, dass die Engine läuft
- Prüfen Sie Firewall-Einstellungen
- Testen Sie die Verbindung im Browser
Authentifizierung fehlgeschlagen
Problem: Login schlägt fehl
Lösungen:
- Prüfen Sie Benutzername und Passwort
- Stellen Sie sicher, dass der Benutzer existiert
- Prüfen Sie OAuth-Konfiguration
- Erneuern Sie abgelaufene Tokens
Deployment schlägt fehl
Problem: Prozess kann nicht deployed werden
Lösungen:
- Prüfen Sie, ob die richtige Engine ausgewählt ist
- Stellen Sie sicher, dass Sie authentifiziert sind
- Validieren Sie das BPMN-Diagramm
- Prüfen Sie Engine-Logs für Fehler
Weitere Informationen
- Getting Started - Installation und erste Schritte
- ProcessCube® Engine - Engine-Dokumentation
- Authority Integration - Authentifizierung konfigurieren
- Extensions - Studio erweitern