openeuler/coredns repository overview

⁠Quick reference

• The official CoreDNS docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠CoreDNS | openEuler

Current coredns images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

CoreDNS is a DNS server. It is written in Go. It can be used in a multitude of environments because of its flexibility. CoreDNS is licensed under the Apache License Version 2, and completely open source.

Read more on CoreDNS Website⁠.

⁠Supported tags and respective dockerfile links

The tag of each coredns docker image is consist of the version of coredns and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/coredns image from docker

  docker pull openeuler/coredns:{Tag}
  

  Copy

• Run with an interactive shell

  You can also start the container with an interactive shell to use coredns.

  docker run -it --rm openeuler/coredns:{Tag} bash
  

  Copy

• Create a Corefile

  In your current working directory, create a simple Corefile:

  # Corefile
  .:53 {
      forward . 8.8.8.8
      log
  }
  

  Copy

  What this means:

  • .:53: Listen for all DNS queries on port 53.
  • forward . 8.8.8.8: Forward all DNS queries to Google Public DNS. You can replace 8.8.8.8 with your loca DNS server if needed.
  • log: Log each DNS request for debugging.

• Start CoreDNS (Run as a local binary)

  If you have the coredns binary, start it with:

  ./coredns -conf Corefile
  

  Copy

  After starting, CoreDNS will listen on 0.0.0.0:53 and forward incoming DNS queries according to your configuration.

• Test DNS Resolution

  Use dig on your container to test if CoreDNS is working:

  # You should install bind-utils first in order to use the dig command.
  dnf install -y bind-utils
  dig @127.0.0.1 www.example.com
  

  Copy

  You should see a DNS response in your terminal, and CoreDNS should log the request in its output.

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.