website icon indicating copy to clipboard operation
website copied to clipboard

Need more detailed info on etcd component...

Open Niemetz opened this issue 2 years ago • 12 comments

Hi It would be very help to have a flow digram that show how a request from a client to an etcd... I, for one, are not able to visualize what the flow looks like based on this paragraph: "Do clients have to send requests to the etcd leader? Raft is leader-based; the leader handles all client requests which need cluster consensus. However, the client does not need to know which node is the leader. Any request that requires consensus sent to a follower is automatically forwarded to the leader. Requests that do not require consensus (e.g., serialized reads) can be processed by any cluster member." So, based on the header fo this paragraph, it suggests that there are more than one instance of etcd in a cluster....there's a "ectd leader" and "ectd followers/workers"? If so, how the leader works when it gets an API request? etc... Thanks J.N

Niemetz avatar Feb 03 '23 15:02 Niemetz

FYI. https://github.com/ahrtr/etcd-issues/blob/master/docs/cncf_storage_tag_etcd.md#put-e2e-workflow

ahrtr avatar Feb 03 '23 22:02 ahrtr

Hey Benjamin Thanks a lot for the link.  Perfect!  J.N On Friday, February 3, 2023, 05:27:22 PM EST, Benjamin Wang @.***> wrote:

FYI. https://github.com/ahrtr/etcd-issues/blob/master/docs/cncf_storage_tag_etcd.md#put-e2e-workflow

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: @.***>

Niemetz avatar Feb 03 '23 22:02 Niemetz

Discussed during sig-etcd triage. It would beneficial to surface these diagrams and https://github.com/etcd-io/etcd/tree/main/Documentation/etcd-internals/diagrams on the etcd website under the learning section:

  • https://etcd.io/docs/v3.5/learning
  • https://etcd.io/docs/v3.6/learning

As mentioned on the call by @lavacat we should ensure the diagrams come with a note on when they were created.

jmhbnz avatar Jan 04 '24 19:01 jmhbnz

I'd love to work on this!

fykaa avatar Jan 04 '24 19:01 fykaa

Thanks for volunteering @fykaa, assigned 🙏🏻

/assign @fykaa

jmhbnz avatar Jan 04 '24 19:01 jmhbnz

Hey @fykaa - How's it going with this pr? Is this something you are still working on?

jmhbnz avatar Feb 15 '24 19:02 jmhbnz

Hey, I'm currently in the process of gathering all the necessary information and resources to put it effectively. I haven't started the actual work yet, but rest assured, I'll try to make a headway on it soon!!

fykaa avatar Feb 16 '24 12:02 fykaa