songsterr/area53

Kubernetes到Route53映射服务

镜像概述

该镜像提供一个Kubernetes服务，用于将集群中配置特定标签和注解的服务同步到AWS Route53域名系统，实现DNS记录的自动管理，减少手动操作成本。

核心功能

• 监听Kubernetes集群中带有dns=route53标签的服务
• 根据服务注解domainName在Route53中创建/修改CNAME记录
• 支持自定义DNS记录的TTL值
• 自动获取Kubernetes API访问凭证，无需手动配置

使用场景

• AWS环境下Kubernetes集群的服务域名自动解析需求
• 需要通过Kubernetes服务配置同步DNS记录的场景
• 减少手动维护Route53记录的运维工作

配置说明

环境变量

运行服务需设置以下环境变量：

• HOSTED_ZONE_ID：Route53托管区域ID（必填）
• AWS_REGION：托管区域所在AWS区域（必填）
• ROUTE53_TTL：DNS记录TTL值，默认60秒（可选）
• KUBERNETES_SERVICE_HOST：Kubernetes API地址，默认由环境自动提供（可选）
• KUBERNETES_PORT_443_TCP_PORT：Kubernetes API端口，默认443（可选）
• TOKEN_PATH：服务账户令牌路径，默认/var/run/secrets/kubernetes.io/serviceaccount/token（可选）

IAM权限要求

运行节点需具备以下IAM权限：

json
{
    "Effect": "Allow",
    "Action": "route53:ListHostedZonesByName",
    "Resource": "*"
},
{
    "Effect": "Allow",
    "Action": [
      "route53:ChangeResourceRecordSets",
      "route53:GetHostedZone"
    ],
    "Resource": "*"
}

部署示例

Kubernetes服务配置

yaml
apiVersion: v1
kind: Service
metadata:
  name: my-app
  labels:
    app: my-app
    role: web
    dns: route53
  annotations:
    domainName: "test-app"
spec:
  selector:
    app: my-app
    role: web
  ports:
  - name: web
    port: 80
    protocol: TCP
    targetPort: web
  - name: web-ssl
    port: 443
    protocol: TCP
    targetPort: web-ssl
  type: LoadBalancer

该配置会自动在Route53生成test-app.myhostedzonedomain.com的CNAME记录，指向负载均衡器。

Docker运行命令

bash
docker run -d \
  --name area53 \
  -e HOSTED_ZONE_ID=EXAMPLEID \
  -e AWS_REGION=ap-southeast-2 \
  -v /var/run/secrets/kubernetes.io/serviceaccount/token:/var/run/secrets/kubernetes.io/serviceaccount/token \
  songsterr/area53