Penstock

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.

Free Ansehen, der Plan und der Bericht sind kostenlos. Umwandeln, Worker-Skelette und die Äquivalenzprüfung brauchen Pro, und Team in einer Pipeline.

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

TeilTarif
Analyse: was nicht übernommen wird, warum, was zu tun ist, wer es tutFree
Der Migrationsbericht, als Markdown und als eine HTML-SeiteFree
Umwandeln eines Diagramms, einer Entscheidung oder eines Formulars, mit der VorschauPro, Team in einer Pipeline
Job-Worker-Skelette, aus Ihren Delegates geschriebenPro
Der Migrations-Arbeitsbereich und penstock migrate plan: jede Änderung, mit einer Klasse und einem GrundFree
Nur die angenommenen Änderungen schreiben (migrate apply --write)Pro
penstock migrate verify: dieselben Szenarien auf beiden Engines, verglichenPro, Team in einer Pipeline. Die ersten 3 Szenarien sind kostenlos.
penstock migrate agents: KI-Agenten auf die Vorlagen von 8.10Vorschau kostenlos, die ersten 3 Elemente. --write: Pro

Sehen, was nicht übernommen wird

  1. Öffnen Sie ein Camunda-7-Diagramm.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
Ein Camunda-7-Diagramm mit gedrückten Buttons Check und Migrate to Camunda 8. Drei Script-Tasks sind mit einer gestrichelten blauen Linie umrandet. Der Tab Problems zeigt No problems found und hat die Gruppe Migrate to Camunda 8, einen Button Convert, 3 to do, 7 convert unchanged und drei Befunde The groovy script cannot run in Camunda 8
Die Migrationsgruppe im Tab Problems, mit einem Button Convert rechts, der Anzahl darunter und den Befunden darunter. Die Tasks, die Arbeit brauchen, sind auf der Arbeitsfläche umrandet.

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 Ordner camunda-8 neben 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.5 bis 8.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 DateiBedeutung
ReadyNichts zu tun.
ConvertsPenstock wandelt sie um. Was übrig bleibt, ist zu prüfen.
Needs workEin Mensch muss einen Teil davon machen.
BlockedSie nutzt etwas, wofür Camunda 8 keine Entsprechung hat.
Ein Befund ist markiert alsBedeutung
ConvertsPenstock wandelt es exakt um.
To checkPenstock wandelt es um. Ein Mensch prüft das Ergebnis. Der Befund bleibt nach dem Umwandeln bestehen.
To doPenstock 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.

OptionWas sie tut
--target <version>Die Camunda-8-Version, gegen die geprüft wird, standardmäßig 8.8.
--format text|json|sarif|githubDie 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|warningWas den Exit-Code 1 auslöst. Fehler immer. Mit warning auch eine Warnung.
--baseline, --update-baselineNur 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.
--verboseListet auch die Hinweise, also das, was nur unverändert übernommen wird.

Was geprüft 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 umgewandeltDas Ergebnis bedeutet dasselbe.
Umgewandelt mit geänderter BedeutungPenstock wandelt es um; Sie entscheiden, ob die neue Bedeutung stimmt.
Braucht einen MenschenEs lässt sich nicht exakt umwandeln.
Unverändert gelassenEs 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

  1. 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.
  2. 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-8 neben dem umgewandelten Ordner, und Sie können ihn dort und mit --out ändern. Noch wird nichts geschrieben.
  3. 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 der engine: camunda-8 steht.
  4. 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:

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

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.