bitnamicharts/external-dns

Bitnami ExternalDNS 镜像文档

镜像概述和主要用途

ExternalDNS 是一个 Kubernetes 插件，用于配置公共 DNS 服务器，将 Kubernetes 服务的暴露信息添加到 DNS 记录中，使这些服务可被外部发现。Bitnami 提供的此镜像将 ExternalDNS 打包为容器化应用，便于在 Kubernetes 集群中部署和使用。

https://github.com/kubernetes-incubator/external-dns

商标声明：本软件列表由 Bitnami 打包。产品中提及的各个商标分别归各自公司所有，使用这些商标并不意味着任何关联或认可。

核心功能和特性

• 自动将 Kubernetes 服务和 Ingress 资源的 DNS 记录同步到公共 DNS 服务提供商
• 支持多种 DNS 服务提供商（AWS Route53、Google Cloud DNS、Cloudflare 等）
• 可配置的 DNS 记录生成模板
• 支持监控特定命名空间或全集群范围的资源
• 与 Prometheus 集成，提供指标监控能力
• 支持 Webhook 方式集成自定义 DNS 提供商
• 安全加固的容器镜像，减小***面

使用场景和适用范围

• 需要从 Kubernetes 集群外部访问内部服务的场景
• 希望通过 DNS 名称而非 IP 地址访问 Kubernetes 服务的场景
• 多环境部署中需要自动管理 DNS 记录的场景
• CI/CD 流程中需要动态创建和销毁 DNS 记录的场景
• 需要集中管理跨多个 DNS 提供商记录的场景

详细的使用方法和配置说明

前提条件

• Kubernetes 1.23+ 集群
• Helm 3.8.0+ 包管理工具

快速开始

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/external-dns

注意：如需在生产环境使用 ExternalDNS，建议尝试 VMware Tanzu Application Catalog，即 Bitnami 目录的商业版本。

安装图表

要安装名为 my-release 的图表：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/external-dns

注意：需要将占位符 REGISTRY_NAME 和 REPOSITORY_NAME 替换为 Helm 图表仓库和存储库的引用。例如，对于 Bitnami，需要使用 REGISTRY_NAME=registry-1.docker.io 和 REPOSITORY_NAME=bitnamicharts。

该命令使用默认配置在 Kubernetes 集群上部署 ExternalDNS。参数 部分列出了可在安装过程中配置的参数。

提示：使用 helm list 命令列出所有发布版本

配置说明

资源请求和限制

Bitnami 图表允许为图表部署中的所有容器设置资源请求和限制，这些配置位于 resources 值中（参见参数表）。设置请求对于生产工作负载至关重要，应根据具体使用情况进行调整。

为简化此过程，图表包含 resourcesPreset 值，可根据不同预设自动设置 resources 部分。可在 https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15 中查看这些预设。但在生产工作负载中，不建议使用 resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅 官方 Kubernetes 文档。

滚动标签与不可变标签

在生产环境中，强烈建议使用不可变标签。这可确保即使相同标签更新为不同镜像时，部署也不会自动更改。

如果主容器有新版本、重大更改或存在严重漏洞，Bitnami 将发布新图表来更新其容器。

Prometheus 指标集成

通过将 metrics.enabled 设置为 true，可将此图表与 Prometheus 集成。这将在服务中公开 external-dns 原生 Prometheus 端点，并添加必要的注解以便 Prometheus 自动抓取指标。

Prometheus 要求

要使集成正常工作，需要安装 Prometheus 或 Prometheus Operator。可安装 https://github.com/bitnami/charts/tree/main/bitnami/prometheus 或 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E4%BB%A5%E4%BE%BF%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E8%BD%BB%E6%9D%BE%E9%83%A8%E7%BD%B2%E5%8F%AF%E7%94%A8%E7%9A%84 Prometheus。

与 Prometheus Operator 集成

该图表可以部署 ServiceMonitor 对象，用于与 Prometheus Operator 集成。为此，需设置值 metrics.serviceMonitor.enabled=true。确保在集群中安装了 Prometheus Operator CustomResourceDefinitions，否则会失败并显示以下错误：

text
no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus 可获取必要的 CRD 和 Prometheus Operator。

设置 Pod 亲和性

此图表允许使用 affinity 参数设置自定义亲和性。有关 Pod 亲和性的更多信息，请参阅 Kubernetes 文档。

