jpmcghee/consul

Consul (Alpine Linux) 镜像文档

镜像概述

本镜像基于Alpine Linux构建，派生自voxxit/consul，提供轻量级的Consul部署方案。Consul是HashiCorp开发的分布式服务网格工具，核心功能包括服务发现、健康检查、分布式键值存储及多数据中心支持。Alpine Linux的轻量级特性使本镜像具有体积小、资源占用低的优势，适合容器化环境部署。

核心功能与特性

Consul核心功能

• 服务发现：自动注册和发现服务实例，支持DNS和HTTP接口查询
• 健康检查：内置多种健康检查机制（HTTP、TCP、脚本等），确保服务可用性
• 键值存储：分布式键值对存储，用于配置管理、特征标记等场景
• 多数据中心支持：跨数据中心服务发现与连接，实现全局服务网格

镜像特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快
• 兼容性：继承voxxit/consul的配置逻辑，支持相同的启动参数和环境变量
• 可扩展性：支持单机模式、服务器集群模式部署，适应不同规模需求

使用场景与适用范围

• 开发/测试环境：快速搭建本地Consul服务，验证服务发现和配置管理逻辑
• 微服务架构：为容器化微服务提供服务注册与发现能力
• 边缘计算环境：在资源受限的边缘设备中部署轻量级服务网格
• CI/CD流水线：作为临时服务注册中心，支持自动化测试环境构建

使用方法与配置说明

基本运行（单机模式）

bash
docker run -d --name consul \
  -p 8500:8500 \  # HTTP API端口
  -p 8600:8600/udp  # DNS端口
  your-image-name agent -dev -client=0.0.0.0

参数说明：

• -dev：开发模式，自动初始化单节点集群，数据存储在内存中（非持久化）
• -client=0.0.0.0：允许外部访问Consul API

持久化数据

bash
docker run -d --name consul \
  -p 8500:8500 \
  -p 8600:8600/udp \
  -v /path/to/consul/data:/consul/data \
  your-image-name agent -server -bootstrap-expect=1 -client=0.0.0.0

说明：

• -server：以服务器模式运行
• -bootstrap-expect=1：期望集群中服务器节点数量（单节点集群）
• -v /path/to/consul/data:/consul/data：挂载本地目录持久化数据

环境变量配置

常用环境变量：

示例：指定自定义配置目录

bash
docker run -d --name consul \
  -e CONSUL_CONFIG_DIR=/consul/custom-config \
  -v /path/to/custom/config:/consul/custom-config \
  your-image-name agent -dev -client=0.0.0.0

Docker Compose示例

yaml
version: '3'
services:
  consul:
    image: your-image-name
    ports:
      - "8500:8500"   # HTTP API
      - "8600:8600/udp" # DNS
      - "8300:8300"   # 服务器RPC
      - "8301:8301/udp" # Serf LAN
      - "8302:8302/udp" # Serf WAN
    volumes:
      - ./consul-data:/consul/data
    command: agent -server -bootstrap-expect=1 -client=0.0.0.0 -ui
    restart: always

说明：

• -ui：启用内置Web UI（访问 http://localhost:8500 查看）
• 映射了Consul所有必要端口，支持完整功能（服务器模式）

注意事项

• 生产环境中建议部署3个或以上服务器节点以确保高可用性
• 持久化数据目录需确保权限正确（容器内Consul进程默认使用UID/GID 1000）
• 如需跨主机集群，需配置正确的网络（如Docker Swarm overlay网络或主机网络）