Versioning: VERSION file + automatic patch tags + promote to v1; updater compares versions numerically #49

New Issue

2026-11-09T00:31:27-05:00

logan commented

2026-11-09 00:31:27 -05:00

Owner ruling 2026-11-09: version releases instead of moving a bare v1 tag by hand. We start at 1.1.0.

VERSION file (MAJOR.MINOR) in each repo, edited by hand for a minor or major bump.
Patch is automatic. Every push to main gets tagged vMAJOR.MINOR.PATCH, where PATCH is one more than the highest existing patch for that MAJOR.MINOR, compared as integers.
Channels.
- updater REF=latest follows the highest semver tag (test nodes, e.g. node-002).
- REF=v1 follows the major tag, which only the Promote workflow moves (customer nodes).
Updater installs automatically when the target's version is numerically greater than the installed one (1.10.0 > 1.9.3; never compared as strings or floats). It never downgrades and writes DRB_VERSION to .env.
Reporting. The node reports its version in checkin. C2 stores it, and /health reports the server version.

Owner ruling 2026-11-09: version releases instead of moving a bare `v1` tag by hand. We start at 1.1.0. - **VERSION file** (MAJOR.MINOR) in each repo, edited by hand for a minor or major bump. - **Patch is automatic.** Every push to main gets tagged `vMAJOR.MINOR.PATCH`, where PATCH is one more than the highest existing patch for that MAJOR.MINOR, compared as integers. - **Channels.** - updater `REF=latest` follows the highest semver tag (test nodes, e.g. node-002). - `REF=v1` follows the major tag, which only the Promote workflow moves (customer nodes). - **Updater** installs automatically when the target's version is numerically greater than the installed one (1.10.0 > 1.9.3; never compared as strings or floats). It never downgrades and writes DRB_VERSION to .env. - **Reporting.** The node reports its version in checkin. C2 stores it, and /health reports the server version.

logan added the

area/node-ota labels 2026-11-09 00:31:37 -05:00

logan commented

2026-11-09 00:59:04 -05:00

Shipped in node-26 5549736 and server-26 b7cdb44. Both repos are tagged v1.1.0 by CI, and prod /health reports version 1.1.0. Still to do by hand: switch node-002 to REF=latest in /etc/drb/updater.conf (needs sudo), and run Promote release with 1.1.0 so customer nodes get it.

Shipped in node-26 5549736 and server-26 b7cdb44. Both repos are tagged v1.1.0 by CI, and prod /health reports version 1.1.0. Still to do by hand: switch node-002 to REF=latest in /etc/drb/updater.conf (needs sudo), and run Promote release with 1.1.0 so customer nodes get it.

logan removed the

priority

p2

label 2026-11-09 00:59:05 -05:00

logan closed this issue

2026-11-09 00:59:05 -05:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: logan/node-26#49