mirror of
https://github.com/hanzoai/traces.git
synced 2026-10-30 18:20:41 +00:00
Martin DisibioandGitHub
b05989ebf1
* Upgrade dskit, requires pinning grpc * lint * oops update serverless too
21 lines
1.2 KiB
Go
21 lines
1.2 KiB
Go
/*
|
|
Package ring contains types and functions for creating and working with rings.
|
|
|
|
# Overview
|
|
|
|
Rings are shared between instances via a key-value store, and are represented by the [Desc] struct, which contains a map of [InstanceDesc]
|
|
structs representing individual instances in the ring.
|
|
|
|
# Creating a Ring
|
|
|
|
Two types are available for creating and updating rings:
|
|
|
|
- [Lifecycler] - A Service that writes to a ring on behalf of a single instance. It's responsible for claiming tokens on the ring and updating the key/value store with heartbeats, state changes, and token changes. This type is the original lifecycler implementation, and [BasicLifecycler] should be used instead for new services.
|
|
- [BasicLifecycler] - A Service that writes to a ring on behalf of a single instance. It's responsible for claiming tokens on the ring, updating the key/value store with heartbeats and state changes, and uses a delegate with event listeners to help with these. This type is general purpose, is used by numerous services, and is meant for building higher level lifecyclers.
|
|
|
|
# Observing a ring
|
|
|
|
The [Ring] type is a Service that is primarily used for reading and watching for changes to a ring.
|
|
*/
|
|
package ring
|