wonderlic/elb-presence

wonderlic/elb-presence

链接

• GitHub: https://github.com/wonderlic/docker-elb-presence
• Docker Hub: https://registry.hub.docker.com/u/wonderlic/elb-presence/

镜像概述

该Docker镜像用于实现Amazon EC2实例与Amazon Elastic Load ***（ELB）的自动注册与注销。它会在启动时将实例注册到指定ELB，并在收到SIGINT或SIGTERM信号时（如容器停止）自动从ELB注销实例，确保负载均衡服务的稳定性。

核心功能

1. 自动注册EC2实例到指定ELB
2. 接收终止信号时自动注销实例
3. 支持自动从EC2元数据服务获取实例ID（若未手动指定）

使用场景

• EC2实例启动时自动加入ELB集群，提供服务能力
• 实例停止前自动从ELB移除，避免流量分发到不可用实例
• 云服务自动化部署流程中，简化负载均衡实例管理

配置说明

需通过环境变量传递以下参数：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥
• AWS_DEFAULT_REGION: AWS区域（如us-east-1）
• ELB_NAME: 目标ELB名称
• INSTANCE_ID（可选）: EC2实例ID，未提供时将自动从元数据服务获取

部署示例

Docker Run命令

bash
docker run \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_DEFAULT_REGION=your_region \
  -e ELB_NAME=your_elb_name \
  -e INSTANCE_ID=your_instance_id \
  docker.xuanyuan.run/wonderlic/elb-presence

示例IAM政策

为确保镜像正常工作，需为EC2实例或IAM用户配置以下政策（替换[REGION]、[ACCOUNT]、[ELB_NAME]为实际值）：

json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "elasticloadbalancing:DescribeLoad***s",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "elasticloadbalancing:DeregisterInstancesFromLoad***",
        "elasticloadbalancing:RegisterInstancesWithLoad***"
      ],
      "Resource": "arn:aws:elasticloadbalancing:[REGION]:[ACCOUNT]:load***/[ELB_NAME]"
    }
  ]
}