4-consul HTTP API及实践

原文：https://www.douban.com/note/629645759/

注意：使用API需严格控制url末尾有无斜杠

服务增减测试，API和reload优先级测试

1、手动增减conf.d/*.json，然后操作consul reload，会增减对应的服务

2、通过HTTP API增减服务后，执行consul reload，会还原成conf.d/*.json的服务配置，之前HTTP API的增减服务操作会被覆盖，也就是API会导致json文件和内存中的服务信息不一致。（尚未发现consul提供将当前内存中的服务配置信息dump出.json文件的功能）

实践结论1：consul reload会以conf.d/*.json为准去同步当前consul内存中当前机器注册的服务。
使用consul建议使用conf.d/*.json文件的方式增减服务，而非API，这样有落地的json文件多一份保障。

实践结论2：

Node名称唯一，通过修改json然后consul reload方式增加节点时会取当前机器的（内网）IP，具体如何区别的内外外网未知。

通过API注册服务时，json参数Node和Address必填，会使用Address覆盖掉Node当前的Address

实践结论3：

consul reload不会reload配置文件consul.json，只reload conf.d/*.json

实践结论4：

若干agent server会保存同样的数据到设置的data目录，agent client也会保存一部分数据至data目录，重启consul agent(server或client)的时候，会重新加载data目录的信息，猜测client存放的是有版本号的服务信息，并且重启时会从server端同步最新的数据。

consul HTTP API KV篇
0、查看当前集群所有服务

curl -s 127.0.0.1:8500/v1/catalog/services | python -m json.tool

0.5、查看本机配置

curl -s 127.0.0.1:8500/v1/agent/self | python -m json.tool

1、查看服务状态

curl -s http://127.0.0.1:8500/v1/catalog/service/prometheus-pushgateway | python -m json.tool

1.5、查看本机服务

curl -s 127.0.0.1:8500/v1/agent/services | python -m json.tool

2、查看不健康的服务

curl -s http://localhost:8500/v1/health/state/critical | python -m json.tool

3、添加KV（值为test，url末尾的斜杠会算作key的一部分）
curl -X PUT-d ‘test‘ http://localhost:8500/v1/kv/key1
curl -X PUT-d ‘test‘ http://localhost:8500/v1/kv/key1/

4、查看当前所有的KV

curl -s http://localhost:8500/v1/kv/?recurse | python -m json.tool

5、查看单个KV

curl -s http://localhost:8500/v1/kv/petanne/key1 | python -m json.tool

6、查看指定路径下的KV（url末尾的斜杠会算作key的一部分，可以理解为以petanne开头的所有key）

curl-s http://localhost:8500/v1/kv/petanne?recurse | python -m json.tool

curl-s http://localhost:8500/v1/kv/petanne/?recurse | python -m json.tool

7、删除单个KV

curl -X DELETE http://localhost:8500/v1/kv/petanne

8、删除指定路径下的KV（末尾斜杠同查看）

curl -X DELETE http://localhost:8500/v1/kv/petanne?recurse

9、修改单个KV

curl -X PUT -d ‘newval‘ http://localhost:8500/v1/kv/petanne/key1

curl -X PUT -d ‘newval‘ http://localhost:8500/v1/kv/petanne/key1?cas=5820778

(cas == ModifyIndex 才能修改成功，防止多人同时修改时冲突)

10、查看KV（查看比指定index大的ModifyIndex的该key的值，最多等待5秒，否则返回当前最新值）

curl "http://localhost:8500/v1/kv/petanne/key2?index=5820781&wait=5s"

agent篇
agent endpoints用来和本地agent进行交互，一般用来服务注册和检查注册，支持以下接口

/v1/agent/checks : 返回本地agent注册的所有检查(包括配置文件和HTTP接口)
/v1/agent/services : 返回本地agent注册的所有 服务
/v1/agent/members : 返回agent在集群的gossip pool中看到的成员
/v1/agent/self : 返回本地agent的配置和成员信息
/v1/agent/join/<address> : 触发本地agent加入node
/v1/agent/force-leave/<node>>: 强制删除node
/v1/agent/check/register : 在本地agent增加一个检查项，使用PUT方法传输一个json格式的数据
/v1/agent/check/deregister/<checkID> : 注销一个本地agent的检查项
/v1/agent/check/pass/<checkID> : 设置一个本地检查项的状态为passing
/v1/agent/check/warn/<checkID> : 设置一个本地检查项的状态为warning
/v1/agent/check/fail/<checkID> : 设置一个本地检查项的状态为critical
/v1/agent/service/register : 在本地agent增加一个新的服务项，使用PUT方法传输一个json格式的数据
/v1/agent/service/deregister/<serviceID> : 注销一个本地agent的服务项
catalog篇
catalog endpoints用来注册/注销nodes、services、checks

/v1/catalog/register : Registers a new node, service, or check
/v1/catalog/deregister : Deregisters a node, service, or check
/v1/catalog/datacenters : Lists known datacenters
/v1/catalog/nodes : Lists nodes in a given DC
/v1/catalog/services : Lists services in a given DC
/v1/catalog/service/<service> : Lists the nodes in a given service
/v1/catalog/node/<node> : Lists the services provided by a node

health篇
health endpoints用来查询健康状况相关信息，该功能从catalog中单独分离出来

/v1/healt/node/<node>: 返回node所定义的检查，可用参数?dc=
/v1/health/checks/<service>: 返回和服务相关联的检查，可用参数?dc=
/v1/health/service/<service>: 返回给定datacenter中给定node中service
/v1/health/state/<state>: 返回给定datacenter中指定状态的服务，state可以是"any", "unknown", "passing", "warning", or "critical"，可用参数?dc=

session篇
session endpoints用来create、update、destory、query sessions

/v1/session/create: Creates a new session
/v1/session/destroy/<session>: Destroys a given session
/v1/session/info/<session>: Queries a given session
/v1/session/node/<node>: Lists sessions belonging to a node
/v1/session/list: Lists all the active sessions

acl篇
acl endpoints用来create、update、destory、query acl

/v1/acl/create: Creates a new token with policy
/v1/acl/update: Update the policy of a token
/v1/acl/destroy/<id>: Destroys a given token
/v1/acl/info/<id>: Queries the policy of a given token
/v1/acl/clone/<id>: Creates a new token by cloning an existing token
/v1/acl/list: Lists all the active tokens

event篇
event endpoints用来fire新的events、查询已有的events

/v1/event/fire/<name>: 触发一个新的event，用户event需要name和其他可选的参数，使用PUT方法
/v1/event/list: 返回agent知道的events

status篇
status endpoints用来或者consul 集群的信息

/v1/status/leader : 返回当前集群的Raft leader
/v1/status/peers : 返回当前集群中同事