Skip to content

Say that retina-tracker also runs on every node - #30

Merged
Babissimo merged 1 commit into
mainfrom
docs/architecture-tracker-sidecar
Sep 24, 2026
Merged

Babissimo merged 1 commit into
mainfrom
docs/architecture-tracker-sidecar

Conversation

@Babissimo

Copy link
Copy Markdown
Contributor

docs/architecture.md said retina-tracker is never deployed standalone and runs only inside the central server. That has been wrong for some time: every node runs it as a sidecar in retina-node's compose, fed by blah2_api on loopback :30100.

Since node API 1.6.0 (retina-server #563, #568, #570, #574), a node can send those tracks on the detection frame. The server can then use them in place of its in-process copy for that node, behind NODE_TRACKS_MODE, which is off everywhere until the fleet cut-over.

This PR changes:

  • the tracker's component entry;
  • its row in the repo table;
  • the node-stack diagram in §1.

The rest of §2 predates the v1 HTTPS node API and is not touched here.

🤖 Generated with Claude Code

The architecture doc said retina-tracker is never deployed standalone and
runs only inside the central server. Every node has run it as a sidecar in
retina-node's compose for some time, and since node API 1.6.0 a node can
send those tracks to the server, which can use them in place of its own
in-process copy per node. A reader planning tracker work from this doc would
miss half the deployments, and the half that is about to take over.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Babissimo
Babissimo merged commit accead4 into main Sep 24, 2026
2 checks passed
@Babissimo
Babissimo deleted the docs/architecture-tracker-sidecar branch September 24, 2026 13:40
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.

1 participant