noenv/consul

Consul Docker镜像

镜像概述和主要用途

Consul是HashiCorp开发的开源工具，提供服务发现、配置管理和分布式一致性能力。本Docker镜像封装了Consul服务，旨在为容器化环境提供轻量级、可移植的部署方案，简化Consul在开发、测试和生产环境中的配置与运行流程，适用于各类分布式系统的服务协调场景。

核心功能和特性

• 服务发现：自动注册和发现服务实例，支持HTTP API和DNS两种服务发现方式
• 健康检查：内置多种健康检查机制（HTTP、TCP、脚本等），实时监控服务状态并自动隔离异常实例
• 键值存储：提供分布式键值对存储，用于配置管理、特性标记、分布式锁等场景
• 多数据中心支持：原生支持跨数据中心部署，实现全球分布式服务的统一协调与可见性
• 安全通信：支持TLS加密通信、ACL访问控制和Gossip加密，保障服务间数据传输安全
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低，启动速度快

使用场景和适用范围

• 微服务架构：作为服务注册中心，解决微服务间的服务发现与通信问题
• 分布式配置管理：通过键值存储集中管理分布式系统的动态配置，支持配置实时更新
• 容器编排环境：适配Kubernetes、Docker Swarm等容器编排平台，提供容器服务的注册与发现能力
• 跨数据中心部署：支持多数据中心架构，满足全球化分布式系统的服务协调需求
• 开发与测试环境：通过开发模式快速搭建本地Consul环境，加速依赖服务发现的应用开发测试

使用方法和配置说明

基本使用（开发模式）

开发模式下，Consul以单节点模式运行，自动生成配置，无需持久化存储，适合本地开发测试：

bash
docker run -d \
  --name consul-dev \
  -p 8500:8500 \  # HTTP API端口（Web UI访问端口）
  -p 8600:8600/udp  # DNS服务端口
  noenv/consul agent -dev -client=0.0.0.0

访问 http://localhost:8500 可打开Consul Web UI，查看服务状态和配置信息。

生产模式（服务器节点）

生产环境需部署多节点集群以保证高可用（建议至少3个服务器节点），以下为单服务器节点启动示例（实际部署需调整节点数量）：

bash
docker run -d \
  --name consul-server \
  -v /host/path/consul/data:/consul/data \  # 挂载数据目录，持久化集群数据
  -e CONSUL_BIND_INTERFACE=eth0 \  # 绑定主机网络接口（根据实际网络环境调整）
  -p 8300:8300 \  # 服务器间RPC端口
  -p 8301:8301/tcp \  # Serf LAN端口（TCP）
  -p 8301:8301/udp \  # Serf LAN端口（UDP）
  -p 8302:8302/tcp \  # Serf WAN端口（TCP，多数据中心时使用）
  -p 8302:8302/udp \  # Serf WAN端口（UDP，多数据中心时使用）
  -p 8500:8500 \  # HTTP API端口
  -p 8600:8600/udp  # DNS服务端口
  noenv/consul agent -server \
    -bootstrap-expect=3 \  # 期望的服务器节点总数（集群初始化时需指定）
    -data-dir=/consul/data \  # 数据持久化目录
    -client=0.0.0.0 \  # 允许外部访问HTTP API
    -ui  # 启用内置Web UI

客户端节点

客户端节点用于转发服务请求至服务器集群，扩展服务发现能力，适合部署在应用所在节点：

bash
docker run -d \
  --name consul-client \
  -e CONSUL_BIND_INTERFACE=eth0 \
  noenv/consul agent \
    -client=0.0.0.0 \
    -join=<server-ip>  # 加入服务器集群（替换为实际服务器节点IP，多个节点用逗号分隔）

关键配置参数

环境变量

常用命令行参数

数据持久化

生产环境必须挂载数据目录以防止容器重启导致数据丢失（服务器节点核心数据包括集群状态、服务注册信息等）：

bash
docker run -d \
  --name consul-server \
  -v /host/path/consul/data:/consul/data \  # 主机目录需提前创建并授权
  noenv/consul agent -server -data-dir=/consul/data ...

健康检查配置

可通过Docker健康检查监控Consul服务状态，自动重启异常容器：

bash
docker run -d \
  --name consul \
  --health-cmd "curl -f http://localhost:8500/v1/status/leader || exit 1" \  # 检查leader节点是否存在
  --health-interval 10s \  # 检查间隔
  --health-timeout 5s \    # 检查超时时间
  --health-retries 3 \     # 连续失败次数达到阈值后标记为不健康
  noenv/consul agent -dev -client=0.0.0.0