kumori/coredns

镜像概述

Kumori PaaS CoreDNS镜像是专为Kumori平台即服务（PaaS）环境设计的DNS服务器镜像，基于CoreDNS构建并针对Kumori生态系统优化。该镜像提供轻量级、可扩展的DNS解析与服务发现能力，支持动态配置管理，适用于Kumori PaaS环境下的微服务架构与容器化应用部署。

核心功能与特性

• 基础DNS服务：支持UDP/TCP协议的标准DNS解析，兼容A、AAAA、CNAME、MX等常见DNS记录类型。
• Kumori服务发现集成：深度适配Kumori PaaS平台，可自动发现平台内运行的微服务实例，动态更新DNS记录，简化服务间通信配置。
• 轻量级设计：基于精简基础镜像构建，降低资源占用（内存<50MB，CPU占用率低），适合容器化环境部署。
• 插件扩展机制：兼容CoreDNS插件生态，可通过配置启用缓存（cache）、健康检查（health）、指标监控（prometheus）等功能模块。
• 动态配置支持：支持通过Kumori PaaS配置系统实现DNS规则热更新，无需重启服务即可应用配置变更。

使用场景与适用范围

• Kumori微服务架构：为平台内多微服务提供统一域名解析，解决跨服务通信的地址管理问题。
• 容器化应用服务发现：自动识别Kumori环境中部署的容器实例，实现服务地址动态映射，避免硬编码IP依赖。
• 内部网络DNS管理：构建Kumori平台私有DNS系统，隔离外部网络与内部服务域名空间，提升安全性。

使用方法与配置说明

基本部署命令（docker run）

bash
docker run -d --name kumori-coredns \
  -p 53:53/udp -p 53:53/tcp \
  -v /path/to/kumori-coredns-config:/etc/coredns \
  kumori/coredns:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  coredns:
    image: kumori/coredns:latest
    ports:
      - "53:53/udp"
      - "53:53/tcp"
    volumes:
      - ./coredns-config:/etc/coredns  # 挂载本地配置目录
    environment:
      - KUMORI_API_ENDPOINT=http://kumori-platform-api:8080  # Kumori平台API地址
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 10s
      timeout: 5s
      retries: 3

核心配置说明

配置文件路径

镜像通过/etc/coredns/Corefile文件加载DNS配置，典型Kumori环境配置示例：

.:53 {
    errors         # 输出错误日志至标准输出
    health         # 启用健康检查（默认监听:8080/health）
    ready          # 启用就绪探针（默认监听:8181/ready）
    kumori         # Kumori服务发现插件（自动同步平台服务实例）
    cache 30       # 缓存DNS响应30秒
    reload 10s     # 每10秒检查配置变更，支持热重载
    prometheus     # 暴露Prometheus指标（默认监听:9153/metrics）
}

环境变量参数

健康检查与监控

• 健康状态检查：访问容器内http://localhost:8080/health端点，返回OK表示服务正常运行。
• 指标监控：启用prometheus插件后，可通过http://<容器IP>:9153/metrics获取DNS查询量、缓存命中率等监控指标。

部署注意事项

• 需确保容器网络可访问Kumori PaaS平台API服务，否则服务发现功能无法正常同步实例数据。
• 生产环境建议通过持久化卷挂载/etc/coredns目录，避免配置丢失。
• 高并发场景下可调整cache插件缓存时长（如延长至60s）以提升性能。