2016-05-13 06:50:58 +03:00
|
|
|
// Copyright 2016 The etcd Authors
|
2016-02-23 03:39:05 +03:00
|
|
|
//
|
|
|
|
// 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.
|
|
|
|
|
2016-03-20 00:04:45 +03:00
|
|
|
// Package clientv3 implements the official Go etcd client for v3.
|
2016-02-23 03:39:05 +03:00
|
|
|
//
|
|
|
|
// Create client using `clientv3.New`:
|
|
|
|
//
|
|
|
|
// cli, err := clientv3.New(clientv3.Config{
|
2016-03-22 00:21:09 +03:00
|
|
|
// Endpoints: []string{"localhost:2379", "localhost:22379", "localhost:32379"},
|
2016-02-23 03:39:05 +03:00
|
|
|
// 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 client request timeout, pass context.WithTimeout to APIs:
|
|
|
|
//
|
|
|
|
// 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
|
|
|
|
//
|
2016-03-29 19:28:53 +03:00
|
|
|
// 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.
|
|
|
|
//
|
2016-03-01 00:54:35 +03:00
|
|
|
// etcd client returns 2 types of errors:
|
|
|
|
//
|
|
|
|
// 1. context error: canceled or deadline exceeded.
|
2016-10-24 07:05:45 +03:00
|
|
|
// 2. gRPC error: see https://github.com/coreos/etcd/blob/master/etcdserver/api/v3rpc/rpctypes/error.go
|
2016-03-01 00:54:35 +03:00
|
|
|
//
|
|
|
|
// 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 verr, ok := err.(*v3rpc.ErrEmptyKey); ok {
|
|
|
|
// // process (verr.Errors)
|
|
|
|
// } else {
|
|
|
|
// // bad cluster endpoints, which are not etcd servers
|
|
|
|
// }
|
|
|
|
// }
|
2016-02-23 03:39:05 +03:00
|
|
|
//
|
|
|
|
package clientv3
|