Skip to content

v0.24.0 - Cluster control plane, seed discovery, and replica pairing

Choose a tag to compare

@github-actions github-actions released this 14 Nov 22:32

Highlights

  • Replicate the cluster control plane: auth registry, backup jobs/state,
    database catalog, and cluster peer token.
  • Store node-local replication state (role, source, epoch, lease, peer token,
    pairing codes) in the hidden .node LMDB system collection. Legacy JSON
    files are imported once and removed.
  • Rediscover the current primary through NONODB_REPLICATION_SEEDS, voters,
    and followers after the stored source becomes unreachable.
  • Persist replica pairing codes, keep them one-time and short-lived (10 minutes),
    and expose pairing in both CLI and GUI.
  • Use the primary's actual Write URL in the GUI Add replica panel instead of
    hardcoding the GUI proxy port. Added end-to-end screenshots and a step-by-step
    replica enrollment guide.
  • Harden quorum lease/failover, divergent replica resync, partition recovery,
    and encrypted vault envelope replication.
  • Fix nonodb-cli replication add-replica output to print the effective join
    URL and warn that the default daemon API port is 7878, not GUI proxy 8787.

Upgrade notes

  • Back up NONODB_DATA before upgrading.
  • .node is node-local: do not copy it to another node.
  • Set NONODB_REPLICATION_SEEDS on replicas for primary rediscovery.
  • replication join uses the daemon API URL (default port 7878), not the GUI
    proxy port (default 8787).
  • Use RUST_LOG for daemon log level. NONODB_LOG is not read by the daemon.
  • Replication remains asynchronous; replication is not a backup.

Validation

  • cargo test --locked --workspace --all-targets --all-features
  • cargo clippy --locked --workspace --all-targets --all-features -- -D warnings
  • GUI production build and GUI E2E tests
  • Replication control-plane, discovery, failover, lease-gate, partition, vault,
    and GUI cluster tests
  • Python/Node/Go client checks

Documentation

  • Updated replication/cluster guide, CLI guide, GUI guide, operations, roadmap,
    version references, and release screenshots under docs/assets/gui/.