anduin/consul

Consul Docker镜像文档

镜像概述

本镜像为Anduin Transaction Inc提供的Consul官方Docker镜像，用于简化Consul服务的部署与运行。Consul是HashiCorp开发的分布式服务网格工具，核心功能包括服务发现、健康检查、键值存储及多数据中心支持，适用于构建可靠的微服务架构。

核心功能与特性

• 服务发现：自动注册和发现服务实例，支持DNS和HTTP两种查询方式
• 健康检查：内置多种健康检查机制（HTTP、TCP、脚本等），实时监控服务状态
• 键值存储：分布式键值对存储，用于配置管理、特性标记等场景
• 多数据中心：原生支持跨数据中心服务发现与通信，实现全球分布式部署
• 安全特性：提供TLS加密通信、ACL访问控制和身份验证，保障服务安全

使用场景

• 微服务架构中的服务注册与发现
• 分布式系统的动态配置管理
• 服务健康监控与自动故障转移
• 跨数据中心的服务协调与通信
• 容器化环境中的服务网格构建

使用方法

基本部署（开发模式）

使用以下命令快速启动Consul开发模式（单节点，不持久化数据）：

bash
docker run -d --name consul -p 8500:8500 -p 8600:8600/udp anduintransaction/consul agent -dev -client=0.0.0.0

• -dev：启用开发模式
• -client=0.0.0.0：允许外部访问Web UI和API
• 端口映射：8500（HTTP API/UI）、8600（DNS服务，UDP）

生产环境部署（持久化数据）

bash
docker run -d --name consul \
  -p 8500:8500 -p 8600:8600/udp -p 8300:8300 -p 8301:8301 -p 8302:8302 \
  -v /path/to/consul/data:/consul/data \
  anduintransaction/consul agent -server -bootstrap-expect=1 -client=0.0.0.0 -data-dir=/consul/data

• -server：以服务器模式运行
• -bootstrap-expect=1：期望集群节点数（单节点集群）
• -data-dir：指定数据持久化目录
• 端口说明：8300（服务器间通信）、8301（LAN gossip）、8302（WAN gossip）

环境变量配置

Docker Compose示例

yaml
version: '3.8'
services:
  consul:
    image: anduintransaction/consul
    container_name: consul-server
    restart: always
    ports:
      - "8500:8500"   # HTTP API/UI
      - "8600:8600/udp" # DNS服务
      - "8300:8300"   # 服务器间通信
      - "8301:8301"   # LAN gossip
      - "8302:8302"   # WAN gossip
    environment:
      - CONSUL_CLIENT=0.0.0.0
      - CONSUL_LOG_LEVEL=debug
      - CONSUL_DC=my-datacenter
    volumes:
      - consul-data:/consul/data
    command: agent -server -bootstrap-expect=1 -data-dir=/consul/data

volumes:
  consul-data:
    driver: local

访问Web UI

启动容器后，通过 http://localhost:8500 访问Consul Web管理界面，可查看服务列表、健康状态、键值存储等信息。