ceph-csi/vendor/go.etcd.io/etcd/client/v3
Madhu Rajanna 5a66991bb3 rebase: update kubernetes to latest
updating the kubernetes release to the
latest in main go.mod

Signed-off-by: Madhu Rajanna <madhupr007@gmail.com>
2024-08-20 08:17:01 +00:00
..
credentials rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
internal rebase: bump the golang-dependencies group with 1 update 2023-12-21 13:34:39 +00:00
auth.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
client.go rebase: update kubernetes to latest 2024-08-20 08:17:01 +00:00
cluster.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
compact_op.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
compare.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
config.go rebase: update kubernetes to latest 2024-08-20 08:17:01 +00:00
ctx.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
doc.go rebase: update kubernetes to 1.28.0 in main 2023-08-17 13:43:15 +00:00
kv.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
lease.go rebase: bump the golang-dependencies group with 1 update 2023-12-21 13:34:39 +00:00
LICENSE rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
logger.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
maintenance.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
op.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
options.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
README.md rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
retry_interceptor.go rebase: update kubernetes to latest 2024-08-20 08:17:01 +00:00
retry.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
sort.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
txn.go rebase: update kubernetes to 1.28.0 in main 2023-08-17 13:43:15 +00:00
utils.go rebase: bump k8s.io/kubernetes from 1.26.2 to 1.27.2 2023-06-06 12:21:43 +00:00
watch.go rebase: update kubernetes to 1.28.0 in main 2023-08-17 13:43:15 +00:00

etcd/clientv3

Docs Godoc

etcd/clientv3 is the official Go etcd client for v3.

Install

go get go.etcd.io/etcd/client/v3

Warning: As etcd 3.5.0 was not yet released, the command above does not work. After first pre-release of 3.5.0 #12498, etcd can be referenced using:

go get go.etcd.io/etcd/client/v3@v3.5.0-pre

Get started

Create client using clientv3.New:

cli, err := clientv3.New(clientv3.Config{
	Endpoints:   []string{"localhost:2379", "localhost:22379", "localhost:32379"},
	DialTimeout: 5 * time.Second,
})
if err != nil {
	// handle error!
}
defer cli.Close()

etcd v3 uses gRPC for remote procedure calls. And clientv3 uses grpc-go to connect to etcd. Make sure to close the client after using it. If the client is not closed, the connection will have leaky goroutines. To specify client request timeout, pass context.WithTimeout to APIs:

ctx, cancel := context.WithTimeout(context.Background(), timeout)
resp, err := cli.Put(ctx, "sample_key", "sample_value")
cancel()
if err != nil {
    // handle error!
}
// use the response

For full compatibility, it is recommended to install released versions of clients using go modules.

Error Handling

etcd client returns 2 types of errors:

  1. context error: canceled or deadline exceeded.
  2. gRPC error: see api/v3rpc/rpctypes.

Here is the example code to handle client errors:

resp, err := cli.Put(ctx, "", "")
if err != nil {
	switch err {
	case context.Canceled:
		log.Fatalf("ctx is canceled by another routine: %v", err)
	case context.DeadlineExceeded:
		log.Fatalf("ctx is attached with a deadline is exceeded: %v", err)
	case rpctypes.ErrEmptyKey:
		log.Fatalf("client-side error: %v", err)
	default:
		log.Fatalf("bad cluster endpoints, which are not etcd servers: %v", err)
	}
}

Metrics

The etcd client optionally exposes RPC metrics through go-grpc-prometheus. See the examples.

Namespacing

The namespace package provides clientv3 interface wrappers to transparently isolate client requests to a user-defined prefix.

Request size limit

Client request size limit is configurable via clientv3.Config.MaxCallSendMsgSize and MaxCallRecvMsgSize in bytes. If none given, client request send limit defaults to 2 MiB including gRPC overhead bytes. And receive limit defaults to math.MaxInt32.

Examples

More code examples can be found at GoDoc.