progrium/consul

Consul Agent Docker镜像

镜像概述

该项目是Consul的Docker容器实现，是一个经过预配置的Consul Agent，专门为Docker生态系统设计，具有轻量级特性（基于Busybox，虚拟大小仅50MB），可通过Docker Index获取和部署。

核心功能和特性

• 轻量级设计：基于Busybox构建，虚拟大小仅50MB，资源占用低
• 多模式支持：可运行为服务器节点（参与共识）或客户端节点（代理请求）
• 完整接口暴露：支持RPC（8400）、HTTP（8500）、DNS（8600/udp）接口
• Web UI集成：通过-ui-dir标志可启用Consul Web管理界面
• 集群支持：支持多节点集群部署，包括引导模式（bootstrap）和期望节点数引导（bootstrap-expect）
• 健康检查工具：内置check-http和check-cmd工具，支持容器化应用健康检查
• DNS功能：内置DNS服务，支持递归查询（使用Google 8.8.8.8 DNS）
• 便捷部署工具：提供cmd:run命令自动生成生产环境部署命令

使用场景和适用范围

• Consul功能试用：快速启动单节点Consul Agent，体验服务发现、健康检查等核心功能
• 集群功能测试：在单主机上部署多节点集群，测试共识机制、 leader选举、故障恢复等集群特性
• 生产环境部署：在多主机私有网络中部署高可用Consul集群，为分布式系统提供服务发现和配置管理

使用方法和配置说明

获取镜像

通过Docker Index获取镜像：

bash
$ docker pull progrium/consul

试用Consul

启动单节点Consul Agent（服务器模式，自动引导）：

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

启用Web UI（访问http://localhost:8500/ui）：

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

交互方式：

• HTTP接口：curl localhost:8500/v1/catalog/nodes
• DNS接口：dig @0.0.0.0 -p 8600 node1.node.consul
• Consul CLI（需主机安装Consul）：consul members

单主机测试Consul集群

部署3节点服务器集群，测试集群动态特性：

1. 启动第一个节点（设置期望3个节点，等待集群引导）：

   bash
   $ docker run -d --name node1 -h node1 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 progrium/consul -server -join $JOIN_IP
   

4. 启动第三个节点完成集群：

   bash
   $ docker run -d --name node3 -h node3 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 progrium/consul -join $JOIN_IP
   

生产环境部署Consul集群

在多主机私有网络中部署生产级集群，需注意：

• 主机间需私有网络连通
• 使用-advertise指定私有IP
• 暴露所有Consul端口并绑定到私有IP
• 挂载/data卷用于数据持久化

节点1（私有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 \
    progrium/consul -server -advertise 10.0.1.1 -bootstrap-expect 3

节点2（私有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 \
    progrium/consul -server -advertise 10.0.1.2 -join 10.0.1.1

节点3（私有IP：10.0.1.3）：

bash
$ docker run -d -h node3 -v /mnt:/data  \
    -p 10.0.1.3:8300:8300 \
    -p 10.0.1.3:8301:8301 \
    -p 10.0.1.3:8301:8301/udp \
    -p 10.0.1.3:8302:8302 \
    -p 10.0.1.3:8302:8302/udp \
    -p 10.0.1.3:8400:8400 \
    -p 10.0.1.3:8500:8500 \
    -p 172.17.42.1:53:53/udp \
    progrium/consul -server -advertise 10.0.1.3 -join 10.0.1.1

特殊功能

Runner命令

自动生成生产环境部署命令，格式：cmd:run <advertise-ip>[::<join-ip>[::client]] [docker-run-args...]

生成引导节点命令：

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

生成加入节点命令：

bash
$ docker run --rm progrium/consul cmd:run 10.0.1.1::10.0.1.2 -d -v /mnt:/data

生成客户端节点命令：

bash
$ docker run --rm progrium/consul cmd:run 10.0.1.4::10.0.1.2::client -d

健康检查工具

需挂载主机Docker socket：-v /var/run/docker.sock:/var/run/docker.sock

check-http

对容器内服务执行HTTP健康检查：

bash
check-http <container-id> <port> <path> [curl-args...]

示例：check-http myapp 8080 /health --retry 3

check-cmd

在临时容器中执行命令检查：

bash
check-cmd <container-id> <port> <command...>

示例：check-cmd mydb 5432 "pg_isready -U postgres"

DNS配置

将Consul DNS服务集成到Docker环境：

Ubuntu系统配置：

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

boot2docker (OS X)配置：

bash
$ boot2docker ssh sudo "ash -c \"echo EXTRA_ARGS=\'--dns 172.17.42.1 --dns $(scutil --dns | awk -F ': ' '/nameserver/{print $2}' | head -1) --dns-search service.consul\' > /var/lib/boot2docker/profile\""

测试DNS解析：

bash
$ docker run --rm aanand/docker-dnsutils dig -t SRV consul +search

运行时配置

推荐通过HTTP API动态配置服务和检查。如需自定义启动配置，可基于此镜像构建新镜像，添加config目录存放JSON配置文件，或通过opkg安装额外包。

已知问题

快速重启使用相同IP的节点可能导致集群加入失败，这是ARP表缓存问题。解决方法：等待3分钟后重启，或手动重置缓存。

许可

BSD