![]() |
||
---|---|---|
.. | ||
integration | ||
sync | ||
README.md | ||
client.go | ||
client_test.go | ||
cluster.go | ||
compare.go | ||
doc.go | ||
example_cluster_test.go | ||
example_kv_test.go | ||
example_lease_test.go | ||
example_test.go | ||
example_watch_test.go | ||
kv.go | ||
lease.go | ||
op.go | ||
sort.go | ||
txn.go | ||
txn_test.go | ||
watch.go |
README.md
etcd/clientv3
etcd/clientv3
is the official Go etcd client for v3.
Install
go get github.com/coreos/etcd/clientv3
Get started
Create client using clientv3.New
:
cli, err := clientv3.New(clientv3.Config{
Endpoints: []string{"localhost:12378", "localhost:22378", "localhost:32378"},
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 := kvc.Put(ctx, "sample_key", "sample_value")
cancel()
if err != nil {
// handle error!
}
// use the response
Error Handling
TODO
Examples
More code examples can be found at GoDoc.