lfkeitel/etcd

Docker Etcd镜像

镜像概述

本镜像基于Alpine Linux 3.5构建，用于快速部署Etcd集群。数据目录-data-dir挂载到/data作为卷，默认暴露Etcd的2379（客户端通信）和2380（节点间通信）端口，不包含旧的弃用端口。

核心功能

• 支持单节点部署和Docker Swarm集群部署
• 环境变量可配置，CLI参数优先级高于环境变量
• Swarm模式下自动生成初始集群配置
• 支持动态扩展Swarm服务（需遵循扩缩容规则）

环境变量配置

以下环境变量可在运行时覆盖，CLI参数会覆盖同名环境变量：

• SERVICE_NAME：Swarm集群中的服务名称，未指定则自动检测
• CLUSTER_SIZE：初始集群大小，默认值为1
• ETCD_NAME：节点名称，Swarm服务中自动唯一，单容器默认值为etcd
• ETCD_LISTEN_CLIENT_URLS：客户端监听地址，默认http://0.0.0.0:2379
• ETCD_ADVERTISE_CLIENT_URLS：客户端公告地址，默认http://$IP_OF_CONTAINER:2379（单容器需手动指定）
• ETCD_LISTEN_PEER_URLS：节点间监听地址，默认http://0.0.0.0:2380（集群模式使用）
• ETCD_INITIAL_ADVERTISE_PEER_URLS：节点间初始公告地址，默认http://$IP_OF_CONTAINER:2379（集群模式使用）
• ETCD_INITIAL_CLUSTER：初始集群配置，Swarm模式下自动通过DNS生成（集群模式使用）

使用场景与部署示例

单节点部署

sh
docker run \
  -d \
  -p 2379:2379 \
  -e 'ETCD_ADVERTISE_CLIENT_URLS=http://192.168.1.99:2379' \
  --name some-etcd \
  lfkeitel/etcd:latest

Docker Swarm集群部署

部署集群时必须指定CLUSTER_SIZE环境变量，确保容器正确集群：

sh
docker service create \
  --name etcd \
  -e 'CLUSTER_SIZE=3' \
  -e 'ETCD_ADVERTISE_CLIENT_URLS=http://192.168.56.101:2379,http://192.168.56.102:2379' \
  --replicas=3 \
  --publish 2379:2379 \
  --network=etcd \
  lfkeitel/etcd:latest

Swarm服务扩缩容

本镜像支持动态添加Swarm服务节点，容器会通过etcdctl将自身加入集群后启动Etcd。
注意：只能逐个扩展服务，若同时扩展多个节点，可能导致集群无法正确加入。如需修复，可能需要缩容并重启问题节点（该问题正在优化中）。