jfusterm/consul

镜像概述

Consul是一款用于基础设施中服务发现和配置的工具，本镜像基于Alpine构建，提供轻量级的Consul运行环境。适用于现代弹性基础设施，帮助DevOps团队和应用开发者实现服务注册、健康监控、配置管理及跨数据中心协调。

标签信息

• 0.7.0, 0.7, latest https://github.com/jfusterm/dockerfiles/blob/master/consul/Dockerfile

核心功能与特性

服务发现

Consul客户端可注册服务（如api或mysql），其他客户端通过DNS或HTTP方式发现服务提供者，使应用能轻松找到依赖服务。

健康检查

支持多种健康检查方式，可关联特定服务（如“Web服务器是否返回200 OK”）或本地节点（如“内存使用率是否低于90%”）。健康状态用于监控集群健康，并指导服务发现组件避开不健康主机。

键值存储

提供分层键值存储，可用于动态配置、功能标记、协调、leader选举等场景，通过简单HTTP API轻松使用。

多数据中心支持

原生支持多数据中心，用户无需构建额外抽象层即可扩展至多个区域。

使用场景与适用范围

• 微服务架构：实现服务间的自动发现与负载均衡
• 分布式系统：提供统一的配置管理和健康监控
• 多区域部署：支持跨数据中心的服务协调与同步
• DevOps实践：简化服务部署、扩展和故障转移流程

使用方法与配置说明

基本运行命令

启动Consul开发模式（单节点，用于测试）

bash
docker run -d --name consul-dev jfusterm/consul agent -dev -client=0.0.0.0

启动Consul服务器节点（生产环境）

bash
docker run -d --name consul-server \
  -p 8500:8500 \
  -p 8600:8600/udp \
  jfusterm/consul agent -server -bootstrap-expect=1 -client=0.0.0.0 -ui

Docker Compose配置示例

yaml
version: '3'
services:
  consul:
    image: jfusterm/consul:latest
    container_name: consul
    ports:
      - "8500:8500"  # HTTP API端口
      - "8600:8600/udp"  # DNS端口
    command: agent -server -bootstrap-expect=1 -client=0.0.0.0 -ui
    volumes:
      - consul-data:/consul/data
    restart: always

volumes:
  consul-data:

主要配置参数说明

• -dev：启动开发模式，单节点，数据存储在内存中（不适合生产）
• -server：以服务器模式运行（参与Raft共识）
• -bootstrap-expect=N：指定期望的服务器节点数量，达到数量后启动引导
• -client=0.0.0.0：允许所有网络接口访问Consul API
• -ui：启用内置Web UI（访问http://localhost:8500/ui）
• -bind=IP：指定绑定的IP地址（默认自动检测）

环境变量

• CONSUL_BIND_INTERFACE：指定绑定的网络接口（如eth0），自动获取该接口的IP地址