microserviceframework/consul

HashiCorp Consul 镜像文档

镜像概述

本镜像为HashiCorp Consul的官方Docker化部署版本，专为微服务框架核心栈设计。Consul是一个分布式服务网格解决方案，提供服务发现、配置管理、分布式锁及多数据中心支持等功能，是构建微服务架构的关键组件。

核心功能与特性

• 服务发现：通过DNS或HTTP接口实现服务注册与发现，支持动态服务注册和健康状态监控
• 健康检查：内置多种健康检查机制（HTTP、TCP、脚本等），确保服务可用性
• KV存储：提供分布式键值存储，用于配置管理、特征标记和协调
• 多数据中心支持：原生支持跨数据中心服务发现与通信
• ACL访问控制：细粒度的访问控制策略，保障服务通信安全
• 自动TLS加密：支持自动生成和轮换TLS证书，加密服务间通信

使用场景与适用范围

• 微服务架构：作为服务注册中心，实现微服务间的动态发现与通信
• 分布式配置管理：集中管理微服务配置，支持动态配置更新
• 服务健康监控：实时监控服务状态，触发告警或自动恢复机制
• 跨数据中心部署：在多区域部署中实现服务协同与数据同步
• 容器编排集成：与Kubernetes、Docker Swarm等容器编排平台无缝集成

使用方法与配置说明

基本运行命令

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

Docker Compose配置示例

yaml
version: '3'
services:
  consul:
    image: hashicorp/consul
    container_name: consul
    ports:
      - "8500:8500"  # HTTP API端口
      - "8600:8600/udp"  # DNS端口
      - "8300:8300"  # 服务器RPC端口
      - "8301:8301"  # Serf LAN端口
      - "8302:8302"  # Serf WAN端口
    volumes:
      - ./consul-data:/consul/data  # 持久化数据
    command: agent -server -bootstrap -ui -client=0.0.0.0
    restart: always

核心配置参数

环境变量

常用启动参数

• -server：以服务器模式运行（需3-5节点集群）
• -client：指定客户端访问地址（默认127.0.0.1，设为0.0.0.0允许外部访问）
• -bootstrap：单节点模式引导（仅用于开发环境）
• -ui：启用Web管理界面
• -join：加入现有Consul集群（如-join=192.168.1.100）
• -datacenter：指定数据中心名称（默认dc1）

数据持久化

通过挂载卷实现数据持久化，避免容器重启后数据丢失：

bash
docker run -d --name consul -v /path/to/consul/data:/consul/data hashicorp/consul agent -server -bootstrap -ui -client=0.0.0.0

集群部署示例

3节点集群部署（生产环境推荐）：

bash
# 节点1（引导节点）
docker run -d --name consul-node1 -p 8500:8500 hashicorp/consul agent -server -bootstrap-expect=3 -ui -client=0.0.0.0 -node=node1

# 节点2
docker run -d --name consul-node2 hashicorp/consul agent -server -ui -client=0.0.0.0 -node=node2 -join=<node1-ip>

# 节点3
docker run -d --name consul-node3 hashicorp/consul agent -server -ui -client=0.0.0.0 -node=node3 -join=<node1-ip>

访问Web界面

启动容器后，通过http://<主机IP>:8500访问Consul Web管理界面，可查看服务列表、健康状态、KV存储和集群信息。