~bigbes/tarantool-etcd · parade

main · last commit 1 month ago · 2npkec0r

← Back to the parade

tarantool-etcd-75u Replica route: write handling (reject vs proxy-to-leader) Lined Up

status: open P2 task milestone:m5-clustering
bd update tarantool-etcd-75u --claim bd close tarantool-etcd-75u
Created byEugene Blikh
Ownerbigbes@gmail.com
Created2026-05-20T06:17:56Z
Updated2026-07-17T14:27:37Z
Description
Define what happens when a local client issues a write (Put/DeleteRange/Txn-with-mutations/Lease grant) while in replica mode.

Two modes from the parent design:
- mirror (read-only): reject writes with an etcd-shaped error (or NotLeader/redirect) so clients fail fast. Reads served locally.
- proxy: forward the write to the upstream leader via clientv3, then block until the resulting event arrives over our Watch tail before returning (read-your-writes), so the local view is consistent with what the client just wrote.

Work:
- Gate all mutating handlers (kv.put/delete_range, txn with mutations, lease grant/revoke) on replica mode.
- Implement the reject path (mirror) and the proxy path (proxy) including the wait-for-watch-echo on proxy.
- Pick the error code for the reject path consistent with etcd (likely a clear PermissionDenied/NotLeader-style message).
Notes
Proxy path read-your-writes: forward, capture upstream response revision, wait until watch tail applies >= that revision, then return. Keep v1 simple — mirror/reject may ship first, proxy as a follow-up.

Depends on

  • tarantool-etcd-hlx — Replica route: watch-tail live sync blocks open
  • tarantool-etcd-7ey — Replica route: connect as read-only replica to an existing etcd cluster parent-child open

Depended on by

Nothing depends on this issue.

Prerequisite chain — everything this waits on, transitively

No comments.

  • Eugene Blikh created the issue · 2026-05-20T09:17:55Z
  • Eugene Blikh added under epic tarantool-etcd-7ey · 2026-05-20T09:18:16Z
  • Eugene Blikh added dependency on tarantool-etcd-hlx · 2026-05-20T09:18:19Z
  • Eugene Blikh added label milestone:m5-clustering · 2026-05-21T14:37:41Z
Stored rows — what this pane was built from, as read
issues 1 row
id tarantool-etcd-75u
content_hash 3b4a89d5020a6940cb1cb47fd3dc0b31b89ea640b8c4805c0c787a42b113d130
title Replica route: write handling (reject vs proxy-to-leader)
description Define what happens when a local client issues a write (Put/DeleteRange/Txn-with-mutations/Lease grant) while in replica mode. Two modes from the parent design: - mirror (read-only): reject writes with an etcd-shaped error (or NotLeader/redirect) so clients fail fast. Reads served locally. - proxy: forward the write to the upstream leader via clientv3, then block until the resulting event arrives over our Watch tail before returning (read-your-writes), so the local view is consistent with what the client just wrote. Work: - Gate all mutating handlers (kv.put/delete_range, txn with mutations, lease grant/revoke) on replica mode. - Implement the reject path (mirror) and the proxy path (proxy) including the wait-for-watch-echo on proxy. - Pick the error code for the reject path consistent with etcd (likely a clear PermissionDenied/NotLeader-style message).
design
acceptance_criteria
notes Proxy path read-your-writes: forward, capture upstream response revision, wait until watch tail applies >= that revision, then return. Keep v1 simple — mirror/reject may ship first, proxy as a follow-up.
status open
priority 2
issue_type task
assignee NULL
estimated_minutes NULL
created_at 2026-05-20T06:17:56Z
created_by Eugene Blikh
owner bigbes@gmail.com
updated_at 2026-07-17T14:27:37Z
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 1
labels 1 row
issue_id tarantool-etcd-75u
label milestone:m5-clustering
dependencies 2 rows
id 2697b5b4-3e73-53da-84dd-06b070fb115f
issue_id tarantool-etcd-75u
type blocks
created_at 2026-05-20T09:18:19Z
created_by Eugene Blikh
metadata <binary>
thread_id
depends_on_issue_id tarantool-etcd-hlx
depends_on_wisp_id NULL
depends_on_external NULL
id 48652ac8-6e0e-5561-a798-7f3235f74ba3
issue_id tarantool-etcd-75u
type parent-child
created_at 2026-05-20T09:18:16Z
created_by Eugene Blikh
metadata <binary>
thread_id
depends_on_issue_id tarantool-etcd-7ey
depends_on_wisp_id NULL
depends_on_external NULL
events 2 rows
id 4a87379f-a73c-5791-afac-b8308b910495
issue_id tarantool-etcd-75u
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:41Z
id 506ed28f-9180-50a4-ab10-01aa27b336d1
issue_id tarantool-etcd-75u
event_type created
actor Eugene Blikh
old_value
new_value
comment NULL
created_at 2026-05-20T09:17:55Z