使用ExternalDNS在RcodeZero上实现Kubernetes服务自动DNS管理

使用ExternalDNS在RcodeZero上实现Kubernetes服务自动DNS管理

external-dns 项目地址: https://gitcode.com/gh_mirrors/ext/external-dns

前言

在现代云原生架构中，服务发现和DNS管理是至关重要的组件。ExternalDNS作为Kubernetes生态系统中的重要工具，能够自动管理外部DNS记录，使服务能够通过友好的域名被访问。本文将详细介绍如何在RcodeZero DNS平台上配置和使用ExternalDNS，实现Kubernetes服务的自动DNS记录管理。

准备工作

在开始配置之前，需要确保以下条件已满足：

1. 已拥有RcodeZero DNS账户
2. 已准备好Kubernetes集群环境
3. 使用的ExternalDNS版本不低于0.5.0

RcodeZero DNS区域配置

创建主区域

1. 登录RcodeZero控制面板
2. 导航至添加区域页面
3. 选择"MASTER"作为区域类型
4. 输入您的域名（如example.com）

重要说明：必须选择"MASTER"类型区域，因为"SECONDARY"类型区域不允许修改记录，无法与ExternalDNS配合使用。

API密钥配置

启用API访问

1. 在RcodeZero控制面板中启用API功能
2. 生成API密钥
3. 记录下生成的API密钥，后续部署ExternalDNS时需要用到

ExternalDNS部署

根据您的Kubernetes集群是否启用了RBAC，选择相应的部署方式。

非RBAC集群部署

apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-dns
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: external-dns
  template:
    metadata:
      labels:
        app: external-dns
    spec:
      containers:
      - name: external-dns
        image: registry.k8s.io/external-dns/external-dns:v0.14.0
        args:
        - --source=service
        - --domain-filter=example.com
        - --provider=rcodezero
        - --rc0-enc-txt
        env:
        - name: RC0_API_KEY
          value: "YOUR_RCODEZERO_API_KEY"
        - name: RC0_ENC_VAR
          value: "YOUR_ENCRYPTION_KEY_STRING"

RBAC集群部署

apiVersion: v1
kind: ServiceAccount
metadata:
  name: external-dns
---
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"]
- apiGroups: [""]
  resources: ["nodes"]
  verbs: ["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: default
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-dns
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: external-dns
  template:
    metadata:
      labels:
        app: external-dns
    spec:
      serviceAccountName: external-dns
      containers:
      - name: external-dns
        image: registry.k8s.io/external-dns/external-dns:v0.14.0
        args:
        - --source=service
        - --domain-filter=example.com
        - --provider=rcodezero
        - --rc0-enc-txt
        env:
        - name: RC0_API_KEY
          value: "YOUR_RCODEZERO_API_KEY"
        - name: RC0_ENC_VAR
          value: "YOUR_ENCRYPTION_KEY_STRING"

配置说明

1. 将"example.com"替换为您在RcodeZero中添加的实际域名
2. 将"YOUR_RCODEZERO_API_KEY"替换为您生成的API密钥
3. 将"YOUR_ENCRYPTION_KEY_STRING"替换为您选择的加密字符串（用于TXT记录加密）
4. --source参数可根据需求设置为service或ingress
5. --rc0-enc-txt参数可选，用于启用TXT记录加密

测试服务部署

为了验证配置是否成功，可以部署一个简单的Nginx服务进行测试。

测试服务配置

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx
        name: nginx
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: nginx
  annotations:
    external-dns.alpha.kubernetes.io/hostname: example.com
    external-dns.alpha.kubernetes.io/ttl: "120"
spec:
  selector:
    app: nginx
  type: LoadBalancer
  ports:
    - protocol: TCP
      port: 80
      targetPort: 80

关键配置点

1. external-dns.alpha.kubernetes.io/hostname注解指定了要注册的域名
2. external-dns.alpha.kubernetes.io/ttl注解设置了DNS记录的TTL值（可选，默认为300）
3. 服务类型必须为LoadBalancer才能获取外部IP

部署测试服务

kubectl apply -f nginx.yaml

验证DNS记录

1. 等待服务获取外部IP地址
2. 登录RcodeZero控制面板
3. 检查对应DNS区域是否已自动创建A记录
4. 验证记录的IP地址是否与服务的外部IP匹配

工作原理解析

ExternalDNS通过以下流程工作：

1. 监控Kubernetes API，发现带有特定注解的服务或Ingress资源
2. 获取这些资源的外部IP地址
3. 通过RcodeZero API创建或更新对应的DNS记录
4. 定期同步确保DNS记录与实际状态一致

最佳实践建议

1. 域名规划：建议为不同环境使用不同的子域（如dev.example.com、prod.example.com）
2. TTL设置：生产环境建议使用较长的TTL（300秒或更长）
3. 权限控制：为ExternalDNS使用最小必要权限原则
4. 监控配置：监控ExternalDNS的日志和运行状态
5. 加密安全：建议启用TXT记录加密功能

清理资源

完成测试后，可通过以下命令清理资源：

kubectl delete -f nginx.yaml
kubectl delete -f externaldns.yaml

常见问题排查

1. DNS记录未创建：

   • 检查ExternalDNS日志
   • 验证API密钥是否正确
   • 确认服务注解是否正确设置

2. 记录更新延迟：

   • 检查ExternalDNS同步间隔
   • 确认RcodeZero API响应时间

3. 权限问题：

   • 检查RBAC配置（如适用）
   • 验证服务账户权限

通过本文的详细指导，您应该能够在RcodeZero DNS平台上成功配置ExternalDNS，实现Kubernetes服务的自动DNS管理。这种集成大大简化了云原生环境中的服务发现流程，提高了运维效率。

external-dns 项目地址: https://gitcode.com/gh_mirrors/ext/external-dns