discobean/route53-sidecar Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

route53-sidecar 镜像文档

镜像概述

route53-sidecar是一个Docker辅助容器镜像，旨在简化AWS Route53 DNS记录的动态管理。该镜像作为sidecar容器运行，能够在主应用容器启动时自动添加指定的Route53 DNS记录，并在容器收到SIGHUP信号关闭时自动移除该记录，确保DNS记录与容器生命周期同步。

核心功能和特性

• 自动记录管理：容器启动时创建Route53 DNS记录，收到SIGHUP信号时删除记录
• AWS集成：原生支持AWS Route53服务，通过环境变量配置AWS凭证
• 灵活配置：支持自定义DNS记录类型、TTL、记录值等参数
• 轻量级设计：作为sidecar容器，资源占用低，易于与主应用集成

使用场景和适用范围

• 动态扩展的容器化应用，需要自动注册/注销DNS记录
• 基于AWS ECS、EKS等容器服务的微服务架构
• 需要临时DNS解析的测试/开发环境
• 高可用性部署中，确保服务启停时DNS记录自动更新

使用方法和配置说明

环境变量配置

Docker Run 示例

bash
docker run -d \
  --name route53-sidecar \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  -e HOSTED_ZONE_ID="ZXXXXXXXXXXXXX" \
  -e RECORD_NAME="service.example.com" \
  -e RECORD_TYPE="A" \
  -e RECORD_VALUE="10.0.0.1" \
  -e TTL="60" \
  discobean/route53-sidecar

Docker Compose 示例

yaml
version: '3'
services:
  main-app:
    image: your-main-app-image
    # 主应用配置...
    
  route53-sidecar:
    image: discobean/route53-sidecar
    environment:
      - AWS_ACCESS_KEY_ID=your-aws-access-key
      - AWS_SECRET_ACCESS_KEY=your-aws-secret-key
      - AWS_REGION=us-east-1
      - HOSTED_ZONE_ID=ZXXXXXXXXXXXXX
      - RECORD_NAME=service.example.com
      - RECORD_TYPE=A
      - RECORD_VALUE=10.0.0.1
      - TTL=60
    depends_on:
      - main-app

关闭行为

当容器收到SIGHUP信号时（例如通过docker stop命令），sidecar会自动删除之前创建的Route53 DNS记录。确保主应用容器停止时，sidecar容器也能正常接收SIGHUP信号以触发清理操作。

注意事项

• 确保提供的AWS凭证具有Route53记录创建和删除的权限（建议最小权限原则）
• RECORD_VALUE应根据记录类型正确设置（A记录为IP地址，CNAME为域名等）
• 在生产环境中，建议通过AWS IAM角色而非访问密钥进行身份验证（适用于ECS/EKS环境）
• TTL设置过短可能增加Route53 API调用频率，过长可能导致DNS记录更新延迟