Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support process instance migration with active user tasks #3311

Merged
merged 6 commits into from
Feb 13, 2024

Conversation

korthout
Copy link
Member

@korthout korthout commented Feb 12, 2024

Description

Zeebe and Operate 8.5.0-alpha1 support the migration of process instances with active user tasks.

Both task implementations are supported:

  • Job worker
  • Zeebe user task

Mapping instructions cannot change the task implementation.

All values of a job or a 'zeebe user task' are left unchanged after migration.

closes camunda/camunda#15964

When should this change go live?

  • This change is not yet live and should not be merged until {ADD_DATE} (apply hold label or convert to draft PR)?
  • There is no urgency with this change.
  • This change or page is part of a marketing blog, conference talk, or something else on a schedule.
  • This functionality is already available but undocumented.
  • This is a bug fix or security concern.

PR Checklist

  • I have added changes to the relevant /versioned_docs directory, or they are not for an already released version.
  • I have added changes to the main /docs directory (aka /next/), or they are not for future versions.
  • My changes require an Engineering review, and I've assigned an engineering manager or tech lead as a reviewer, or my changes do not require an Engineering review.
  • My changes require a technical writer review, and I've assigned @christinaausley as a reviewer, or my changes do not require a technical writer review.

Zeebe 8.5.0-alpha1 support migration of user tasks. Regardless of
implementation type (job worker or zeebe user task).
Process instance migrations that attempt to change the implementation of
a task (for example from a job worker user task to a zeebe user task)
are rejected by Zeebe.
The values of a zeebe user task don't change on migration.
As static values are defined by the Expressions concept page as
something different from expressions, we should explicitly highlight
that static values are also left unchanged after migrations.
@korthout korthout added component:zeebe Issues related with Zeebe project component:docs Documentation improvements, including new or updated content 8.5.0-alpha1 labels Feb 12, 2024
@korthout korthout self-assigned this Feb 12, 2024
Copy link
Contributor

👋 🤖 🤔 Hello! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.4/.

  • docs/apis-tools/zeebe-api/gateway-service.md
  • docs/components/concepts/process-instance-migration.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

Copy link
Contributor

@christinaausley christinaausley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🏁

berkaycanbc
berkaycanbc previously approved these changes Feb 12, 2024
Copy link
Contributor

@berkaycanbc berkaycanbc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@korthout LGTM! 🚀

I added one suggestion, feel free to apply or skip it. 👍

@@ -152,6 +154,7 @@ The following limitations exist that may be supported in future versions:
- An element that becomes nested in a newly added sub-process
- An element that was nested in a sub-process is no longer nested in that sub-process
- Mapping instructions cannot change the element type
- Mapping instructions cannot change the task implementation
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔧 @korthout Would be good if we give and explanation of this. We can say something similar to "e.g. user task implementations (zeebe user task and job based user task)".

berkaycanbc
berkaycanbc previously approved these changes Feb 12, 2024
@korthout
Copy link
Member Author

@christinaausley Please have another look, and feel free to merge it

@christinaausley christinaausley enabled auto-merge (squash) February 13, 2024 12:31
@christinaausley christinaausley merged commit 1bdb0cb into main Feb 13, 2024
6 checks passed
@christinaausley christinaausley deleted the korthout-15964-migrate-user-tasks branch February 13, 2024 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:docs Documentation improvements, including new or updated content component:zeebe Issues related with Zeebe project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Support User Tasks in Documentation
3 participants