ContainerDNS 项目使用教程

1. 项目目录结构及介绍

ContainerDNS 是一个为 Kubernetes 集群设计的快速 DNS 服务。项目目录结构如下：

containerdns/
├── backends/
│   ├── etcd-cached/
│   └── ...
├── cmd/
│   ├── containerdns-apicmd/
│   ├── containerdns-kubeapi/
│   └── ...
├── dns-scanner/
├── dns-schedule/
├── dns-server/
├── etc/
├── images/
├── kdns/
├── licenses/
├── queue/
├── utils/
├── .gitignore
├── README.md
├── LICENSE
└── ...

主要目录介绍：

• backends/: 包含与后端存储（如 etcd）相关的代码。
• cmd/: 包含项目的启动命令和相关的命令行工具。
• dns-scanner/: 包含用于监控 DNS 记录状态的代码。
• dns-schedule/: 包含用于定时任务处理的代码。
• dns-server/: 包含 DNS 服务器的主代码。
• etc/: 包含配置文件的示例。
• images/: 包含项目使用的 Docker 镜像。
• licenses/: 包含项目的许可证文件。
• utils/: 包含项目的工具库代码。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/ 目录下，主要包含以下几个文件：

• containerdns-apicmd/main.go: 用于启动 containerdns API 命令行工具。
• containerdns-kubeapi/main.go: 用于启动 containerdns Kubernetes API 监控服务。

启动 containerdns 的示例命令：

./containerdns-kubeapi

3. 项目的配置文件介绍

项目的配置文件通常位于 etc/ 目录下，以下是两个主要的配置文件：

• containerdns.conf: DNS 服务的配置文件。
• containerdns-kubeapi.conf: Kubernetes API 监控服务的配置文件。

containerdns.conf 配置文件示例：

[Dns]
dns-domains = example.com
dns-addr = 0.0.0.0:53
ex-nameservers = 8.8.8.8:53
inDomainServers = example.local@10.0.0.2:53
cacheSize = 1000000

[Log]
log-dir = /var/log/containerdns
log-level = 2
log-to-stdio = true

[Etcd]
etcd-servers = http://127.0.0.1:2379
etcd-certfile = ""
etcd-keyfile = ""
etcd-cafile = ""

containerdns-kubeapi.conf 配置文件示例：

[General]
domain = example.com
host = 192.168.1.1
etcd-server = http://127.0.0.1:2379

[Kube2DNS]
kube-enable = YES
kube-config-file = /etc/containerdns/kubeconfig

[DNSApi]
api-enable = YES
api-domains = example.com
api-address = 0.0.0.0:9003
containerdns-auth = abcdef123456789

以上配置文件需要根据实际情况进行修改，以满足特定的部署需求。