~bigbes/tarantool-etcd · parade

main · last commit 1 month ago · 2npkec0r

← Back to the parade

tarantool-etcd-6zn Learner: MemberAddAsLearner handshake + cluster version negotiation Lined Up

status: open P2 task milestone:m5-clustering
bd update tarantool-etcd-6zn --claim bd close tarantool-etcd-6zn
Created byEugene Blikh
Ownerbigbes@gmail.com
Created2026-05-20T06:45:18Z
Updated2026-07-17T14:27:36Z
Description
Join flow: the cluster must know about us before it streams. Either the operator runs MemberAddAsLearner (etcdctl member add --learner) with our advertise_peer_url and we react, or we self-register. Implement the member-side handshake: respond correctly to the cluster's version probe (/version, X-Server-Version), expose our peer URL, and accept the assigned member ID + cluster ID so transport headers match. Track cluster_version and refuse to start if it's outside a supported etcd range. Until promoted (out of v1 scope), report ourselves as a learner in any membership view.
Notes
MemberAddAsLearner is already implemented on OUR server side (cluster.lua) for the inverse direction; here we are the member being added to a foreign cluster. Cluster-ID mismatch is the most common silent-failure mode.

Depends on

  • tarantool-etcd-cnj — [epic] Raft-learner replica — join an etcd cluster as a non-voting member parent-child open

Depended on by

  • tarantool-etcd-zkg — Learner: conformance — join real etcd cluster, assert log replication blocks

Prerequisite chain — everything this waits on, transitively

  • tarantool-etcd-cnj — [epic] Raft-learner replica — join an etcd cluster as a non-voting member parent-child open
  • tarantool-etcd-7ey — Replica route: connect as read-only replica to an existing etcd cluster related open
  • tarantool-etcd-16d — Implement Maintenance.Snapshot RPC (streaming DB snapshot) related open

No comments.

  • Eugene Blikh created the issue · 2026-05-20T09:45:17Z
  • Eugene Blikh tarantool-etcd-zkg now depends on this · 2026-05-20T09:47:29Z
  • Eugene Blikh added under epic tarantool-etcd-cnj · 2026-05-20T09:47:29Z
  • Eugene Blikh added label milestone:m5-clustering · 2026-05-21T14:37:37Z
Stored rows — what this pane was built from, as read
issues 1 row
id tarantool-etcd-6zn
content_hash 6c540ee1d9aff95fd81e3a781e0e27252675c8c85405333479a596dbab013193
title Learner: MemberAddAsLearner handshake + cluster version negotiation
description Join flow: the cluster must know about us before it streams. Either the operator runs MemberAddAsLearner (etcdctl member add --learner) with our advertise_peer_url and we react, or we self-register. Implement the member-side handshake: respond correctly to the cluster's version probe (/version, X-Server-Version), expose our peer URL, and accept the assigned member ID + cluster ID so transport headers match. Track cluster_version and refuse to start if it's outside a supported etcd range. Until promoted (out of v1 scope), report ourselves as a learner in any membership view.
design
acceptance_criteria
notes MemberAddAsLearner is already implemented on OUR server side (cluster.lua) for the inverse direction; here we are the member being added to a foreign cluster. Cluster-ID mismatch is the most common silent-failure mode.
status open
priority 2
issue_type task
assignee NULL
estimated_minutes NULL
created_at 2026-05-20T06:45:18Z
created_by Eugene Blikh
owner bigbes@gmail.com
updated_at 2026-07-17T14:27:36Z
closed_at NULL
closed_by_session
external_ref NULL
spec_id
compaction_level 0
compacted_at NULL
compacted_at_commit NULL
original_size NULL
sender
ephemeral 0
wisp_type
pinned 0
is_template 0
mol_type
work_type
source_system
metadata <binary>
source_repo
close_reason
event_kind
actor
target
payload
await_type
await_id
timeout_ns 0
waiters
hook_bead
role_bead
agent_state
last_activity NULL
role_type
rig
due_at NULL
defer_until NULL
no_history 0
started_at NULL
is_blocked 0
labels 1 row
issue_id tarantool-etcd-6zn
label milestone:m5-clustering
dependencies 2 rows
id 77b19985-30f0-5eea-81bb-e3a694b5004e
issue_id tarantool-etcd-zkg
type blocks
created_at 2026-05-20T09:47:29Z
created_by Eugene Blikh
metadata <binary>
thread_id
depends_on_issue_id tarantool-etcd-6zn
depends_on_wisp_id NULL
depends_on_external NULL
id d080181a-8870-5118-b344-b342171ce2f8
issue_id tarantool-etcd-6zn
type parent-child
created_at 2026-05-20T09:47:29Z
created_by Eugene Blikh
metadata <binary>
thread_id
depends_on_issue_id tarantool-etcd-cnj
depends_on_wisp_id NULL
depends_on_external NULL
events 2 rows
id 4db8d2e2-61a9-577a-b51d-119d81373640
issue_id tarantool-etcd-6zn
event_type created
actor Eugene Blikh
old_value
new_value
comment NULL
created_at 2026-05-20T09:45:17Z
id d6dd3e6d-c3ef-5a61-8a41-5c6200b30570
issue_id tarantool-etcd-6zn
event_type label_added
actor Eugene Blikh
old_value NULL
new_value NULL
comment Added label: milestone:m5-clustering
created_at 2026-05-21T14:37:37Z