|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 30-Jul-2020 | - |
| watch/ | H | 30-Jul-2020 | - | 2,127 | 1,669 |
| .golangci.yml | H A D | 30-Jul-2020 | 777 | 34 | 27 |
| README.md | H A D | 30-Jul-2020 | 1.3 KiB | 68 | 49 |
| acl.go | H A D | 30-Jul-2020 | 37 KiB | 1,364 | 1,013 |
| acl_test.go | H A D | 30-Jul-2020 | 17.6 KiB | 763 | 603 |
| agent.go | H A D | 30-Jul-2020 | 33.1 KiB | 1,052 | 739 |
| agent_test.go | H A D | 30-Jul-2020 | 40.6 KiB | 1,802 | 1,493 |
| api.go | H A D | 30-Jul-2020 | 29.4 KiB | 1,042 | 658 |
| api_test.go | H A D | 30-Jul-2020 | 24.7 KiB | 1,004 | 900 |
| catalog.go | H A D | 30-Jul-2020 | 8.7 KiB | 338 | 274 |
| catalog_test.go | H A D | 30-Jul-2020 | 28.5 KiB | 1,238 | 986 |
| config_entry.go | H A D | 30-Jul-2020 | 9.6 KiB | 354 | 255 |
| config_entry_discoverychain.go | H A D | 30-Jul-2020 | 6 KiB | 204 | 173 |
| config_entry_discoverychain_test.go | H A D | 30-Jul-2020 | 6 KiB | 236 | 194 |
| config_entry_gateways.go | H A D | 30-Jul-2020 | 5.7 KiB | 171 | 63 |
| config_entry_gateways_test.go | H A D | 30-Jul-2020 | 7.5 KiB | 285 | 212 |
| config_entry_test.go | H A D | 30-Jul-2020 | 16 KiB | 758 | 700 |
| connect.go | H A D | 30-Jul-2020 | 299 | 13 | 7 |
| connect_ca.go | H A D | 30-Jul-2020 | 4.9 KiB | 182 | 113 |
| connect_ca_test.go | H A D | 30-Jul-2020 | 2.6 KiB | 106 | 76 |
| connect_intention.go | H A D | 30-Jul-2020 | 9 KiB | 310 | 191 |
| connect_intention_test.go | H A D | 30-Jul-2020 | 3.8 KiB | 190 | 143 |
| coordinate.go | H A D | 30-Jul-2020 | 2.6 KiB | 107 | 80 |
| coordinate_test.go | H A D | 30-Jul-2020 | 2.2 KiB | 108 | 84 |
| debug.go | H A D | 30-Jul-2020 | 2.7 KiB | 107 | 66 |
| debug_test.go | H A D | 30-Jul-2020 | 1.4 KiB | 84 | 65 |
| discovery_chain.go | H A D | 30-Jul-2020 | 5.6 KiB | 230 | 145 |
| discovery_chain_test.go | H A D | 30-Jul-2020 | 5.5 KiB | 196 | 177 |
| event.go | H A D | 30-Jul-2020 | 2.6 KiB | 105 | 81 |
| event_test.go | H A D | 30-Jul-2020 | 802 | 51 | 39 |
| go.mod | H A D | 30-Jul-2020 | 424 | 17 | 13 |
| go.sum | H A D | 30-Jul-2020 | 12.1 KiB | 132 | 131 |
| health.go | H A D | 30-Jul-2020 | 10.3 KiB | 376 | 298 |
| health_test.go | H A D | 30-Jul-2020 | 14.9 KiB | 672 | 565 |
| kv.go | H A D | 30-Jul-2020 | 8 KiB | 291 | 207 |
| kv_test.go | H A D | 30-Jul-2020 | 11.7 KiB | 581 | 467 |
| lock.go | H A D | 30-Jul-2020 | 11 KiB | 404 | 264 |
| lock_test.go | H A D | 30-Jul-2020 | 12 KiB | 585 | 441 |
| namespace.go | H A D | 30-Jul-2020 | 4.3 KiB | 160 | 110 |
| namespace_test.go | H A D | 30-Jul-2020 | 2.8 KiB | 130 | 102 |
| operator.go | H A D | 30-Jul-2020 | 241 | 12 | 7 |
| operator_area.go | H A D | 30-Jul-2020 | 5.4 KiB | 195 | 115 |
| operator_autopilot.go | H A D | 30-Jul-2020 | 6.8 KiB | 233 | 134 |
| operator_autopilot_test.go | H A D | 30-Jul-2020 | 2.3 KiB | 108 | 91 |
| operator_keyring.go | H A D | 30-Jul-2020 | 2.2 KiB | 90 | 65 |
| operator_keyring_test.go | H A D | 30-Jul-2020 | 1.6 KiB | 74 | 60 |
| operator_license.go | H A D | 30-Jul-2020 | 2.8 KiB | 115 | 76 |
| operator_raft.go | H A D | 30-Jul-2020 | 2.5 KiB | 90 | 49 |
| operator_raft_test.go | H A D | 30-Jul-2020 | 817 | 39 | 31 |
| operator_segment.go | H A D | 30-Jul-2020 | 289 | 12 | 9 |
| oss_test.go | H A D | 30-Jul-2020 | 61 | 6 | 2 |
| prepared_query.go | H A D | 30-Jul-2020 | 7.3 KiB | 224 | 103 |
| prepared_query_test.go | H A D | 30-Jul-2020 | 4.2 KiB | 183 | 149 |
| raw.go | H A D | 30-Jul-2020 | 749 | 25 | 13 |
| semaphore.go | H A D | 30-Jul-2020 | 14.3 KiB | 531 | 358 |
| semaphore_test.go | H A D | 30-Jul-2020 | 11.4 KiB | 543 | 411 |
| session.go | H A D | 30-Jul-2020 | 5.9 KiB | 244 | 188 |
| session_test.go | H A D | 30-Jul-2020 | 12.9 KiB | 659 | 532 |
| snapshot.go | H A D | 30-Jul-2020 | 1.2 KiB | 48 | 32 |
| snapshot_test.go | H A D | 30-Jul-2020 | 3.3 KiB | 136 | 101 |
| status.go | H A D | 30-Jul-2020 | 932 | 44 | 33 |
| status_test.go | H A D | 30-Jul-2020 | 587 | 40 | 32 |
| txn.go | H A D | 30-Jul-2020 | 6.5 KiB | 245 | 138 |
| txn_test.go | H A D | 30-Jul-2020 | 7.4 KiB | 305 | 279 |
README.md
1Consul API client
2=================
3
4This package provides the `api` package which attempts to
5provide programmatic access to the full Consul API.
6
7Currently, all of the Consul APIs included in version 0.6.0 are supported.
8
9Documentation
10=============
11
12The full documentation is available on [Godoc](https://godoc.org/github.com/hashicorp/consul/api)
13
14Usage
15=====
16
17Below is an example of using the Consul client:
18
19```go
20package main
21
22import "github.com/hashicorp/consul/api"
23import "fmt"
24
25func main() {
26 // Get a new client
27 client, err := api.NewClient(api.DefaultConfig())
28 if err != nil {
29 panic(err)
30 }
31
32 // Get a handle to the KV API
33 kv := client.KV()
34
35 // PUT a new KV pair
36 p := &api.KVPair{Key: "REDIS_MAXCLIENTS", Value: []byte("1000")}
37 _, err = kv.Put(p, nil)
38 if err != nil {
39 panic(err)
40 }
41
42 // Lookup the pair
43 pair, _, err := kv.Get("REDIS_MAXCLIENTS", nil)
44 if err != nil {
45 panic(err)
46 }
47 fmt.Printf("KV: %v %s\n", pair.Key, pair.Value)
48}
49```
50
51To run this example, start a Consul server:
52
53```bash
54consul agent -dev
55```
56
57Copy the code above into a file such as `main.go`.
58
59Install and run. You'll see a key (`REDIS_MAXCLIENTS`) and value (`1000`) printed.
60
61```bash
62$ go get
63$ go run main.go
64KV: REDIS_MAXCLIENTS 1000
65```
66
67After running the code, you can also view the values in the Consul UI on your local machine at http://localhost:8500/ui/dc1/kv
68