轉載地址為：https://segmentfault.com/a/1190000005040921

為了提供服務發現以及健康檢測，Consul提供了非常容易使用的鍵／值對儲存。它能被用於儲存動態配置資訊，幫助服務協作，建構leader選舉機制，以及開發者可以想到的建構任何其它的東西。

本篇假設你至少有一個Consul代理在執行。

簡單使用

為了展示儲存鍵／值對是非常簡單的，我們將在鍵／值儲存裡維護一些鍵。

我們在執行代理步驟中展示了查詢本地代理，我們先驗證鍵／值儲存中沒有任何鍵存在：

$ curl -v http://localhost:8500/v1/kv/?recurse
* About to connect() to localhost port 8500
 
 (#0)
*   Trying 127.0.0.1... connected
> GET /v1/kv/?recurse HTTP/1.1
> User-Agent: curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
> Host: localhost:8500
> Accept: */*
>
< HTTP/1.1 404 Not Found
< X-Consul-Index: 1
< Date: Fri, 11 Apr 2014 02:10:28
 
 GMT
< Content-Length: 0
< Content-Type: text/plain; charset=utf-8
<
* Connection #0 to host localhost left intact
* Closing connection #0

因為沒有任何鍵，所以我們得到了404的響應，我們可以用 PUT 來儲存一些鍵：

$ curl -X PUT -d 'test' http://localhost:8500/v1/kv/web/key1
true
$ curl -X PUT -d 'test' http://localhost:8500/v1/kv/web/key2?flags=42
 

true
$ curl -X PUT -d 'test'  http://localhost:8500/v1/kv/web/sub/key3
true
$ curl http://localhost:8500/v1/kv/?recurse
[{"CreateIndex":97,"ModifyIndex":97,"Key":"web/key1","Flags":0,"Value":"dGVzdA=="},
 {"CreateIndex":98,"ModifyIndex":98,"Key":"web/key2","Flags":42,"Value":"dGVzdA=="},
 {"CreateIndex":99,"ModifyIndex":99,"Key":"web/sub/key3","Flags":0,"Value":"dGVzdA=="}]

這裡我們建立了3個鍵，每個都關聯了值"test"。注意 值 欄位的返回是基於base64的編碼，該編碼允許非UTF8字符集。對於鍵"web/key2"，我們為其設定了一個42的 標記。所有的鍵都支援設定一個64位長的整形標記值。這個標記並不是由Consul內部使用的，它可以被用於儲存任意鍵值對的元資料資訊。

在設定值之後，我們使用 ?recurse 引數發出了 GET 請求來接收多個鍵的資訊。

你也可以非常容易地獲取單個鍵的資訊：

$ curl http://localhost:8500/v1/kv/web/key1
[{"CreateIndex":97,"ModifyIndex":97,"Key":"web/key1","Flags":0,"Value":"dGVzdA=="}]

刪除一個鍵也同樣非常簡單，使用 DELETE 來刪除一個鍵。我們可以指定完整路徑來刪除單獨一個鍵，或者使用"?recurse"遞迴刪除所有的鍵：

$ curl -X DELETE http://localhost:8500/v1/kv/web/sub?recurse
$ curl http://localhost:8500/v1/kv/web?recurse
[{"CreateIndex":97,"ModifyIndex":97,"Key":"web/key1","Flags":0,"Value":"dGVzdA=="},
 {"CreateIndex":98,"ModifyIndex":98,"Key":"web/key2","Flags":42,"Value":"dGVzdA=="}]

使用一個 PUT 請求相同的URI並且提供一個不同的訊息體就可以修改指定的鍵，Consul提供了一個 檢測並設定 的操作，對應的操作是原子的。通過在GET請求中提供 ?cas= 引數以及指定最新的 ModifyIndex 值我們就可以得到原子CAS操作。例如，假設我們想要更新"web/key1"：

$ curl -X PUT -d 'newval' http://localhost:8500/v1/kv/web/key1?cas=97
true
$ curl -X PUT -d 'newval' http://localhost:8500/v1/kv/web/key1?cas=97
false

這裡，第一個CAS更新成功了因為最新的 ModifyIndex 是97，而第二個操作失敗了因為最新的 ModifyIndex 不再是97了。

我們可以使用 ModifyIndex 來等待指定鍵值的改變，例如，假設我們想要等待Key2的修改：

$ curl "http://localhost:8500/v1/kv/web/key2?index=101&wait=5s"
[{"CreateIndex":98,"ModifyIndex":101,"Key":"web/key2","Flags":42,"Value":"dGVzdA=="}]

通過提供"?index="引數，我們請求等待直到鍵包含了一個大於101的 ModifyIndex 的值。無論如何由於"?wait=5"引數限制了查詢最多等待5秒，之後會返回當前沒有修改的值。該操作可以高效地等待鍵的更新。另外相同的方法可以用於等待一個鍵的集合，直到鍵集合中任何一個鍵發生的更新。