Skip to content

docs: document the project node limitations - #8071

Open
dimitrieh wants to merge 1 commit into
mainfrom
docs/project-nodes-limitations
Open

docs: document the project node limitations#8071
dimitrieh wants to merge 1 commit into
mainfrom
docs/project-nodes-limitations

Conversation

@dimitrieh

Copy link
Copy Markdown
Contributor

The page presents calling a shared instance's flows as the headline use case for these nodes, but states none of the constraints a builder hits.

Adds a Limitations section covering:

  • only hosted instances can be named as a target or a specific source
  • a remote instance can send and receive broadcasts, but can never be sent to directly, so shared logic has to live on a hosted instance
  • a call waits 30 seconds for a target that must be running with a matching Project In node, and travels through the broker, so it is unavailable to a caller that is offline
  • load is shared between copies only in HA mode, via shared subscriptions

Also fixes "links to extended" and the implication that remote instances are symmetric peers.

Paired with FlowFuse/nr-project-nodes#255, which puts the same facts in the node help and the error messages.

The page presents calling a shared instance's flows as the headline use case
without stating that only hosted instances can be addressed directly, that a
remote instance can send but never receive, or that a call waits 30 seconds for
a target that has to be running. Also fixes a typo and the implication that
remote instances are symmetric peers.
@dimitrieh

Copy link
Copy Markdown
Contributor Author

Small fix, based on research done into link nodes resuling in that we can better inform users of link nodes needing logic to reside on hosted instances

Slack thread: https://flowfuse.slack.com/archives/C03FAUBPPJ7/p1785930859746159?thread_ts=1785861957.912329&cid=C03FAUBPPJ7

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.

3 participants