drillinginfo/consul

Consul 定制化镜像文档

镜像概述

本镜像是从hashicorp/docker-consul仓库分叉而来的定制化Consul镜像，基于原仓库基础上针对特定需求进行了版本升级、配置调整及权限优化。主要用于提供分布式服务发现、配置管理和分布式一致性等功能，适用于需要定制化Consul环境的场景。

核心功能与特性

版本变更说明

• 1.0.0

  • 基于gliderlabs/consul分叉
  • DNS配置：移除8.8.8.8递归器

• 2.0.0

  • 基于gliderlabs/consul分叉
  • 升级Consul至0.6.3版本，Docker至1.8.2版本

• 2.1.0

  • 基于gliderlabs/consul分叉
  • 添加leave_on_terminate标志，支持节点关闭时退出集群

• hashicorp-0.7.0

  • 基于Consul v0.7.0版本
  • 以root用户运行（原镜像使用'consul'用户）

• hashicorp-0.7.2

  • 基于Consul v0.7.2版本
  • 以root用户运行

• hashicorp-0.7.5

  • 基于Consul v0.7.5版本
  • 以root用户运行

• hashicorp-0.8.5

  • 基于Consul v0.8.5版本
  • 以root用户运行

使用场景

• 需要自定义DNS递归器配置的Consul集群环境
• 需在节点终止时自动退出集群的场景
• 要求以root用户权限运行Consul的特殊部署环境
• 需要特定Consul版本（如0.6.3、0.7.x、0.8.5）的应用场景

使用方法

基本运行命令

根据需求选择对应版本标签，基础运行命令如下：

bash
docker run -d --name consul [镜像名称]:[版本标签] agent -server -bootstrap-expect=1 -client=0.0.0.0

版本特性应用示例

1. 使用2.1.0版本（带leave_on_terminate标志）

bash
docker run -d --name consul-custom [镜像名称]:2.1.0 agent -server -bootstrap-expect=1 -client=0.0.0.0 -leave-on-terminate

2. 使用hashicorp-0.8.5版本（root用户运行）

bash
docker run -d --name consul-root [镜像名称]:hashicorp-0.8.5 agent -server -bootstrap-expect=1 -client=0.0.0.0

配置说明

• DNS配置：1.0.0版本移除了默认的8.8.8.8 DNS递归器，需在启动命令中通过-recursor参数指定自定义递归器，如：

  bash
  docker run -d --name consul-dns [镜像名称]:1.0.0 agent -server -bootstrap-expect=1 -client=0.0.0.0 -recursor=114.114.114.114
  

• leave_on_terminate标志：2.1.0及以上版本支持，启动时添加-leave-on-terminate参数可实现节点关闭时自动退出集群。

• 用户权限：hashicorp-0.7.0及后续版本默认以root用户运行，无需额外权限配置。