civiclabs/consul

Docker中的Consul Agent

该项目是http://www.consul.io/的Docker容器实现，基于https://github.com/progrium/busybox构建（镜像体积约50MB），针对Docker生态系统进行预配置，便于快速部署和使用。

获取镜像

可通过Docker Hub拉取镜像：

bash
docker pull docker.xuanyuan.run/progrium/consul

使用容器

快速试用Consul

运行单实例Consul Agent以体验功能：

bash
docker run -p 8400:8400 -p 8500:8500 -p 8600:53/udp -h node1 docker.xuanyuan.run/progrium/consul -server -bootstrap

添加-ui-dir启用Web UI：

bash
docker run -p 8400:8400 -p 8500:8500 -p 8600:53/udp -h node1 docker.xuanyuan.run/progrium/consul -server -bootstrap -ui-dir /ui

端口说明：8400（RPC）、8500（HTTP）、8600（DNS）。可通过curl访问HTTP接口：

bash
curl localhost:8500/v1/catalog/nodes

或dig访问DNS接口：

bash
dig @0.0.0.0 -p 8600 node1.node.consul

单主机集群测试

启动3节点Consul集群：

1. 启动第一个节点（等待3个节点加入）：

bash
docker run -d --name node1 -h node1 docker.xuanyuan.run/progrium/consul -server -bootstrap-expect 3

2. 获取节点IP：

bash
JOIN_IP=$(docker inspect -f '{{.NetworkSettings.IPAddress}}' node1)

3. 启动第二个节点：

bash
docker run -d --name node2 -h node2 docker.xuanyuan.run/progrium/consul -server -join $JOIN_IP

4. 启动第三个节点：

bash
docker run -d --name node3 -h node3 docker.xuanyuan.run/progrium/consul -server -join $JOIN_IP

5. 启动客户端节点（非集群节点，用于交互）：

bash
docker run -d -p 8400:8400 -p 8500:8500 -p 8600:53/udp --name node4 -h node4 docker.xuanyuan.run/progrium/consul -join $JOIN_IP

生产环境集群部署

在多主机私有网络中部署：

• 假设主机私有IP为10.0.1.1，启动第一个节点：

bash
docker run -d -h node1 -v /mnt:/data \
  -p 10.0.1.1:8300:8300 \
  -p 10.0.1.1:8301:8301 \
  -p 10.0.1.1:8301:8301/udp \
  -p 10.0.1.1:8302:8302 \
  -p 10.0.1.1:8302:8302/udp \
  -p 10.0.1.1:8400:8400 \
  -p 10.0.1.1:8500:8500 \
  -p 172.17.42.1:53:53/udp \
  docker.xuanyuan.run/progrium/consul -server -advertise 10.0.1.1 -bootstrap-expect 3

• 第二个节点（IP：10.0.1.2）：

bash
docker run -d -h node2 -v /mnt:/data \
  -p 10.0.1.2:8300:8300 \
  -p 10.0.1.2:8301:8301 \
  -p 10.0.1.2:8301:8301/udp \
  -p 10.0.1.2:8302:8302 \
  -p 10.0.1.2:8302:8302/udp \
  -p 10.0.1.2:8400:8400 \
  -p 10.0.1.2:8500:8500 \
  -p 172.17.42.1:53:53/udp \
  docker.xuanyuan.run/progrium/consul -server -advertise 10.0.1.2 -join 10.0.1.1

特殊功能

Runner命令

生成生产环境运行命令：

bash
docker run --rm docker.xuanyuan.run/progrium/consul cmd:run 10.0.1.1 -d

输出可直接执行的docker run命令，支持指定join IP和客户端模式（添加::client）。

Docker健康检查

需挂载Docker socket（-v /var/run/docker.sock:/var/run/docker.sock）：

• check-http <容器ID> <端口> <路径>：HTTP健康检查
• check-cmd <容器ID> <端口> <命令>：自定义命令检查

DNS服务

容器内监听53端口，支持递归查询。配置Docker使用该DNS： 在Ubuntu中修改/etc/default/docker：

bash
echo "DOCKER_OPTS='--dns 172.17.42.1 --dns 8.8.8.8 --dns-search service.consul'" >> /etc/default/docker

注意事项

快速重启同一IP节点可能导致ARP缓存问题，建议等待3分钟或手动清除缓存。

赞助

本项目由http://digitalocean.com支持。

许可证

BSD许可证