masakazuwatanabe/consul

Consul Docker容器

镜像概述

该镜像提供Consul的Docker容器化部署，支持通过环境变量进行配置。Consul是一个分布式服务网格解决方案，提供服务发现、配置管理和分段功能。本镜像包含多种类型（默认、客户端、服务器），并基于不同基础镜像（CentOS 7、CentOS 6、Alpine）和版本（0.6、latest）构建，满足不同部署需求。

核心功能与特性

• 多类型支持：提供三种容器类型
  • consul：默认版本，可通过环境变量配置为客户端或服务器
  • consul-client：客户端专用版本
  • consul-server：服务器专用版本
• 多版本与基础镜像：支持Consul 0.6及latest版本，基础镜像包括CentOS 7、CentOS 6和Alpine
• 环境变量配置：通过环境变量灵活配置Consul代理参数，无需手动编写配置文件
• 轻量级选项：提供Alpine基础镜像版本，体积更小，适合资源受限环境

镜像标签说明

latest标签（Consul 0.6）

• 默认类型
  • consul:latest：基于CentOS 7的最新版本
  • consul:latest-centos7：基于CentOS 7的最新版本
  • consul:latest-centos6：基于CentOS 6的最新版本
  • consul:latest-alpine：基于Alpine的最新版本
• 客户端类型
  • consul-client:latest：基于CentOS 7的客户端最新版本
  • consul-client:latest-centos7：基于CentOS 7的客户端最新版本
  • consul-client:latest-centos6：基于CentOS 6的客户端最新版本
  • consul-client:latest-alpine：基于Alpine的客户端最新版本
• 服务器类型
  • consul-server:latest：基于CentOS 7的服务器最新版本
  • consul-server:latest-centos7：基于CentOS 7的服务器最新版本
  • consul-server:latest-centos6：基于CentOS 6的服务器最新版本
  • consul-server:latest-alpine：基于Alpine的服务器最新版本

0.6标签

• 默认类型
  • consul:0.6：基于CentOS 7的0.6版本
  • consul:0.6-centos7：基于CentOS 7的0.6版本
  • consul:0.6-centos6：基于CentOS 6的0.6版本
  • consul:0.6-alpine：基于Alpine的0.6版本
• 客户端类型
  • consul-client:0.6：基于CentOS 7的客户端0.6版本
  • consul-client:0.6-centos7：基于CentOS 7的客户端0.6版本
  • consul-client:0.6-centos6：基于CentOS 6的客户端0.6版本
  • consul-client:0.6-alpine：基于Alpine的客户端0.6版本
• 服务器类型
  • consul-server:0.6：基于CentOS 7的服务器0.6版本
  • consul-server:0.6-centos7：基于CentOS 7的服务器0.6版本
  • consul-server:0.6-centos6：基于CentOS 6的服务器0.6版本
  • consul-server:0.6-alpine：基于Alpine的服务器0.6版本

环境变量配置

主要环境变量

Consul的配置参数可通过环境变量设置，详细说明请参考Consul官方文档。主要环境变量包括：

• CONSUL_CONFIG_DIR：配置文件目录
• CONSUL_DEV：开发模式开关
• CONSUL_ACL_DATACENTER：ACL数据中心
• CONSUL_ACL_DEFAULT_POLICY：默认ACL策略
• CONSUL_ADVERTISE_ADDR：通告地址
• CONSUL_BIND_ADDR：绑定地址
• CONSUL_CLIENT_ADDR：客户端地址
• CONSUL_DATACENTER：数据中心名称
• CONSUL_DATA_DIR：数据存储目录
• CONSUL_LOG_LEVEL：日志级别
• CONSUL_NODE_NAME：节点名称
• CONSUL_PORTS_HTTP：HTTP端口
• CONSUL_SERVER：是否以服务器模式运行

额外环境变量

• CONSUL_EX_ADVERTISE_ADDR：额外通告地址
• CONSUL_EX_ADVERTISE_ADDRS_SERF_LAN：LAN Serf额外通告地址
• CONSUL_EX_ADVERTISE_ADDRS_SERF_WAN：WAN Serf额外通告地址
• CONSUL_EX_ADVERTISE_ADDRS_SERF_RPC：RPC额外通告地址
• CONSUL_EX_ADVERTISE_ADDR_WAN：WAN额外通告地址

使用方法

拉取镜像

拉取最新的默认类型（CentOS 7）镜像：

bash
docker pull consul:latest

拉取Alpine基础的客户端镜像：

bash
docker pull consul-client:latest-alpine

运行容器示例

1. 开发模式运行（默认类型）

bash
docker run -d --name consul-dev -e CONSUL_DEV=true consul:latest

2. 服务器模式运行

bash
docker run -d --name consul-server \
  -e CONSUL_SERVER=true \
  -e CONSUL_BOOTSTRAP_EXPECT=1 \
  -e CONSUL_CLIENT_ADDR=0.0.0.0 \
  -p 8500:8500 \
  consul-server:latest

3. 客户端模式运行（连接到现有服务器）

bash
docker run -d --name consul-client \
  -e CONSUL_CLIENT=true \
  -e CONSUL_RETRY_JOIN=192.168.1.100 \
  consul-client:latest

许可证

本镜像采用MIT许可证。