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 中默认的端口号
- 服务器RPC(默认8300):由服务器用来处理来自其他代理的传入请求,仅限TCP。
- Serf LAN(默认8301):用来处理局域网中的八卦。所有代理都需要,TCP和UDP。
- Serf WAN(默认8302):被服务器用来在WAN上闲聊到其他服务器,TCP和UDP。从Consul 0.8开始,建议通过端口8302在LAN接口上为TCP和UDP启用服务器之间的连接,以及WAN加入泛滥功能。
- HTTP API(默认8500):被客户用来与HTTP API交谈,仅限TCP。
- DNS接口(默认8600):用于解析DNS查询,TCP和UDP。