sdelrio/consul

采用自动驾驶模式的Consul

Consul Docker镜像，按照自动驾驶模式设计为自运行模式。本应用展示了对Consul Raft的配置支持，使其可用作采用自动驾驶模式的其他应用的高可用服务发现目录。

镜像概述和主要用途

本镜像基于官方Consul镜像构建，采用自动驾驶模式设计，旨在Docker Swarm环境中实现自管理的Consul集群。通过配置Consul Raft协议，提供高可用的服务发现能力，适用于需要服务注册与发现的分布式应用场景。注意：本镜像为概念验证版本，不建议用于生产环境。

核心功能和特性

• 支持Consul Raft协议配置，实现高可用集群
• 自动通过Docker DNS发现其他Consul节点
• 日志输出领导者状态，便于监控集群状态
• 支持HTTP/HTTPS协议进行领导者选举
• 提供-disable-host-node-id参数，避免同一主机上容器的节点ID冲突

使用场景和适用范围

适用于Docker Swarm模式下的服务发现概念验证，可作为分布式应用的服务注册中心。适合开发和测试环境，用于验证服务发现机制和集群扩展能力，不适合生产环境部署。

使用方法和配置说明

在VirtualBox Swarm集群中运行Consul

1. 环境准备

确保已安装Docker for Windows、Docker for Mac或Docker Toolbox（包含docker和docker-compose）。

2. 创建Swarm模式集群

--engine-opt experimental选项非必需，但在Docker v1.13+中可使用docker service logs consul查看集群中所有服务的日志。

bash
for i in 1 2 3; do
    docker-machine create -d virtualbox --engine-opt experimental swarm-$i
done

eval $(docker-machine env swarm-1)

docker swarm init --advertise-addr $(docker-machine ip swarm-1)

TOKEN=$(docker swarm join-token -q manager)

for i in 2 3; do
  eval $(docker-machine env swarm-$i)
  docker swarm join --token $TOKEN --advertise-addr $(docker-machine ip swarm-$i) $(docker-machine ip swarm-1):2377
done

3. 创建Consul网络

bash
docker network create consul-net -d overlay --subnet=172.20.0.0/24

--subnet选项非必需，仅用于避免与Docker默认的10.x.x.x网段冲突。

4. 创建Swarm服务

4.1 使用docker-compose v1.10+

bash
docker deploy -c docker-compose.yml consul

4.2 手动创建服务

bash
docker service create --network=consul-net --name=consul \
    -e 'CONSUL_LOCAL_CONFIG={"skip_leave_on_interrupt": true}' \
    -e CONSUL_BIND_INTERFACE='eth0' \
    -e CONSUL=consul \
    -e CONSUL_CHECK_LEADER=true \
    --replicas 3 \
    --update-delay 10s \
    --update-parallelism 1 \
    -p 8500:8500 sdelrio/consul

环境变量

本镜像基于官方consul镜像构建，支持所有官方环境变量（如CONSUL_LOCAL_CONFIG、CONSUL_BIND_INTERFACE），此外还支持以下自定义变量：

• CONSUL：用于查询其他Consul节点的服务名称。镜像将通过Docker DNS查找其他节点，通常设为Swarm服务名称。

• CONSUL_CHECK_LEADER：若设为true，日志将在每个健康检查间隔输出当前容器是否为领导者，以及容器IP和领导者IP：

  consul_consul.3.l0e0zr114x50@swarm-1    | 2017/01/26 00:11:22     [CP] I'm leader (172.20.0.6)
  consul_consul.2.qwx39safki82@swarm-2    | 2017/01/26 00:11:26     [CP] Leader is 172.20.0.6, I'm 172.20.0.3
  

• PROTO：领导者选举使用的协议，默认值为http。可设为https，此时选举地址为${PROTO}://${CONSUL}:8500/v1/status/leader。

Docker入口点

入口点通过containerpilot执行Consul，可通过命令参数自定义配置。默认命令需3个副本：

bash
agent -server -bootstrap-expect 3 -ui -client=0.0.0.0 -retry-interval 5s --log-level warn -disable-host-node-id

Consul默认根据主机名生成节点ID，在同一主机运行多个Consul容器时可能冲突。Consul（v0.8.1+）提供-disable-host-node-id标志以避免此问题。

参考资料

• 官方Consul镜像：https://hub.docker.com/_/consul/
• 自动驾驶模式Consul：https://github.com/autopilotpattern/consul