soulshake/consul

Consul Docker镜像文档

镜像概述

Consul是HashiCorp开发的分布式服务网格解决方案，提供服务发现、配置管理和分布式一致性功能。本镜像基于jfrazelle/dockerfiles仓库构建，发布于Docker Hub的https://hub.docker.com/u/jess/%E9%95%9C%E5%83%8F%E5%BA%93%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E3%80%81%E6%98%93%E7%94%A8%E7%9A%84Consul%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%E3%80%82%E6%AF%8F%E4%B8%AADockerfile%E9%A1%B6%E9%83%A8%E5%9D%87%E5%8C%85%E5%90%AB%E8%BF%90%E8%A1%8C%E5%91%BD%E4%BB%A4%EF%BC%8C%E4%BE%BF%E4%BA%8E%E5%BF%AB%E9%80%9F%E5%90%AF%E5%8A%A8%E5%92%8C%E4%BD%BF%E7%94%A8%E3%80%82

核心功能与特性

• 服务发现：自动注册和发现服务实例，支持DNS和HTTP接口查询
• 健康检查：内置多种健康检查机制（HTTP、TCP、脚本等），确保服务可用性
• 键值存储：分布式键值对存储，用于配置共享、特征标记等
• 多数据中心支持：跨数据中心服务发现和复制，实现全局服务视图
• 安全通信：支持TLS加密和ACL访问控制，保障服务通信安全

使用场景与适用范围

• 微服务架构中的服务注册与发现
• 分布式系统的配置中心
• 跨数据中心的服务协调
• 分布式锁和领导选举
• 服务健康状态监控与告警

使用方法与配置说明

基本运行命令

仓库中Dockerfile通常包含运行命令，基本开发模式启动命令如下：

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

关键参数说明

• -dev：以开发模式启动，适合本地测试，不持久化数据
• -client=0.0.0.0：允许外部访问Consul API（默认仅本地回环地址）
• -server：以服务器模式启动（生产环境需指定，至少3个节点保证一致性）
• -bootstrap-expect=N：指定预期的服务器节点数，达到数量后自动引导集群
• -data-dir：指定数据持久化目录

持久化部署

生产环境建议挂载数据卷持久化Consul数据：

bash
docker run -d --name consul -p 8500:8500 -v /path/to/consul/data:/consul/data jess/consul agent -server -bootstrap-expect=3 -client=0.0.0.0 -data-dir=/consul/data

环境变量配置

常用环境变量：

• CONSUL_BIND_INTERFACE：绑定的网络接口（如eth0）
• CONSUL_CLIENT_INTERFACE：客户端通信接口
• CONSUL_HTTP_ADDR：API访问地址（默认127.0.0.1:8500）

docker-compose配置示例

yaml
version: '3'
services:
  consul:
    image: jess/consul
    command: agent -server -bootstrap-expect=1 -client=0.0.0.0
    ports:
      - "8500:8500"   # HTTP API端口
      - "8600:8600/udp" # DNS端口
    volumes:
      - consul-data:/consul/data
    environment:
      - CONSUL_BIND_INTERFACE=eth0

volumes:
  consul-data:

相关资源

• 镜像仓库：https://hub.docker.com/u/jess/
• 源码仓库：https://github.com/jfrazelle/dockerfiles
• 便捷启动脚本：https://github.com/jfrazelle/dotfiles/blob/master/.dockerfunc%EF%BC%88%E5%8C%85%E5%90%AB%E9%95%9C%E5%83%8F%E7%9B%B8%E5%85%B3%E5%88%AB%E5%90%8D%E9%85%8D%E7%BD%AE%EF%BC%89
• 官方文档：Consul官方指南