mirror of
https://github.com/ceph/ceph-csi.git
synced 2025-03-10 01:19:29 +00:00
f87d06ed85
Several packages are only used while running the e2e suite. These packages are less important to update, as the they can not influence the final executable that is part of the Ceph-CSI container-image. By moving these dependencies out of the main Ceph-CSI go.mod, it is easier to identify if a reported CVE affects Ceph-CSI, or only the testing (like most of the Kubernetes CVEs). Signed-off-by: Niels de Vos <ndevos@ibm.com>
107 lines
3.6 KiB
Go
107 lines
3.6 KiB
Go
// Copyright 2016 The etcd Authors
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
// Package clientv3 implements the official Go etcd client for v3.
|
|
//
|
|
// Create client using `clientv3.New`:
|
|
//
|
|
// // expect dial time-out on ipv4 blackhole
|
|
// _, err := clientv3.New(clientv3.Config{
|
|
// Endpoints: []string{"http://254.0.0.1:12345"},
|
|
// DialTimeout: 2 * time.Second,
|
|
// })
|
|
//
|
|
// // etcd clientv3 >= v3.2.10, grpc/grpc-go >= v1.7.3
|
|
// if err == context.DeadlineExceeded {
|
|
// // handle errors
|
|
// }
|
|
//
|
|
// // etcd clientv3 <= v3.2.9, grpc/grpc-go <= v1.2.1
|
|
// if err == grpc.ErrClientConnTimeout {
|
|
// // handle errors
|
|
// }
|
|
//
|
|
// 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()
|
|
//
|
|
// Make sure to close the client after using it. If the client is not closed, the
|
|
// connection will have leaky goroutines.
|
|
//
|
|
// To specify a client request timeout, wrap the context with context.WithTimeout:
|
|
//
|
|
// ctx, cancel := context.WithTimeout(context.Background(), timeout)
|
|
// resp, err := kvc.Put(ctx, "sample_key", "sample_value")
|
|
// cancel()
|
|
// if err != nil {
|
|
// // handle error!
|
|
// }
|
|
// // use the response
|
|
//
|
|
// The Client has internal state (watchers and leases), so Clients should be reused instead of created as needed.
|
|
// Clients are safe for concurrent use by multiple goroutines.
|
|
//
|
|
// etcd client returns 2 types of errors:
|
|
//
|
|
// 1. context error: canceled or deadline exceeded.
|
|
// 2. gRPC error: e.g. when clock drifts in server-side before client's context deadline exceeded.
|
|
//
|
|
// See https://github.com/etcd-io/etcd/blob/main/api/v3rpc/rpctypes/error.go
|
|
//
|
|
// Here is the example code to handle client errors:
|
|
//
|
|
// resp, err := kvc.Put(ctx, "", "")
|
|
// if err != nil {
|
|
// if err == context.Canceled {
|
|
// // ctx is canceled by another routine
|
|
// } else if err == context.DeadlineExceeded {
|
|
// // ctx is attached with a deadline and it exceeded
|
|
// } else if err == rpctypes.ErrEmptyKey {
|
|
// // client-side error: key is not provided
|
|
// } else if ev, ok := status.FromError(err); ok {
|
|
// code := ev.Code()
|
|
// if code == codes.DeadlineExceeded {
|
|
// // server-side context might have timed-out first (due to clock skew)
|
|
// // while original client-side context is not timed-out yet
|
|
// }
|
|
// } else {
|
|
// // bad cluster endpoints, which are not etcd servers
|
|
// }
|
|
// }
|
|
//
|
|
// go func() { cli.Close() }()
|
|
// _, err := kvc.Get(ctx, "a")
|
|
// if err != nil {
|
|
// // with etcd clientv3 <= v3.3
|
|
// if err == context.Canceled {
|
|
// // grpc balancer calls 'Get' with an inflight client.Close
|
|
// } else if err == grpc.ErrClientConnClosing { // <= gRCP v1.7.x
|
|
// // grpc balancer calls 'Get' after client.Close.
|
|
// }
|
|
// // with etcd clientv3 >= v3.4
|
|
// if clientv3.IsConnCanceled(err) {
|
|
// // gRPC client connection is closed
|
|
// }
|
|
// }
|
|
//
|
|
// The grpc load balancer is registered statically and is shared across etcd clients.
|
|
// To enable detailed load balancer logging, set the ETCD_CLIENT_DEBUG environment
|
|
// variable. E.g. "ETCD_CLIENT_DEBUG=1".
|
|
package clientv3
|