jbonachera/consul

Consul Alpine Docker镜像文档

镜像概述

本镜像为基于Alpine Linux的Consul容器化实现。Consul是HashiCorp开发的分布式服务网格解决方案，提供服务发现、配置管理和服务分段等核心功能。Alpine基础确保镜像体积轻量，适合快速部署和资源受限环境。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• Swarm模式支持：通过SERVICE_NAME环境变量实现Docker Swarm集群集成
• 完整Consul功能：包含服务发现、健康检查、KV存储、多数据中心支持等原生特性
• 易于配置：支持通过环境变量和配置文件自定义Consul节点行为

使用场景

• Docker Swarm集群中的服务自动发现与注册
• 微服务架构中的分布式配置管理
• 跨节点服务健康监控与故障检测
• 分布式系统中的服务协调与负载均衡

使用方法

基本运行

通过以下命令启动Consul容器：

bash
docker run -d --name consul -e SERVICE_NAME=my-consul-service consul-alpine

Swarm模式部署

在Docker Swarm集群中部署时，需指定SERVICE_NAME环境变量以启用Swarm集成：

bash
docker service create \
  --name consul-service \
  -e SERVICE_NAME=consul-cluster \
  --replicas 3 \
  consul-alpine

环境变量说明

持久化数据

如需持久化Consul数据，可挂载数据卷：

bash
docker run -d \
  --name consul \
  -e SERVICE_NAME=my-consul \
  -v consul-data:/consul/data \
  consul-alpine

集群配置

创建Consul集群时，需指定初始节点：

bash
# 启动第一个服务器节点
docker run -d \
  --name consul-server-1 \
  -e SERVICE_NAME=consul-cluster \
  consul-alpine agent -server -bootstrap-expect=3 -node=server-1

# 加入其他节点（需替换IP地址）
docker run -d \
  --name consul-server-2 \
  -e SERVICE_NAME=consul-cluster \
  consul-alpine agent -server -join=<server-1-ip> -node=server-2