jangrewe/ecs-route53

docker-ecs-route53

镜像概述

本Docker容器可帮助ECS实例将自身IP地址注册到指定的AWS Route53域名记录中，支持动态更新Round-Robin A记录，适用于服务发现或集群实例的DNS管理场景。

核心功能

• 自动添加/移除ECS实例IP到Route53的A记录
• 无现有记录时创建新的Round-Robin A记录
• 存在记录时更新（保留原有地址+新增地址）或删除（移除指定地址）
• 当移除的IP是记录中唯一地址时，自动删除该记录

使用场景

• ECS集群实例启动时自动注册DNS，方便服务发现
• 实例重启/关闭时自动从DNS记录中移除IP
• 动态维护集群实例的Round-Robin DNS列表

配置说明

必要IAM权限

建议为ECS实例绑定IAM角色，并授予以下权限：

• route53:ListHostedZones
• route53:ListResourceRecordSets
• route53:ChangeResourceRecordSets

CoreOS Systemd单元示例

用于实例启动/关闭时自动执行注册/移除操作（需替换$domain和$cluster变量）：

- name: route53-register.service
  command: start
  content: |
    [Unit]
    Description=route53-register
    After=docker.service
    Requires=docker.service
    
    [Service]
    Type=oneshot
    RemainAfterExit=yes
    ExecStartPre=-/usr/bin/docker rm route53-register
    ExecStartPre=/usr/bin/docker pull docker.xuanyuan.run/jangrewe/ecs-route53
    ExecStart=/bin/sh -c "/usr/bin/docker run --name route53-register jangrewe/ecs-route53:latest --action add --domain $domain --record $cluster --ip $public_ipv4"
    ExecStop=/bin/sh -c "/usr/bin/docker run --name route53-register jangrewe/ecs-route53:latest --action remove --domain $domain --record $cluster --ip $public_ipv4"

Docker运行示例

添加IP到DNS记录：

bash
docker run docker.xuanyuan.run/jangrewe/ecs-route53:latest --action add --domain example.com --record cluster --ip 192.168.1.100

移除IP从DNS记录：

bash
docker run docker.xuanyuan.run/jangrewe/ecs-route53:latest --action remove --domain example.com --record cluster --ip 192.168.1.100