Guide / Share and move
Camunda 7 auf Camunda 8
Der Migrationsassistent zeigt, was in Ihrem Camunda-7-Projekt nicht auf Camunda 8 übernommen wird, wandelt um, was er kann, und schreibt einen Bericht, den Sie weitergeben können.
Warum und für wen
Camunda 7 Community Edition hat das Ende ihrer Lebensdauer erreicht. Ein Team, das sie nutzt, muss entscheiden, ob es auf Camunda 8 umsteigt, und es dann umsetzen: die Diagramme, die Entscheidungen, die Formulare und den Java-Code dahinter. Der Assistent übernimmt das Lesen und den Großteil des Umwandelns, in Ihrem Tool, neben dem Code.
Er funktioniert mit Projekten für Camunda 7, Operaton und CIB seven. Beide Forks werden als Camunda-7-Quelle gelesen, weil ihre Diagramme denselben Namespace camunda: verwenden.
Was kostenlos ist und was Pro
| Teil | Tarif |
|---|---|
| Analyse: was nicht übernommen wird, warum, was zu tun ist, wer es tut | Free |
| Der Migrationsbericht, als Markdown und als eine HTML-Seite | Free |
| Umwandeln eines Diagramms, einer Entscheidung oder eines Formulars, mit der Vorschau | Pro, Team in einer Pipeline |
| Job-Worker-Skelette, aus Ihren Delegates geschrieben | Pro |
Der Migrations-Arbeitsbereich und penstock migrate plan: jede Änderung, mit einer Klasse und einem Grund | Free |
Nur die angenommenen Änderungen schreiben (migrate apply --write) | Pro |
penstock migrate verify: dieselben Szenarien auf beiden Engines, verglichen | Pro, Team in einer Pipeline. Die ersten 3 Szenarien sind kostenlos. |
penstock migrate agents: KI-Agenten auf die Vorlagen von 8.10 | Vorschau kostenlos, die ersten 3 Elemente. --write: Pro |
Sehen, was nicht übernommen wird
- Öffnen Sie ein Camunda-7-Diagramm.
- Klicken Sie in der Werkzeugleiste auf Migrate to Camunda 8. Die Aktion ist bei Diagrammen für Camunda 7, Operaton und CIB seven angeheftet. Sie lässt sich lösen und liegt dann im Menü More.
- Der Tab Problems der Seitenleiste öffnet sich bei seiner Gruppe Migrate to Camunda 8. Dort steht zum Beispiel 7 to do, 3 to check, 19 convert unchanged. Klicken Sie erneut auf Migrate to Camunda 8, um sie zu schließen.
- Lesen Sie die Gruppen, jede mit ihrer Anzahl: Needs work (ein Mensch muss es tun), Review after converting (Penstock wandelt es um, Sie prüfen es) und, eingeklappt, Convert unchanged für das, was sich exakt umwandeln lässt. Ein Diagramm ohne Probleme in den anderen Gruppen zeigt oben im Tab trotzdem No problems found.
- Klicken Sie auf eine Zeile. Das Element wird auf der Arbeitsfläche ausgewählt. Jede Zeile sagt, was falsch ist, warum und was zu tun ist.

