consul入门记
1.consul的安装
wget https://releases.hashicorp.com/consul/1.4.4/consul_1.4.4_linux_amd64.zipunzip consul_1.4.4_linux_amd64.zipsudo mv consul /usr/local/bin/2.使用命令行参数启动
#参数解释：
-server : 将agent以server模式启动
-bootstrap :直接将自己设为leader
-ui-dir : UI服务的路径
-data-dir : 数据存储路径
-node : 节点名字
-client : consul服务侦听地址，这个地址提供HTTP，DNS,RPC等服务，默认是127.0.0.0，所以不对外服务，如果要对外提供服务，需要改为0.0.0.0
-bind ：在集群内部的通讯地址，需要保证是否可达。
-rejoin ：表示退出当前集群后，下次启动仍然加入该集群。
2.1启动leader节点
consul agent -server -bootstrap \
-ui-dir=/etc/consul_ui \
-data-dir /tmp/consul \
-node master1 \
-client=0.0.0.0 \
-rejoin2.2启动follower节点
consul agent -server -data-dir /tmp/consul -node master2 -bootstrap-expect 2 -rejoin2.3启动follower节点
consul agent -server -data-dir /tmp/consul -node master3 -bootstrap-expect 2 -rejoin2.4手动将节点添加到集群
consul join 192.168.108.119 192.168.108.37#不建议开机就建立集群，这是因为其他节点未开启，会报错！
3.使用配置文件启动
新建配置文件
sudo vim /opt/consul/conf/server.json在文件夹中添加以下配置
{
"datacenter": "dc1",
"data_dir": "/opt/consul/data",
"log_level": "INFO",
"node_name": "master1",
"server": true,
"acl_enforce_version_8":false,
"bootstrap_expect": 1,
"client_addr": "0.0.0.0",
"advertise_addr": "192.168.11.55",
"bind_addr": "127.0.0.1",
"ui_dir": "/etc/consul_ui",
"retry_interval": "30s",
"enable_debug": false,
"enable_syslog": true,
"rejoin_after_leave": true,
"enable_syslog": true,
"syslog_facility": "local5"
}
#可以添加以下参数设置开机时自动组件集群，但不建议这么做，因为集群的ip变了的话，可能无法启动，需要每次检查修改。建议启动后再使用consul join 命令手动将节点加入集群。
"start_join": ["192.168.108.117","192.168.108.119","192.168.108.37"],
"retry_join": ["192.168.108.117","192.168.108.119","192.168.108.37"]#启动当前节点，并设为leader
sudo consul agent -server -bootstrap -config-dir /opt/consul/conf/ \
-pid-file=/opt/consul/run/consul.pid \
-disable-host-node-id#说明：
1)bootstrap_expect=1参数和-bootstrap命令参数无法同时使用。
2)注意这里的advertise_addr并不能设置为127.0.0.1,这样其他节点无法加入，因为它会直接广播此地址。
#在文件夹下新建配置文件:
请分别在其他节点上也建立配置文件，方法同上，注意将其中的node_name,advertise_addr(
当前主机ip),bind_addr(当前主机ip)修改，不要重复。
#设置服务节点（不设为leader）:
sudo consul agent -server -config-dir /opt/consul/conf/ \
-pid-file=/opt/consul/run/consul.pid \
-disable-host-node-id#说明：
client_addr需要设置为:0.0.0.0，否则其他主机无法直接访问8500端口，当然你也可以设置为特定ip，生产环境下并不建议全开放ip。
4.配置consul为后台启动
4.1编辑service启动文件
#新建文件
sudo vim /etc/systemd/system/consul.service#添加以下配置
[Unit]
Description=Consul service discovery agent
Requires=network-online.target
After=network-online.target
[Service]
Environment=GOMAXPROCS=2
Restart=on-failure
ExecStartPre=[ -f "/opt/consul/run/consul.pid" ] && /usr/bin/rm -f /opt/consul/run/consul.pid
ExecStart=/usr/local/bin/consul agent -config-file /opt/consul/conf/server.json
ExecReload=/bin/kill -HUP $MAINPID
KillSignal=SIGTERM
TimeoutStopSec=5
[Install]
WantedBy=multi-user.target#注意：以上指定的-config-file路径的文件在之前已经编辑好，如果没有编辑好，请提前编辑好，参加3配置文件启动。
4.2启动服务
sudo systemctl start consul4.3查看服务是否启动成功
sudo service consul status
5.为consul配置日志
5.1 创建日志存放目录并赋权
sudo mkdir -p /var/log/consul/chown -R syslog.syslog /var/log/consul/
5.2 启用系统日志
5.2.1 创建系统配置文件
sudo vim /etc/rsyslog.d/consul.conf#添加以下内容
local5.* /var/log/consul/consul.log
5.2.2 修改系统配置文件
sudo vim /etc/rsyslog.d/50-default.conf
5.2.3 重启rsyslog让配置生效
sudo systemctl restart rsyslog5.2.4 创建日志轮询规则
sudo vim /etc/logrotate.d/consul#添加以下内容
/var/log/consul/*log {
missingok
compress
notifempty
daily
rotate 5
create 0600 root root
}5.2.5 注意在consul启动项中配置syslog_enable=ture或者-syslog
5.2.6 确认syslog日志生效
sudo tail -f /var/log/consul/consul.log6.常见问题
6.1能访问5600端口但没法显示正确数据
错误原因：集群中没有leader或者通讯存在问题。
6.2无法访问5600端口
错误原因：没将将-client设为0.0.0.0
6.3 无法使用sudo systemctl start consul启动服务
启动文件有问题，如果没有，重启试试。
6.4 [/etc/systemd/system/consul.service:9] Executable path is not absolute, ignoring: [ -f "/opt/consul/run/consul.pid" ] && /usr/bin/rm -f /opt/
解决办法：
可能还是配置文件问题仔细检查拼写是不是有问题，如果确定没问题，那就是非语法错误，而是配置导致启动异常。
可以用consul agent -config-dir /opt/consul/conf/，如果配置文件有问题，则会报错。
consul agent -config-dir /opt/consul/conf/6.5 无法使用consul join命令添加节点
该地址没有被广播，在配置文件中的advertise_addr添加此地址。
7.参考资料
1)运维之美