Consul手册

yum install bind-utils -y


wget https://releases.hashicorp.com/consul/1.11.4/consul_1.11.4_linux_amd64.zip #根据不同系统选择不同版本
yum install -y unzip
unzip consul_1.11.4_linux_amd64.zip
mv consul /usr/bin/ && chmod a+x /usr/bin/consul
#验证
consul

git clone https://github.com/hashicorp/consul.git 
make dev 
#或者
##通过在构建之前设置以下环境变量来指定您的目标系统：
#GOOS: 目标操作系统。有效值包括： linux, darwin, windows, solaris, freebsd.
#GOARCH: 目标架构。有效值包括： 386, amd64, arm,arm64
export GOOS=linux GOARCH=amd64
make dev

consul version

consul agent -dev
#Consul
Agent启动并输出了一些日志数据.从这些日志中你可以看到,我们的agent运行在server模式并且声明作为一个集群的领袖.额外的本地镀锌被标记为一个健康的成员.
#查看成员
consul members
#members命令的输出是基于gossip协议是最终一致的.意味着,在任何时候,通过你本地agent看到的结果可能不是准确匹配server的状态.为了查看到一致的信息,使用HTTPAPI(将自动转发)到ConsulServer上去进行查询:
curl localhost:8500/v1/catalog/nodes

#除了HTTPAPI,DNS接口也可以用来查询节点.注意,你必须确定将你的DNS查询指向Consul agent的DNS服务器,这个默认运行在8600端口.DNS条目的格式(例如"Armons-MacBook-Air.node.consul")
dig @127.0.0.1 -p 8600 Armons-MacBook-Air.node.consul

mkdir /etc/consul.d

echo '{"service":{"name":"web","tags":["rails"],"port":80}}' \
>/etc/consul.d/web.json

#现在重启agent,设置配置目录:
consul agent -dev -config-dir/etc/consul.d

#DNS API让我们首先使用DNS API来查询.在DNS API中,服务的DNS名字是NAME.service.consul.虽然是可配置的,但默认的所有DNS名字会都在consul命名空间下.这个子域告诉Consul,我们在查询服务,NAME则是服务的名称.对于我们上面注册的Web服务.它的域名是web.service.consul:[
dig @127.0.0.1 -p 8600 web.service.consul
dig @127.0.0.1 -p 8600 web.service.consul SRV
#SRV记录告诉我们web这个服务运行于节点docker04.node.dc1.consul的80端口.DNS额外返回了节点的A记录.


#HTTP API除了DNS API之外,HTTP API也可以用来进行服务查询
curl http://localhost:8500/v1/catalog/service/web

	Consul 的核心流程。代理维护成员信息、注册服务、运行检查、响应查询等。代理必须在属于 Consul 集群的每个节点上运行。

consul agent <options>

#使用静态网络接口名称
consul agent -advertise '{{ GetInterfaceIP "eth0" }}'
#在特定 CIDR 中使用地址
consul agent -bind '{{ GetPrivateInterfaces | include "network" "10.0.0.0/8" | attr "address" }}'
#使用静态网络接口名称
consul agent -bind '{{ GetInterfaceIP "eth0" }}'
#对可转发且向上的网络接口名称使用正则表达式匹配
 consul agent -bind '{{ GetAllInterfaces | include "name" "^eth" | include "flags" "forwardable|up" | attr "address" }}'
 
 #将 consul 客户端接口绑定到私有 IPv4 接口
 $ consul agent -dev -client '{{ GetPrivateInterfaces | exclude "type" "ipv6" | join "address" " " }}'
 
 #将 consul 客户端接口绑定到私有 IP 地址和环回
 consul agent -dev -client '{{ GetPrivateInterfaces | join "address" " " }} {{ GetAllInterfaces | include "flags" "loopback" | join "address" " " }}'
 
 #排除以“br-”开头的私有接口
 consul agent -dev -client '{{ GetPrivateInterfaces | exclude "name" "br.*" | join "address" " " }}'
 
#使用 DNS 条目
  consul agent -retry-join "consul.domain.internal"
 #使用 IPv4
consul agent -retry-join "10.0.4.67"

#使用非默认的 Serf LAN 端口
 consul agent -retry-join "192.0.2.10:8304"
 
 #使用 IPv6
 consul agent -retry-join "[::1]:8301"
 
 #使用多个地址
consul agent -retry-join "consul.domain.internal" -retry-join "10.0.4.67"

#使用云自动加入
consul agent -retry-join "provider=aws tag_key=..."