Die Gruppe betrachtet ein Diagramm. Für das ganze Projekt, alle Dateien auf einmal, listet Penstock jede Datei mit ihrem Status (ready, converts, needs work, blocked) und ihren Befunden, dazu den Java-Code mit dem, was aus jeder Klasse wird.
Ein ganzes Projekt migrieren
JetBrains
Öffnen Sie das Penstock-Tool-Fenster, und suchen Sie Migrate to Camunda 8. Dort steht jede Datei mit ihrem Status und ihren Befunden und der Java-Code mit dem, was aus jeder Klasse wird. Klicken Sie mit der rechten Maustaste auf eine Datei und wählen Sie Convert to Camunda 8…, oder nutzen Sie Convert All… auf dem Stammknoten.
VS Code
Nicht verfügbar in VS Code. Die Umwandlung von Camunda 7 auf Camunda 8 ist in VS Code noch nicht verfügbar, ebenso wenig die Projektliste, die sie zeigt. Nutzen Sie penstock migrate auf der Befehlszeile.
Command line
$ penstock migrate .
ready src/main/resources/approve-order.form 1 convert
needs work src/main/resources/order-process.bpmn 1 to do, 8 convert
error migration/message-catch: Shipment confirmed: The message shipment-confirmed needs a correlation key. ...
error migration/delegate-expression: Send receipt: Delegate ${sendReceipt} becomes the job type sendReceipt. ...
ready src/main/resources/shipping-method.dmn 1 convert
3 files to migrate for Camunda 8.8: 2 ready, 0 convert, 1 need work, 0 blocked.
Job workers to write: 2
migrate,migrate analyze: listet, was nicht übernommen wird. Exit-Code 1 bei einem Fehler oder, mit--fail-on warning, bei einer Warnung. Kostenlos.migrate convert: wandelt die Dateien um. Es schreibt die Camunda-8-Dateien in einen Ordnercamunda-8neben dem angegebenen oder nach--out <dir>und lässt die Originale, wie sie sind. Nutzen Sie zuerst--dry-run. Pro, und Team in einer Pipeline.migrate report: schreibt den Bericht. Kostenlos.--target 8.5bis8.9,--format text|json|sarif|github,--baseline,--update-baseline,--verbose.
Der umgewandelte Ordner bekommt eine eigene penstock.yaml, in der engine: camunda-8 steht, und die penstock.yaml der Camunda-7-Dateien wird nicht angefasst. Siehe Alle Befehle.
Was die Begriffe bedeuten
| Status einer Datei | Bedeutung |
|---|---|
| Ready | Nichts zu tun. |
| Converts | Penstock wandelt sie um. Was übrig bleibt, ist zu prüfen. |
| Needs work | Ein Mensch muss einen Teil davon machen. |
| Blocked | Sie nutzt etwas, wofür Camunda 8 keine Entsprechung hat. |
| Ein Befund ist markiert als | Bedeutung |
|---|---|
| Converts | Penstock wandelt es exakt um. |
| To check | Penstock wandelt es um. Ein Mensch prüft das Ergebnis. Der Befund bleibt nach dem Umwandeln bestehen. |
| To do | Penstock lässt es stehen und markiert es an seinem Element. Ein Mensch erledigt es. |
In einer Pipeline
Die Analyse läuft ohne den Editor, daher kann sie als Gate in einer Pipeline dienen, solange ein Projekt noch Camunda-7-Diagramme enthält.
| Option | Was sie tut |
|---|---|
--target <version> | Die Camunda-8-Version, gegen die geprüft wird, standardmäßig 8.8. |
--format text|json|sarif|github | Die Befunde als Tabelle, als JSON mit einer Zählung des Aufwands und den Blockern, als SARIF oder als Annotationen an den geänderten Zeilen. SARIF und Annotationen sind Pro, und Team in einer Pipeline. |
--fail-on error|warning | Was den Exit-Code 1 auslöst. Fehler immer. Mit warning auch eine Warnung. |
--baseline, --update-baseline | Nur bei dem fehlschlagen, was seit dem letzten --update-baseline neu ist; dieses schreibt penstock-migration-baseline.json ins Stammverzeichnis des Projekts. Pro, und Team in einer Pipeline. |
--verbose | Listet auch die Hinweise, also das, was nur unverändert übernommen wird. |
Was geprüft wird
- Implementierungen. Eine Java-Klasse, eine Delegate Expression, ein Ausdruck oder ein External-Task-Topic wird zu einem Job-Typ. Nichts führt diesen Job aus, solange es keinen Worker gibt, daher ist das ein Fehler, bis Sie den Worker schreiben.
- Listener. Execution- und Task-Listener werden zu Job-Typen, ab Camunda 8.6 (Execution) und ab 8.8 (Task). Frühere Zielversionen erhalten eine Markierung.
- Ausdrücke. JUEL wird zu FEEL, nur wo das Ergebnis exakt ist. Eine Ablehnung nennt ihren Grund.
- Skripte. Groovy- und JavaScript-Skripte können in Camunda 8 nicht laufen. Schreiben Sie sie als FEEL neu, oder verlagern Sie sie in einen Job Worker.
- Formulare. Generierte Formulare werden zu Camunda Forms, neben das Diagramm geschrieben, nie über ein vorhandenes Formular. Ein eingebettetes Formular hat in Camunda 8 keine Entsprechung.
- Nachrichten. Eine Nachricht braucht einen Korrelationsschlüssel.
- Aufgerufene Prozesse, Entscheidungen, Multi-Instance-Schleifen, Timer, Fehler, Wiederholungen und Prioritäten: Jedes hat eine eigene Regel, mit einem Link zur Dokumentation von Camunda.
- Der Java-Code. Jeder Delegate, jeder External-Task-Handler und jeder Listener wird bis zu seinem Quellcode verfolgt und zu dem, was aus ihm wird.
Der Migrations-Arbeitsbereich
Der Arbeitsbereich listet jede Änderung, die die Umwandlung auf Camunda 8 machen würde, pro Datei und, bei BPMN, pro Element. Jede Änderung zeigt, was jetzt da ist, was daraus wird, eine Klasse und den Grund, mit einem Kontrollkästchen, einer laufenden Zählung und einer Aufwandsschätzung.
| Automatisch umgewandelt | Das Ergebnis bedeutet dasselbe. |
| Umgewandelt mit geänderter Bedeutung | Penstock wandelt es um; Sie entscheiden, ob die neue Bedeutung stimmt. |
| Braucht einen Menschen | Es lässt sich nicht exakt umwandeln. |
| Unverändert gelassen | Es wird unverändert übernommen. |
In Penstock Web ist er in der Befehlspalette.
Wo der Migrations-Arbeitsbereich ist, je nach Tool
JetBrains
Der Migrations-Arbeitsbereich ist im Penstock-Tool-Fenster und im Menü Tools.
VS Code
Der Befehl Migration workspace.
Command line
penstock migrate plan listet die Änderungen mit ihren IDs, und penstock migrate apply --only wendet eine Auswahl an. Siehe migrate.
Apply selected schreibt nur die angenommenen Änderungen, atomar. Wie bisher lehnt es eine Datei ab, die sich geändert hat, und einen symbolischen Link. Ein abgelehntes Element bleibt Byte für Byte, wie es war. Die Auswahl wird nur dann in .penstock/migration-selection.json gespeichert, wenn Sie Save selection wählen.
penstock migrate plan --format json src/orders
penstock migrate plan --only ID1,ID2 --save-selection
penstock migrate apply --saved --write
penstock migrate apply --only ID1,ID2 --exclude ID3 --write
migrate plan listet die IDs der Änderungen und schreibt nichts, außer der Auswahl, wenn Sie --save-selection angeben. migrate apply nimmt --only, --exclude und --saved. Eine ID, die der Plan nicht kennt, eine leere Liste oder eine zu lange ID wird abgelehnt, bevor etwas geschrieben wird. Das MCP-Tool migrate_apply nimmt only und exclude.
Umwandeln
Pro
- Klicken Sie in der Gruppe Migrate to Camunda 8 des Tabs Problems auf Convert. Ihr Tool kann auch eine Datei oder alle Dateien eines Projekts umwandeln.
- Das Diagramm öffnet sich zweimal, nebeneinander, im visuellen Diagramm-Diff: vorher und nachher, jeweils zentriert in einem eigenen Bereich unter einem gemeinsamen Titel. Die Vorschau nennt auch den Ordner, in den die Camunda-8-Dateien kommen,
camunda-8neben dem umgewandelten Ordner, und Sie können ihn dort und mit--outändern. Noch wird nichts geschrieben. - Lesen Sie, was sich geändert hat, und klicken Sie dann auf Convert. Die Camunda-7-Dateien bleiben, wie sie sind, und die neuen bekommen eine eigene
penstock.yaml, in derengine: camunda-8steht. - Das Umwandeln in einen Ordner, der schon umgewandelte Dateien enthält, ist keine Sackgasse: Die Vorschau bietet Replace the files in <folder> an, mit einer Warnung, wenn der Ordner nicht unter Versionskontrolle steht, und überschreibt die Dateien nur, wenn Sie das Häkchen setzen.
Was Penstock nicht exakt umwandeln kann, bleibt in der Datei, an seinem Element markiert mit einer conversion:message, die auch der Camunda Modeler liest. Es bleibt außerdem ein Befund. Ein zweites Umwandeln ändert nichts mehr.
Job-Worker-Skelette
Pro
Jeder Java-Delegate, External-Task-Handler oder Listener wird bis zu seinem Quellcode verfolgt, mit Datei und Zeile und dem, was aus ihm wird. Penstock kann ein Skelett neben den Code schreiben: einen Spring-Job-Worker, einen Node-Worker oder einen Python-Worker. Das Skelett wird aus den Variablen geschrieben, die der Code liest und schreibt, und aus den BPMN-Fehlern, die er wirft. Penstock überschreibt nie eine Datei.
Ein Skelett in Ihrem Tool schreiben
JetBrains
Öffnen Sie im Tool-Fenster Migrate to Camunda 8 und dann Code. Klicken Sie mit der rechten Maustaste auf einen Eintrag, und wählen Sie Job Worker Skeleton… (Spring), Node Worker Skeleton… oder Python Worker Skeleton…. Pro.
VS Code
Nicht verfügbar in VS Code. Job-Worker-Skelette werden aus der JetBrains-IDE geschrieben und sind in VS Code noch nicht verfügbar. penstock migrate gibt aus, wie viele Job Worker zu schreiben sind.
Command line
Nicht verfügbar in Command line. Skelette werden aus der IDE geschrieben. penstock migrate gibt aus, wie viele Job Worker zu schreiben sind.
Der Bericht
Der Bericht ist Markdown und eine eigenständige HTML-Seite.
Den Bericht in Ihrem Tool schreiben
JetBrains
Klicken Sie im Tool-Fenster auf dem Stammknoten von Migrate to Camunda 8 auf Migration Report.
VS Code
Klicken Sie in der Penstock-Ansicht auf dem Stammknoten von Migrate to Camunda 8 auf Migration Report.
Command line
$ penstock migrate report .
wrote migration-report.md
wrote migration-report.html
Mit --out <dir> wählen Sie den Ordner.
Das HTML ist eine eigenständige Seite für eine Führungskraft: Umfang, was der Umstieg kostet (zu schreibende Job Worker, umzuschreibende Ausdrücke, zu ersetzende Skripte, zu verlagernde Listener, neu zu bauende Formulare, aufgerufene Prozesse, Entscheidungen), die Dateien mit ihrem Status und der Code.
Prüfen, ob sich der umgewandelte Prozess gleich verhält
Pro Die ersten 3 Szenarien sind kostenlos.
penstock migrate verify --original-profile c7-test --converted-profile c8-test src/orders
Es führt die gespeicherten Szenarien des Projekts auf dem ursprünglichen Camunda-7-Diagramm (oder Operaton oder CIB seven) auf einer Test-Engine aus und auf dem umgewandelten Camunda-8-Diagramm auf einer anderen. Pro Szenario meldet es:
- EQUIVALENT;
- DIFFERS, mit dem ersten Punkt, an dem die Läufe auseinandergehen, und beiden Traces;
- NOT COMPARABLE, mit dem Grund.
Es vergleicht den Pfad durch die Elemente über die ID-Zuordnung der Umwandlung, den Endzustand, die Incidents und die Variablen nach Name und Wert. Exit 0, wenn jedes Szenario äquivalent ist, 1, wenn mindestens eines abweicht, 2, wenn etwas nicht verglichen werden kann oder wegen einer Ablehnung nichts lief.
Beide Engines müssen mit deployment.forTests markiert sein. Auf einer gemeinsam genutzten Engine oder einer Produktions-Engine läuft nichts. Eine Umwandlung, die ausführbaren Inhalt hinzufügt, wird abgelehnt, bis Sie sie mit --run-unreviewed bestätigen oder mit dem Button im Arbeitsbereich, der auflistet, was hinzugefügt wurde. Werte von Secrets erscheinen nie in der Antwort. Der Arbeitsbereich zeigt jedes Ergebnis neben den Änderungen, die es betrifft, mit einem Banner mit den Summen. Das MCP-Tool migrate_verify macht dasselbe für einen Agenten.
KI-Agenten
penstock migrate agents [paths] überführt KI-Agenten-Elemente von den Vorlagenversionen 8.9 und älter auf die Vorlagen für Agent Task und Agent Sub-Process von 8.10, nach den Migrationsregeln, die die neuen Vorlagen deklarieren. Standardmäßig ist es ein Probelauf. Ein Element, dessen Zuordnung sich nicht nachweisen lässt, bleibt unverändert und wird mit dem Grund aufgelistet. Die ersten 3 Elemente der Vorschau sind kostenlos; --write ersetzt die Dateien atomar und ist Pro. Das MCP-Tool migrate_agents macht dasselbe. Siehe KI-Agenten von Camunda 8.
Was es nicht tut
- Es verschiebt keine laufenden Instanzen und keine Historie. Instanzen können auf Camunda 7 zu Ende laufen oder mit dem Data Migrator von Camunda verschoben werden. Der Data Migrator braucht unveränderte Element-IDs. Der Konverter behält sie bei.
- Es schreibt Ihren Java-Code nicht um. Nutzen Sie die OpenRewrite-Rezepte aus dem Migrationsleitfaden von Camunda in Ihrem Build, wo ein Reviewer den Diff sieht. Der Assistent schreibt neue Dateien neben den alten Code.
- Es rät nie. Was es nicht exakt umwandeln kann, markiert es.
Häufige Probleme
- Es gibt keinen Button Migrate to Camunda 8.
- Er erscheint bei Diagrammen für Camunda 7, Operaton und CIB seven. Ein Diagramm für Camunda 8 oder Classic BPMN hat keinen. Die Gruppe sagt Nothing to convert: this is not a Camunda 7 diagram.
- Convert fordert mich auf, Pro zu kaufen.
- Umwandeln ist eine Pro-Funktion. Die Analyse und der Bericht sind kostenlos. Siehe Tarife und Lizenz.
- Nach dem Umwandeln listet die Prüfung immer noch Befunde.
- Das sind die, die ein Mensch erledigen oder prüfen muss. Sie bleiben an ihrem Element, bis Sie sie beheben.
- „Unknown target“.
- Verwenden Sie 8.5, 8.6, 8.7, 8.8 oder 8.9.
- „There is nothing to migrate“.
- Im angegebenen Pfad wurde kein Camunda-7-Diagramm, keine Entscheidung und kein Formular gefunden.