作为替代方案，可以使用 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities 图表中提供的预设配置，用于 Pod 亲和性、Pod 反亲和性和节点亲和性。为此，可设置 podAffinityPreset、podAntiAffinityPreset 或 nodeAffinityPreset 参数。

使用 IRSA

如果在 AWS EKS 上部署并希望利用 IRSA，需要将 fsGroup 和 runAsUser 分别覆盖为 65534(nfsnobody) 和 0。否则，服务账户令牌将无法正确挂载。可使用以下参数：

console
--set podSecurityContext.fsGroup=65534 --set podSecurityContext.runAsUser=0

Webhook 提供商

Webhook 提供商允许通过 HTTP 接口将 ExternalDNS 与 DNS 提供商集成。这种方法将 ExternalDNS 与提供商代码解耦，使它们可以在单独的进程中运行。

使用 Bitnami ExternalDNS 图表，可以通过 sidecars 和 extraArgs 值轻松部署 Webhook 提供商并配置 ExternalDNS：

yaml
provider: webhook

extraArgs:
  webhook-provider-url: http://localhost:8080
  txt-prefix: reg-

sidecars:
  - name: my-webhook
    image: <external-dns-webhook-image>
    ports:
      - containerPort: 8080
        name: http
    livenessProbe:
      httpGet:
        path: /
        port: http
      initialDelaySeconds: 10
      timeoutSeconds: 5
    readinessProbe:
      tcpSocket:
        port: http
      initialDelaySeconds: 10
      timeoutSeconds: 5
    env:
      - name: <WEBHOOK-CONFIG-ENV-VAR>
        value: TEST
      ...

有关这些新提供商的更多信息，请参阅 https://github.com/kubernetes-sigs/external-dns/tree/master#new-providers%E3%80%82

部署方案示例

AWS Route53 部署示例

console
helm install my-release \
  --set provider=aws \
  --set aws.zoneType=public \
  --set txtOwnerId=HOSTED_ZONE_IDENTIFIER \
  --set domainFilters[0]=HOSTED_ZONE_NAME \
  oci://registry-1.docker.io/bitnamicharts/external-dns

注意：将占位符 HOSTED_ZONE_IDENTIFIER 和 HOSTED_ZONE_NAME 分别替换为您的托管区域标识符和名称。

docker-compose 配置示例

yaml
version: '3'
services:
  external-dns:
    image: docker.io/bitnami/external-dns:latest
    command:
      - --provider=aws
      - --aws-zone-type=public
      - --txt-owner-id=my-hosted-zone-id
      - --domain-filter=example.com
    environment:
      - AWS_ACCESS_KEY_ID=your-access-key
      - AWS_SECRET_ACCESS_KEY=your-secret-key
      - AWS_REGION=us-east-1

参数说明

全局参数

通用参数

ExternalDNS 参数

⚠️ 重要注意事项：Bitnami 目录即将发生的变化

从 2025 年 8 月 28 日开始，Bitnami 将改进其公共目录，在新的 Bitnami Secure Images 计划 下提供精选的强化、安全聚焦的镜像。作为此过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本。
• Bitnami 将开始在其免费层中弃用对非强化的基于 Debian 的软件镜像的支持，并将逐步从公共目录中删除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以"latest"标签发布，旨在用于开发目的。
• 从 8 月 28 日开始，在两周内，所有现有容器镜像，包括旧版本或版本化标签（例如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到"Bitnami Legacy"仓库（docker.io/bitnamilegacy），在那里它们将不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用 Bitnami Secure Images，其中包括强化容器、更小的***面、CVE 透明度（通过 VEX/KEV）、SBOM 和企业支持。

这些变化旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有 Bitnami 用户的安全态势。有关更多详细信息，请访问 https://github.com/bitnami/containers/issues/83267%E3%80%82

教程和额外资源

有关每个 DNS 提供商的要求信息，请查看以下链接：

• https://github.com/kubernetes-sigs/external-dns/tree/master/docs/tutorials

备份和恢复

要在 Kubernetes 上备份和恢复 Helm 图表部署，需要从源部署备份持久卷，并使用 Velero（Kubernetes 备份/恢复工具）将它们附加到新部署。有关使用 Velero 的说明，请参阅 本指南。