mirantis/external-dns

Kubernetes External-dns镜像（支持Designate和CoreDNS）

镜像概述

本镜像提供Kubernetes环境下的External-dns组件，专注于实现Kubernetes资源（如Service、Ingress）与外部DNS记录的自动同步。特别支持OpenStack Designate DNS服务和CoreDNS服务器，帮助用户简化DNS管理流程，实现动态DNS记录更新。

核心功能与特性

• 多DNS支持：原生支持OpenStack Designate DNS服务和CoreDNS服务器
• 自动同步：监听Kubernetes资源变化，自动创建、更新或删除对应DNS记录
• 灵活配置：支持通过环境变量和命令行参数自定义同步策略
• 资源类型支持：兼容Service（NodePort/Load***类型）和Ingress资源
• 安全集成：支持与Kubernetes RBAC、Designate认证机制集成

使用场景与适用范围

• Kubernetes集群需要动态管理外部DNS记录时
• 基于OpenStack云平台部署的Kubernetes集群
• 使用CoreDNS作为集群内部DNS服务器，需实现内外网DNS联动的场景
• 微服务架构中，需要通过域名动态访问Kubernetes服务的场景

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name external-dns \
  -v /path/to/kubeconfig:/kubeconfig \
  -e KUBECONFIG=/kubeconfig \
  -e EXTERNAL_DNS_PROVIDER=designate \
  -e DESIGNATE_AUTH_URL=https://openstack-auth-url:5000/v3 \
  -e DESIGNATE_USERNAME=your-username \
  -e DESIGNATE_PASSWORD=your-password \
  -e DESIGNATE_PROJECT_ID=your-project-id \
  -e EXTERNAL_DNS_SOURCE=service,ingress \
  -e EXTERNAL_DNS_COREDNS_PATCH=true \
  your-registry/external-dns:latest \
  --domain-filter=example.com \
  --log-level=info

Docker Compose配置

yaml
version: '3'
services:
  external-dns:
    image: your-registry/external-dns:latest
    volumes:
      - /path/to/kubeconfig:/kubeconfig
    environment:
      - KUBECONFIG=/kubeconfig
      - EXTERNAL_DNS_PROVIDER=designate
      - DESIGNATE_AUTH_URL=https://openstack-auth-url:5000/v3
      - DESIGNATE_USERNAME=your-username
      - DESIGNATE_PASSWORD=your-password
      - DESIGNATE_PROJECT_ID=your-project-id
      - EXTERNAL_DNS_SOURCE=service,ingress
      - EXTERNAL_DNS_COREDNS_PATCH=true
    command:
      - --domain-filter=example.com
      - --log-level=info
    restart: always

关键配置参数

环境变量

命令行参数

Kubernetes部署注意事项

1. 建议通过Deployment资源在Kubernetes集群内部署，而非直接使用Docker
2. 需为External-dns创建具有足够权限的RBAC角色（读取Service/Ingress，更新ConfigMap等）
3. 当使用CoreDNS时，需确保CoreDNS配置支持动态更新（通常通过ConfigMap实现）
4. Designate认证建议使用OpenStack应用凭证（Application Credential）提高安全性

常见问题

• Q: 如何验证DNS记录是否同步成功？
  A: 查看容器日志（docker logs external-dns）或Designate管理界面，确认记录创建/更新日志

• Q: 支持哪些Kubernetes资源注解？
  A: 支持external-dns.alpha.kubernetes.io/hostname（指定域名）、external-dns.alpha.kubernetes.io/ttl（设置TTL）等标准注解

• Q: CoreDNS集成需要哪些额外配置？
  A: 需确保CoreDNS配置中包含kubernetes插件，并允许External-dns更新CoreDNS的ConfigMap