shakefu/etcd-aws-asg

etcd-aws-asg镜像说明

镜像概述

本镜像旨在简化AWS自动扩展组（ASG）环境下etcd集群的部署流程，实现集群节点的自动发现与自引导，帮助用户快速搭建高可用的etcd服务，适配云环境的弹性伸缩场景。

核心功能

1. 自动集群引导：检测AWS ASG内的节点信息，自动完成etcd集群的初始化与节点加入；
2. AWS环境适配：支持读取AWS ASG、EC2实例的元数据，适配云环境的网络配置；
3. 弹性伸缩支持：随ASG节点的增减自动调整etcd集群成员，维持集群可用性。

使用场景

1. 在AWS云环境中部署高可用etcd集群的场景；
2. 需要基于ASG实现etcd集群弹性伸缩的运维需求；
3. 自动化管理etcd集群生命周期（初始化、扩展、缩容）的场景。

配置说明

需配置以下关键环境变量：

• AWS_REGION：AWS区域（如cn-north-1）；
• ASG_NAME：目标自动扩展组名称；
• ETCD_CLUSTER_NAME：etcd集群名称（可选，默认值为"etcd-cluster"）；
• 需赋予容器对应的IAM权限（如autoscaling:DescribeAutoScalingGroups、ec2:DescribeInstances）以读取ASG信息。

部署示例

Docker Run命令

bash
docker run \
  -e AWS_REGION=cn-north-1 \
  -e ASG_NAME=my-etcd-asg \
  -p 2379:2379 \
  -p 2380:2380 \
  shakefu/etcd-aws-asg

Docker Compose示例

yaml
version: "3"
services:
  etcd-asg:
    image: shakefu/etcd-aws-asg
    environment:
      - AWS_REGION=cn-north-1
      - ASG_NAME=my-etcd-asg
    ports:
      - "2379:2379"
      - "2380:2380"
    restart: always