appscode/external-dns

external-dns Docker镜像文档

镜像概述

本镜像基于https://github.com/kubernetes-incubator/external-dns%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BA%86%E5%9C%A8Kubernetes%E7%8E%AF%E5%A2%83%E4%B8%AD%E8%87%AA%E5%8A%A8%E7%AE%A1%E7%90%86%E5%A4%96%E9%83%A8DNS%E8%AE%B0%E5%BD%95%E7%9A%84%E5%8A%9F%E8%83%BD%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E6%88%B7%E5%8F%AF%E4%BB%A5%E5%B0%86Kubernetes%E9%9B%86%E7%BE%A4%E5%86%85%E7%9A%84Service%E3%80%81Ingress%E7%AD%89%E8%B5%84%E6%BA%90%E4%B8%8E%E5%A4%96%E9%83%A8DNS%E6%9C%8D%E5%8A%A1%E5%90%8C%E6%AD%A5%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%9F%9F%E5%90%8D%E8%A7%A3%E6%9E%90%E7%9A%84%E5%8A%A8%E6%80%81%E9%85%8D%E7%BD%AE%E4%B8%8E%E7%BB%B4%E6%8A%A4%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E6%93%8D%E4%BD%9CDNS%E8%AE%B0%E5%BD%95%E3%80%82

核心功能与特性

• 自动DNS同步：监控Kubernetes集群中的Service、Ingress资源变化，自动创建、更新或删除对应的外部DNS记录
• 多DNS提供商支持：兼容主流DNS服务提供商，包括AWS Route53、Google Cloud DNS、Azure DNS、Cloudflare等
• 灵活配置：支持通过命令行参数或配置文件自定义同步规则、DNS记录TTL、域名过滤等
• 安全性：可集成Kubernetes RBAC权限控制，确保仅授权用户或组件可操作DNS记录

使用场景

• Kubernetes集群对外服务：当需要将集群内的Service或Ingress暴露到公网时，自动维护对应的DNS记录
• 动态服务发现：服务扩容、缩容或IP变化时，自动更新DNS记录，保证服务访问的连续性
• 多环境管理：在开发、测试、生产等多环境中，通过统一配置实现DNS记录的差异化管理

使用方法

镜像构建

使用以下命令构建并推送镜像：

bash
make build.push IMAGE=appscode/external-dns

部署示例（Kubernetes Deployment）

以下是在Kubernetes集群中部署external-dns的基本示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-dns
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: external-dns
  template:
    metadata:
      labels:
        app: external-dns
    spec:
      serviceAccountName: external-dns
      containers:
      - name: external-dns
        image: appscode/external-dns:latest
        args:
        - --source=service
        - --source=ingress
        - --provider=aws
        - --aws-zone-type=public
        - --domain-filter=example.com
        - --txt-owner-id=my-k8s-cluster

配置参数说明

权限配置

部署external-dns需要对应的RBAC权限，以下是ServiceAccount、ClusterRole和ClusterRoleBinding的示例：

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: external-dns
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: external-dns
rules:
- apiGroups: [""]
  resources: ["services","endpoints","pods"]
  verbs: ["get","watch","list"]
- apiGroups: ["extensions","networking.k8s.io"]
  resources: ["ingresses"]
  verbs: ["get","watch","list"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: external-dns-viewer
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: external-dns
subjects:
- kind: ServiceAccount
  name: external-dns
  namespace: kube-system

注意事项

• 不同DNS提供商需要配置对应的认证信息（如AWS需配置IAM权限，Cloudflare需提供API令牌等）
• 建议通过--domain-filter限制同步范围，避免误操作非目标域名
• 生产环境中建议设置--txt-owner-id以确保记录归属唯一性，防止与其他系统冲突