MacOS中安装Consul（启动及关闭）

PS：非 brew 安装方式。

官网下载链接：https://www.consul.io/downloads.html

懒得去官网下载，或者官网下载速度慢的可以试一下下方蓝奏云链接。

蓝奏云v1.9.0下载：https://niceyoo.lanzous.com/iUBgwjyd6xa

1、解压并放置指定目录

下载解压后，将文件放置在 /usr/local/bin 目录下。

检测安装情况：

consul --version

相应截图如下：

2、启动及关闭命令

前台启动命令如下：（前台运行）

consul agent -dev

浏览器访问：http://localhost:8500

如上这种方式是以前台进行的启动，那么相应的只需要 ctrl + c 即可关闭 consul.

后台启动命令如下，部分参数根据自己情况修改：(后台运行)

consul agent -server -ui -bootstrap-expect=1 -client=0.0.0.0 -bind 你的ip地址 -data-dir=/状态数据存储文件夹/data >> /日志记录文件夹/logs/consul.log &

-bind：绑定的内部通讯地址，默认0.0.0.0，即所有的本地地址，也可以改为自己的ip地址。

-data-dir：状态数据存储用的文件目录

简单说一下这两条命令，其他参数参考后面标题3给出的解释。

命令执行参考：

consul agent -server -ui -bootstrap-expect=1 -client=0.0.0.0 -bind 192.168.1.100 -data-dir=/Users/niceyoo/workspace/File/consul/data >> /Users/niceyoo/workspace/File/consul/logs/consul.log &

执行命令截图：

关闭命令：如图所示，一般执行完就给出 PID 了，直接 kill 掉就可以了。

kill -9 21314

如果没有给出怎么办？

查看端口占用情况：lsof -i :8500

搜出来的 PID 结果直接 kill 即可。

3、常用命令解释

首先前面的 consul 肯定是省略不了了，看一下其他参数：

3.1、常用command命令

• agent：运行一个consul agent
• join：将agent加入到consul cluster
• members：列出consul cluster集群中的members

3.2、常用option选项命令

• -bootstrap：启动模式，此模式下，节点可以选举自己为leader，一个数据中心只能有一个此模式启动的节点。机群启动后，新启动的节点不建议使用这种模式。
• -bootstrap-expect：设定一个数据中心需要的服务节点数，可以不设置，设置的数字必须和实际的服务节点数匹配。consul会等待直到数据中心下的服务节点满足设定才会启动集群服务。初始化leader选举，不能和bootstr- ap混用。必须配合-server配置。
• -bind：绑定的内部通讯地址，默认0.0.0.0，即，所有的本地地址，会将第一个可用的ip地址散播到集群中，如果有多个可用的ipv4，则consul启动报错。[::]ipv6，TCP UDP协议，相同的端口。防火墙配置。
• -client：客户端模式，http dns，默认127.0.0.1，回环令牌网址
• -config-file：配置文件位置
• -config-dir：配置文件所在文件夹，会加载其下所有配置文件，.json或者.hcl文件，加载顺序为字母表顺序；可用配置多个此配置，从而加载多个文件夹，子文件夹的配置不会被加载。
• -config-format：配置文件格式，配置了，则加载相应个是的文件。不配置，则consul自动识别。
• -data-dir：状态数据存储文件夹，所有的节点都需要。文件夹位置需要不收consul节点重启影响，必须能够使用操作系统文件锁，unix-based系统下，文件夹文件权限为0600，注意做好账户权限控制，
• -datacenter：数据中心名称，默认dc1，一个数据中心的所有节点都必须在一个LAN中。
• -dev：开发模式，去掉所有持久化选项，内存服务器模式。
• -disable-host-node-id：不使用host信息生成node ID，适用于同一台服务器部署多个实例用于测试的情况。随机生成nodeID
• -dns-port：v7.0以后，自定义dns 端口，覆盖默认8600
• -enable-script-checks：是否允许使用脚本进行健康检查，默认false，最好配置enable acl
• -encrypt：consul网络通讯加密key，base64加密，16比特；consul keygen产生。集群中的每个实例必须提供相同的，只需提供一次，然后会保存到数据文件。重启自动加载。consul节点启动后提供，会被忽略。
• -hcl：添加hcl格式配置，和已有的配置合并。可以使用多个此配置。
• -http-port：http api端口，覆盖默认的8500。适用于云环境指定。
• -log-file：日志记录文件，如果没有提供文件名，则默认Consul-时间戳.log
• -log-level：日志级别，默认info，包含：trace，debug，info，warn，err；consul monitor监控
• -log-rotate-bytes：新日志文件生成大小阈值。
• -log-rotate-rotation：新日志生成时间阈值
• -join：需要加入的其它节点地址，可以多次使用，加入多个节点。
• -retry-join：会进行加入重试，适用于认定加入节点最终会正常的情况。ipv4，ipv6，dns
• -retry-interval：上述，重试间隔，默认30s
• -retry-max：重试次数，默认0，无限次重试
• -join-wan， -retry-join-wan， -retry-interval-wan， -retry-max-wan
• -node：节点名称，默认主机名
• -node-id：节点ID，
• -pid-file：consul 存储 pid 的文件位置，用于主动发信号。如停止节点，重载配置等。
• -protocol：使用的协议，升级时使用。consul -v查看协议版本
• -raft-protocol：使用raft协议版本，默认3
• -raft-snapshot-threshold：raft执行快照，提交次数阈值。一般不需要设置，io密集型应用可以调高。避免所有的节点同一时间快照。此值过大，会造成相应日志文件变大，节点重启恢复会耗费更长时间。1.1.0后，默认1- 6384，之前8192.
• -raft-snapshot-interval：执行快照间隔，影响类似上个配置，1.1.0后默认30s，之前5s。
• -rejoin：节点会尝试重新加入集群。
• -server：服务端节点模式。
• -server-port：服务端RPC端口，v1.2.2后提供。
• -non-voting-server：服务节点不参与选举，接受日志复制，用于横向扩展，服务查询请求。（类比zookeeper 观察者节点）
• -syslog：linux OSX系统，配置日志输出到系统日志。
• -ui：内置web ui界面。
• -ui-dir：web ui 资源文件夹，使用此配置，则不需也不能使用再-ui配置-

4、Consul 中默认的端口号

1. 服务器RPC（默认8300）：由服务器用来处理来自其他代理的传入请求，仅限TCP。
2. Serf LAN（默认8301）：用来处理局域网中的八卦。所有代理都需要，TCP和UDP。
3. Serf WAN（默认8302）：被服务器用来在WAN上闲聊到其他服务器，TCP和UDP。从Consul 0.8开始，建议通过端口8302在LAN接口上为TCP和UDP启用服务器之间的连接，以及WAN加入泛滥功能。
4. HTTP API（默认8500）：被客户用来与HTTP API交谈，仅限TCP。
5. DNS接口（默认8600）：用于解析DNS查询，TCP和UDP。