ipvfletch/docker-route53-autodns

Docker Route53 AutoDNS镜像

镜像概述

本镜像实现将Docker容器的主机名（通过环境变量Hostname指定）自动注册到AWS Route53 DNS服务，利用EC2实例元数据获取本地IPv4地址作为记录值，简化容器化应用的DNS管理流程。

核心功能

1. 读取EC2实例元数据获取本地IP地址
2. 将容器主机名与指定域名拼接生成完整DNS记录（格式：容器主机名.域名后缀）
3. 通过AWS API向Route53提交A记录注册请求

使用场景

• EC2环境下容器化应用的自动DNS解析管理
• 配合docker-gen工具实现容器生命周期与DNS记录的同步更新

配置说明

需设置以下三个环境变量：

部署示例

基础运行命令

bash
docker run \
  -e DOMAINNAME=yourdomain.com \
  -e AWS_ACCESS_KEY=AKIAEXAMPLE \
  -e AWS_SECRET_KEY=secretExample \
  ipvfletch/docker-route53-autodns \
  python route53-autodns.py my-container

配合docker-gen使用

1. 创建route53.tmpl模板文件（示例）：

bash
{{range $container := .Containers}}
{{if $container.Env.HOSTNAME}}
python route53-autodns.py {{$container.Env.HOSTNAME}}
{{end}}
{{end}}

2. 启动docker-gen监控容器变化：

bash
docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd)/route53.tmpl:/tmpl/route53.tmpl \
  -v $(pwd)/scripts:/scripts \
  jwilder/docker-gen \
  -watch -notify "/bin/bash /scripts/route53.sh" /tmpl/route53.tmpl /scripts/route53.sh

注意事项

• 仅处理设置了HOSTNAME环境变量的容器
• 推荐使用EC2 IAM角色替代硬编码密钥，提升安全性
• 确保AWS账号具有Route53的ChangeResourceRecordSets权限
• 容器需能访问EC2元数据服务（默认允许）及AWS Route53 API
• 域名需已在Route53中创建托管区域
• 记录类型固定为A记录，TTL默认使用Route53托管区域设置

本镜像适用于需要自动化管理容器DNS解析的AWS EC2环境，帮助开发者快速实现容器与DNS的联动更新。 ===END===