devopsftw/consul

Consul 官方镜像构建说明

镜像概述

本镜像托管于https://hub.docker.com/r/hashicorp/consul/，与https://hub.docker.com/_/consul/基于相同源码构建，提供一致的功能和可靠性。

构建组件

镜像构建包含以下核心组件：

1. Alpine基础镜像
   采用轻量级Alpine作为基础，确保镜像体积小且资源占用低。

2. CA证书集成
   添加CA证书以支持访问HashiCorp发布服务器，同时使容器能够正常使用Atlas功能。

3. HashiCorp基础工具
   集成官方构建的基础工具（通过拉取docker-base版本），包括：

   • dumb-init：轻量级进程初始化工具，用于管理容器内进程
   • gosu：用于安全地切换用户身份的工具
     详细信息可参考https://github.com/hashicorp/docker-base。

4. Consul构建集成
   获取特定版本的Consul官方构建，并根据Dockerfile完成Consul专属配置。

核心特性

• 轻量级基础：基于Alpine，镜像体积小，运行效率高
• 安全访问：内置CA证书，支持与HashiCorp服务及Atlas功能的安全通信
• 进程管理：集成dumb-init确保容器内进程正确管理
• 权限控制：通过gosu实现安全的用户身份切换
• 官方一致性：与Docker官方Consul镜像同源，确保功能一致性和可靠性

使用场景

适用于需要实现以下功能的分布式系统环境：

• 服务发现与注册
• 分布式配置管理
• 健康检查
• 分布式锁与一致性协调

构建流程说明

镜像构建步骤如下：

1. 以Alpine为基础镜像，添加CA证书
2. 拉取docker-base发布版本，集成dumb-init和gosu工具
3. 获取指定版本的Consul官方构建
4. 执行Consul专属配置（基于Dockerfile定义）

使用方法

基本运行命令

bash
docker run -d --name consul docker.xuanyuan.run/hashicorp/consul

自定义配置示例

bash
docker run -d --name consul \
  -p 8500:8500 \
  -v /path/to/consul/config:/consul/config \
  docker.xuanyuan.run/hashicorp/consul agent -server -bootstrap -ui -client=0.0.0.0

Docker Compose配置示例

yaml
version: '3'
services:
  consul:
    image: hashicorp/consul
    ports:
      - "8500:8500"
    volumes:
      - ./consul/config:/consul/config
    command: agent -server -bootstrap -ui -client=0.0.0.0