leg100/consul

Hashicorp Consul 容器

镜像概述和主要用途

本项目提供Hashicorp Consul的Docker容器，包含用于运行3节点Consul服务器集群的docker-compose.yml文件。基础镜像采用Ubuntu，其他容器使用alpine-linux以减小文件体积。需注意：alpine-linux环境下存在主机名无法在/etc/hosts中解析的问题，可能影响依赖docker links的docker-compose功能。

核心功能和特性

leg100/consul

• 基础版Consul容器，不包含任何配置文件
• 提供Consul运行的最小环境，适合自定义配置部署

leg100/consul-agent

• 预配置为Consul agent模式运行
• 适用于作为Consul集群的客户端节点，负责服务注册与健康检查

leg100/consul-server

• 预配置为Consul server模式运行
• 包含Consul UI界面，支持通过Web界面管理集群
• 适用于作为Consul集群的服务器节点，负责数据存储与集群协调

使用场景和适用范围

• 开发测试环境：快速搭建Consul服务发现和配置管理环境
• 生产环境基础：作为Consul集群部署的基础组件，可根据需求扩展配置
• 微服务架构：为微服务提供服务注册、发现及配置共享能力

使用方法和配置说明

基础使用（leg100/consul）

运行基础版Consul容器：

bash
docker run -d --name consul leg100/consul

Agent模式使用（leg100/consul-agent）

运行Consul agent（需指定服务器地址）：

bash
docker run -d --name consul-agent leg100/consul-agent -server-addr=<consul-server-ip>:8500

Server模式使用（leg100/consul-server）

运行Consul server（单节点示例）：

bash
docker run -d -p 8500:8500 --name consul-server leg100/consul-server

访问UI界面：打开浏览器访问 http://<容器IP>:8500

3节点服务器集群部署

使用项目提供的docker-compose.yml快速部署3节点Consul服务器集群：

bash
# 克隆项目后进入目录
docker-compose up -d

注意：由于alpine-linux的主机名解析问题，建议在生产环境中使用Ubuntu基础镜像的容器或调整/etc/hosts配置以确保docker links正常工作。