Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 19-Feb-2022 | - | ||||
watch/ | H | 19-Feb-2022 | - | 871 | 654 | |
LICENSE | H A D | 19-Feb-2022 | 15.6 KiB | 355 | 256 | |
README.md | H A D | 19-Feb-2022 | 1.3 KiB | 68 | 49 | |
acl.go | H A D | 19-Feb-2022 | 42.4 KiB | 1,563 | 1,197 | |
agent.go | H A D | 19-Feb-2022 | 44.3 KiB | 1,377 | 960 | |
api.go | H A D | 19-Feb-2022 | 33.2 KiB | 1,175 | 735 | |
catalog.go | H A D | 19-Feb-2022 | 9.5 KiB | 371 | 306 | |
config_entry.go | H A D | 19-Feb-2022 | 17.3 KiB | 513 | 333 | |
config_entry_discoverychain.go | H A D | 19-Feb-2022 | 11.9 KiB | 322 | 226 | |
config_entry_exports.go | H A D | 19-Feb-2022 | 2.6 KiB | 73 | 36 | |
config_entry_gateways.go | H A D | 19-Feb-2022 | 7.7 KiB | 196 | 70 | |
config_entry_intentions.go | H A D | 19-Feb-2022 | 2.3 KiB | 67 | 53 | |
config_entry_mesh.go | H A D | 19-Feb-2022 | 1.9 KiB | 57 | 31 | |
connect.go | H A D | 19-Feb-2022 | 299 | 13 | 7 | |
connect_ca.go | H A D | 19-Feb-2022 | 5.5 KiB | 199 | 123 | |
connect_intention.go | H A D | 19-Feb-2022 | 13 KiB | 450 | 295 | |
coordinate.go | H A D | 19-Feb-2022 | 2.9 KiB | 120 | 93 | |
debug.go | H A D | 19-Feb-2022 | 3.6 KiB | 140 | 93 | |
discovery_chain.go | H A D | 19-Feb-2022 | 5.7 KiB | 235 | 149 | |
event.go | H A D | 19-Feb-2022 | 2.8 KiB | 112 | 88 | |
go.mod | H A D | 19-Feb-2022 | 424 | 17 | 13 | |
go.sum | H A D | 19-Feb-2022 | 11.5 KiB | 125 | 124 | |
health.go | H A D | 19-Feb-2022 | 10.6 KiB | 390 | 312 | |
kv.go | H A D | 19-Feb-2022 | 8.3 KiB | 305 | 216 | |
lock.go | H A D | 19-Feb-2022 | 11.1 KiB | 409 | 269 | |
namespace.go | H A D | 19-Feb-2022 | 4.8 KiB | 179 | 127 | |
operator.go | H A D | 19-Feb-2022 | 241 | 12 | 7 | |
operator_area.go | H A D | 19-Feb-2022 | 5.6 KiB | 207 | 127 | |
operator_autopilot.go | H A D | 19-Feb-2022 | 12.5 KiB | 402 | 256 | |
operator_keyring.go | H A D | 19-Feb-2022 | 2.6 KiB | 108 | 79 | |
operator_license.go | H A D | 19-Feb-2022 | 3.3 KiB | 129 | 85 | |
operator_raft.go | H A D | 19-Feb-2022 | 2.7 KiB | 97 | 58 | |
operator_segment.go | H A D | 19-Feb-2022 | 289 | 12 | 9 | |
partition.go | H A D | 19-Feb-2022 | 4 KiB | 165 | 127 | |
prepared_query.go | H A D | 19-Feb-2022 | 7.4 KiB | 230 | 109 | |
raw.go | H A D | 19-Feb-2022 | 749 | 25 | 13 | |
semaphore.go | H A D | 19-Feb-2022 | 14.3 KiB | 531 | 358 | |
session.go | H A D | 19-Feb-2022 | 5.9 KiB | 244 | 188 | |
snapshot.go | H A D | 19-Feb-2022 | 1.4 KiB | 55 | 39 | |
status.go | H A D | 19-Feb-2022 | 1.3 KiB | 68 | 51 | |
txn.go | H A D | 19-Feb-2022 | 6.5 KiB | 246 | 139 |
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