nacos-coredns-plugin

README

nacos-coredns-plugin 中文

This project provides a DNS-F client based on CoreDNS, which can help export those registed services on Nacos as DNS domain. DNS-F client is a dedicated agent process(side car) beside the application's process to foward the service discovery DNS domain query request to Nacos.

Quic Start

To build and run nacos coredns plugin, the OS must be Linux or Mac. And also, make sure your nacos version is 2.0 or higher and golang version is 1.17 or higher. And golang environments(GOPATH,GOROOT,GOHOME) must be configured correctly. Because it needs to support the gRPC connection feature of the nacos2.x version and the go mod function.

Build

git clone https://github.com/nacos-group/nacos-coredns-plugin.git 
cp nacos-coredns-plugin/bin/build.sh ~/
cd ~/
sh build.sh

Configuration

To run nacos coredns plugin, you need a configuration file. A possible file may be as bellow:

. {
    log
    nacos {
        nacos_namespaceId public
        nacos_server_host 127.0.0.1:8848
   }
   forward . /etc/resolv.conf
 }

• forward: domain names those not registered in nacos will be forwarded to upstream.
• nacos_namespaceId: nacos namespaceId, defalut is public.
• nacos_server_host: Ip and Port of nacos server, seperated by comma if there are two or more nacos servers

Run

• Firstly, you need to deploy nacos server. Here
• Secondly, register service on nacos.
• Then run $GOPATH/src/coredns/coredns -conf $path_to_corefile -dns.port $dns_port

Test

dig $nacos_service_name @127.0.0.1 -p $dns_port