Skip to content

docs: known limitations of the state machines - #229

Merged
wolf4ood merged 1 commit into
eclipse-edc:mainfrom
wolf4ood:docs/state_machines_known_limitations
Oct 20, 2026
Merged

wolf4ood merged 1 commit into
eclipse-edc:mainfrom
wolf4ood:docs/state_machines_known_limitations

Conversation

@wolf4ood

Copy link
Copy Markdown
Contributor

What this PR changes/adds

  • Tuning: the "State Machines" section gets new subsections:
    • Lease duration: the three lease-duration settings, their PT60S default, and how to size them.
    • Task-based state machine (NATS): the retry settings (no maximum delay), the provisioning of the streams and
      consumers in production (persistent storage, MaxAckPending, ack wait), and the SQL task store with several
      replicas.
    • A link to the new page.
  • New page for-adopters/control-plane/state-machines: the accepted limitations of the poll-based and task-based
    state machines. Each one covers what happens, when, the impact, and the mitigation where there is one.

Why it does that

The hardening of the state machines (eclipse-edc/Connector#6105, eclipse-edc/Connector#6116) fixed most of the issues
found and accepted the others as "Informative". Several of these are operating guidance, so they are documented
instead of being kept only in closed issues. The page can be updated as items get fixed, e.g. head-of-line blocking
once the batch is processed by a pool of workers.

Further notes

List other areas of code that have changed but are not necessarily linked to the main feature. This could be method
signature changes, package declarations, bugs that were encountered and were fixed inline, etc.

Who will sponsor this feature?

Please @-mention the committer that will sponsor your feature.

Linked Issue(s)

Closes # <-- insert Issue number if one exists

Please be sure to take a look at the contributing guidelines and our etiquette for pull requests.

@wolf4ood
wolf4ood marked this pull request as ready for review October 20, 2026 09:55
@wolf4ood
wolf4ood requested a review from a team as a code owner October 20, 2026 09:55
@wolf4ood
wolf4ood merged commit a758366 into eclipse-edc:main Oct 20, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants