Consul常用命令

agent 运行一个consul agent

consul agent -dev
join 将agent加入到consul集群

consul join IP
members 列出consul cluster集群中的members

consul members
leave 将节点移除所在集群

consul leave

Consul agent 命令详解

输入consul agent --help ，可以看到consul agent 的选项

consul agent 命令的常用选项，如下：

-data-dir
- 作用：指定agent储存状态的数据目录
- 这是所有agent都必须的
- 对于server尤其重要，因为他们必须持久化集群的状态
-config-dir
- 作用：指定service的配置文件和检查定义所在的位置
- 通常会指定为”某一个路径/consul.d”（通常情况下，.d表示一系列配置文件存放的目录）
-config-file
- 作用：指定一个要装载的配置文件
- 该选项可以配置多次，进而配置多个配置文件（后边的会合并前边的，相同的值覆盖）
-dev
- 作用：创建一个开发环境下的server节点
- 该参数配置下，不会有任何持久化操作，即不会有任何数据写入到磁盘
- 这种模式不能用于生产环境（因为第二条）
-bootstrap-expect
- 作用：该命令通知consul server我们现在准备加入的server节点个数，该参数是为了延迟日志复制的启动直到我们指定数量的server节点成功的加入后启动。
-node
- 作用：指定节点在集群中的名称
- 该名称在集群中必须是唯一的（默认采用机器的host）
- 推荐：直接采用机器的IP
-bind
- 作用：指明节点的IP地址
- 有时候不指定绑定IP，会报Failed to get advertise address: Multiple private IPs found. Please configure one. 的异常
-server
- 作用：指定节点为server
- 每个数据中心（DC）的server数推荐至少为1，至多为5
- 所有的server都采用raft一致性算法来确保事务的一致性和线性化，事务修改了集群的状态，且集群的状态保存在每一台server上保证可用性
- server也是与其他DC交互的门面（gateway）
-client
- 作用：指定节点为client，指定客户端接口的绑定地址，包括：HTTP、DNS、RPC
- 默认是127.0.0.1，只允许回环接口访问
- 若不指定为-server，其实就是-client
-join
- 作用：将节点加入到集群
-datacenter（老版本叫-dc，-dc已经失效）
- 作用：指定机器加入到哪一个数据中心中

使用-client 参数可指定允许客户端使用什么ip去访问，例如-client 192.168.11.143 表示可以使用http://192.168.11.143:8500/ui 去访问。

consul搭建集群

启动node0机器上的Consul（node0机器上执行）：

1	consul agent -data-dir /tmp/node0 -node=node0 -bind=192.168.11.143 -datacenter=dc1 -ui -client=192.168.11.143 -server -bootstrap-expect 1

启动node1机器上的Consul（node1机器上执行）：

1	consul agent -data-dir /tmp/node1 -node=node1 -bind=192.168.11.144 -datacenter=dc1 -ui

启动node2机器上的Consul（node2机器上执行）：

1	consul agent -data-dir /tmp/node2 -node=node2 -bind=192.168.11.145 -datacenter=dc1 -ui -client=192.168.11.145

将node1节点加入到node0上（node1机器上执行）：

1	consul join 192.168.11.143

将node2节点加入到node0上（node2机器上执行）：

1	consul join -rpc-addr=192.168.11.145:8400 192.168.11.143

这样一个简单的Consul集群就搭建完成了，在node1上查看当前集群节点：

1	consul members -rpc-addr=192.168.11.143:8400

结果如下：

Node   Address              Status  Type    Build  Protocol  DC
node0  192.168.11.143:8301  alive   server  0.7.0  2         dc1
node1  192.168.11.144:8301  alive   client  0.7.0  2         dc1
node2  192.168.11.145:8301  alive   client  0.7.0  2         dc1

说明集群已经搭建成功了。

我们分析一下，为什么第5步和第6步需要加-rpc-addr 选项，而第4步不需要加任何选项呢？原因是-client 指定了客户端接口的绑定地址，包括：HTTP、DNS、RPC，而consul join 、consul members 都是通过RPC与Consul交互的。

我们三个节点都加了-ui 参数启动了内建的界面。我们可以通过：http://192.168.11.143:8500/ui/ 或者http://192.168.11.145:8500/ui/进行访问，也可以在node1机器上通过http://127.0.0.1:8500/ui/ 进行访问，原因是node1没有开启远程访问