qnib/consul

qnib/consul镜像说明

镜像概述

qnib/consul镜像用于运行Consul服务，Consul是开源的分布式服务发现与配置管理工具，支持多节点集群部署，帮助微服务架构实现服务自动发现、健康检查及配置同步。

核心功能

1. 支持Consul客户端与服务器两种运行模式
2. 暴露WebUI端口（8500）实现可视化管理
3. 通过环境变量配置引导节点（bootstrap）支持集群初始化
4. 兼容Docker网络实现容器间服务发现与通信

使用场景

• 微服务架构中的服务注册与发现
• 分布式系统的配置统一管理
• 多容器应用间的服务协调与通信

配置说明

主要通过环境变量配置：

• CONSUL_SERVER=true：启用服务器模式
• CONSUL_BOOTSTRAP=true：设置为集群引导节点
• CONSUL_CLUSTER_IPS：指定集群服务器节点的IP/主机名（客户端加入集群时使用）

部署示例

1. 启动Consul客户端

bash
docker run -d --name consul -h consul docker.xuanyuan.run/qnib/consul

注：仅客户端模式，无服务器功能，实用性有限。

2. 启动Consul服务器（暴露WebUI）

bash
docker run -d --name server -h server \
  -p 8500:8500 -e CONSUL_SERVER=true docker.xuanyuan.run/qnib/consul

注：未设置引导节点，需加入集群才能正常工作。

3. 启动引导节点服务器

bash
docker rm -f server
docker run -d --name server -h server -p 8500:8500 \
  -e CONSUL_SERVER=true \
  -e CONSUL_BOOTSTRAP=true docker.xuanyuan.run/qnib/consul

4. 部署Consul集群

创建Docker overlay网络

bash
docker network create consul

启动引导节点服务器

bash
docker run -d --name server -h server -p 8500:8500 --net consul \
  -e CONSUL_SERVER=true \
  -e CONSUL_BOOTSTRAP=true docker.xuanyuan.run/qnib/consul

启动客户端加入集群

bash
docker run -d --name kafka-manager -h kafka-manager \
  -e CONSUL_CLUSTER_IPS=server \
  --net consul qnib/kafka-manager