~bigbes/tarantool-etcd · parade

main · last commit 1 month ago · 2npkec0r

← Back to the parade

tarantool-etcd-umc Learner: config block + role plumbing Lined Up

status: open P2 task milestone:m5-clustering
bd update tarantool-etcd-umc --claim bd close tarantool-etcd-umc
Created byEugene Blikh
Ownerbigbes@gmail.com
Created2026-05-20T06:45:13Z
Updated2026-07-17T14:27:36Z
Description
Add the role config surface for learner mode and wire validate/apply/stop in app/roles/etcd.lua. New block under app.roles.etcd:

  learner:
    enabled: false
    cluster_peers: ['http://etcd-a:2380', ...]   # PEER (2380) URLs, not client (2379)
    advertise_peer_url: 'http://this-node:2380'   # how the cluster reaches us
    peer_tls: {...}

Validate: when learner.enabled, the local store refuses normal client write registration; cluster_peers + advertise_peer_url non-empty; peer URLs are well-formed. No raft/transport logic here — just config parsing, validation, and the on/off switch the other phases hang off. Mirrors the existing grpc/json/cmux config validation in app/roles/etcd.lua.
Notes
Distinct from the watch-mirror config (tarantool-etcd-jg3): peer (2380) URLs not client (2379), advertise_peer_url required for the cluster to dial us back.

Depends on

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

Depended on by

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

Unblocks — everything waiting on this, transitively

  • tarantool-etcd-axs — Learner: rafthttp peer transport over nghttp2 blocks open
  • tarantool-etcd-boq — Learner: raft state machine (follower/learner subset) blocks open
  • tarantool-etcd-6js — Learner: apply loop — InternalRaftRequest -> existing handlers blocks open
  • tarantool-etcd-q5f — Learner: snapshot receive (bbolt parse + bucket translation) blocks open
  • tarantool-etcd-zkg — Learner: conformance — join real etcd cluster, assert log replication blocks open
  • tarantool-etcd-ovo — Learner: durable applied_index (WAL-equivalent for restart) blocks open

No comments.

  • Eugene Blikh created the issue · 2026-05-20T09:45:13Z
  • Eugene Blikh added under epic tarantool-etcd-cnj · 2026-05-20T09:47:12Z
  • Eugene Blikh tarantool-etcd-axs now depends on this · 2026-05-20T09:47:29Z
  • Eugene Blikh added label milestone:m5-clustering · 2026-05-21T14:37:40Z
Stored rows — what this pane was built from, as read
issues 1 row
id tarantool-etcd-umc
content_hash d8474c3796303d77baae0a958775f27a81b09ad2e0afaa4a00084cdf0ab6b7e9
title Learner: config block + role plumbing
description Add the role config surface for learner mode and wire validate/apply/stop in app/roles/etcd.lua. New block under app.roles.etcd: learner: enabled: false cluster_peers: ['http://etcd-a:2380', ...] # PEER (2380) URLs, not client (2379) advertise_peer_url: 'http://this-node:2380' # how the cluster reaches us peer_tls: {...} Validate: when learner.enabled, the local store refuses normal client write registration; cluster_peers + advertise_peer_url non-empty; peer URLs are well-formed. No raft/transport logic here — just config parsing, validation, and the on/off switch the other phases hang off. Mirrors the existing grpc/json/cmux config validation in app/roles/etcd.lua.
design
acceptance_criteria
notes Distinct from the watch-mirror config (tarantool-etcd-jg3): peer (2380) URLs not client (2379), advertise_peer_url required for the cluster to dial us back.
status open
priority 2
issue_type task
assignee NULL
estimated_minutes NULL
created_at 2026-05-20T06:45:13Z
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-umc
label milestone:m5-clustering
dependencies 2 rows
id 06ac10bf-a45b-50c0-81c1-20ef00d34aa3
issue_id tarantool-etcd-umc
type parent-child
created_at 2026-05-20T09:47:12Z
created_by Eugene Blikh
metadata <binary>
thread_id
depends_on_issue_id tarantool-etcd-cnj
depends_on_wisp_id NULL
depends_on_external NULL
id 69607b55-2dd1-5f56-9b3b-337ea0ee943f
issue_id tarantool-etcd-axs
type blocks
created_at 2026-05-20T09:47:29Z
created_by Eugene Blikh
metadata <binary>
thread_id
depends_on_issue_id tarantool-etcd-umc
depends_on_wisp_id NULL
depends_on_external NULL
events 2 rows
id 1979417f-6315-5926-9696-1be328f9220f
issue_id tarantool-etcd-umc
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:40Z
id 6c91c7c8-e165-5574-bcfa-01dfa3086716
issue_id tarantool-etcd-umc
event_type created
actor Eugene Blikh
old_value
new_value
comment NULL
created_at 2026-05-20T09:45:13Z