datacenter = "east-aws"
data_dir = "/opt/consul"
log_level = "INFO"
node_name = "foobar"
server = true
watches = [
  {
    type = "checks"
    handler = "/usr/bin/health-check-handler.sh"
  }
]

telemetry {
  statsite_address = "127.0.0.1:2180"
}

{
  "datacenter": "east-aws",
  "data_dir": "/opt/consul",
  "log_level": "INFO",
  "node_name": "foobar",
  "server": true,
  "watches": [
    {
      "type": "checks",
      "handler": "/usr/bin/health-check-handler.sh"
    }
  ],
  "telemetry": {
    "statsite_address": "127.0.0.1:2180"
  }
}

注意：下面描述的所有 TTL 值都由 Go 的time包解析，并具有以下 格式规范：“持续时间字符串是可能有符号的十进制数序列，每个都有可选的分数和单位后缀，例如 '300ms', ' -1.5h' 或 '2h45m'。有效的时间单位是 'ns'、'us'（或 'µs'）、'ms'、's'、'm'、'h'。

#第一个节点
consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul-node=hdp2 -bind=192.168.137.32 -config-dir /etc/consul.d
#其他节点
consul agent -data-dir /tmp/consul-node=hdp3 -bind=192.168.137.33 -config-dir /etc/consul.d

#进入第一节点服务 将其他节点加入
consul join 192.168.137.33
#注意防火墙端口问题
#查看成员
consul members


#或者
consul agent -config-dir /etc/consul.d/ -data-dir  /tmp/consul-node=hdp3 --bind=192.168.137.33  -join=192.168.137.32 
#启动时自动加入集群
consul agent -atlas-join -atlas=ATLAS_USERNAME/infrastructure -atlas-token="YOUR_ATLAS_TOKEN"



#查询节点
dig @127.0.0.1 -p 8600 hdp3.node.consul
dig @127.0.0.1 -p 8600 hdp2.node.consul

# 启动集群
sudo ./consul agent -server -bootstrap-expect 2 -data-dir=data -node=n1 -bind=0.0.0.0 -client=0.0.0.0 &



 #搭建管理工具
consul自带的WEB UI,Web ui是consul提供的可视化的服务web界面，可以对key/value和服务、节点进行操作

　　a)      下载consul web ui（包含一个html和一个static文件件），和本机中的consul放到同级目录。

　　b)     在本机启动consul,需要设置-ui-dir ./webui

sudo ./consul agent -server -bootstrap-expect 2 -data-dir=data -node=n3 -bind=10.0.0.7 -ui-dir=webui -client 0.0.0.0 &

consul agent -server -bootstrap-expect 1 -data-dir /tmp/consul-node=hdp2 -bind=192.168.137.32 -config-dir /etc/consul.d  -ui=true -client 0.0.0.0 

#配置生效顺序：
命令行>环境变量>配置文件
#命令行配置：
-bootstrap：启动模式，此模式下，节点可以选举自己为leader，一个数据中心只能有一个此模式启动的节点。机群启动后，新启动的节点不建议使用这种模式。
-bootstrap-expect：设定一个数据中心需要的服务节点数，可以不设置，设置的数字必须和实际的服务节点数匹配。consul会等待直到数据中心下的服务节点满足设定才会启动集群服务。初始化leader选举，不能和bootstrap混用。必须配合-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后，默认16384，之前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配置。


#默认使用端口：
服务端RPC：默认8300，TCP。
Serl LAN：处理LAN gossip，默认8301，TCP UDP。
Serl WAN：处理LAN gossip，默认8302，TCP UDP。
HTTP API：8500，TCP.
DNS：8600，TCP,UDP.

curl \
    --header "X-Consul-Token: <consul token>" \
    http://127.0.0.1:8500/v1/agent/members
    
curl \
    --header "Authorization: Bearer <consul token>" \
    http://127.0.0.1:8500/v1/agent/members

echo '{"check":{"name":"ping","shell":"ping -c1 163.com>/dev/null","ttl":  "5s"}}'>/etc/consul.d/ping.json

echo '{
  "check": {
    "id": "api",
    "name": "HTTP API on port 80",
    "http": "http://localhost:80/health",
    "tls_server_name": "",
    "tls_skip_verify": false,
    "method": "POST",
    "header": { "Content-Type": ["application/json"] },
    "body": "{\"method\":\"health\"}",
    "interval": "10s",
    "timeout": "1s"
  }
}'>/etc/consul.d/web.json

curl http://localhost:8500/v1/health/state/critical