no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== CoreDNS server inside a Docker container ======
+This howto describes how to run CoreDNS in a Docker container. It assumes a running docker setup.
+===== Fetch the container =====
+CoreDNS maintains a docker container at https://hub.docker.com/r/coredns/coredns/.
+<code>
+# docker pull coredns/coredns
+Using default tag: latest
+latest: Pulling from coredns/coredns
+Digest: sha256:1eeb4c7316bacb1d4c8ead65571cd92dd21e27359f0d4917f1a5822a73b75db1
+Status: Image is up to date for coredns/coredns:latest
+docker.io/coredns/coredns:latest
+</code>
+===== Create local configurations =====
+Configurations need to live outside the container and be mounted as a volume. We create a folder in /root/containers/coredns on the host to store these configuration.
+The first configuration file declares a zone with the location of a database file. The second configuration file declares DNS records in a zone file.
+<code>
+# mkdir /root/containers/coredns
+</code>
+<code>
+# cat /root/containers/coredns/Corefile
+necto.org:53 {
+	file /root/necto.org.db # the location of the database file inside the container
+	log
+	errors
+}
+</code>
+The database file uses the standard Bind syntax. See [[https://datatracker.ietf.org/doc/html/rfc1035#section-3.3.13|RFC 1035]] for more info on how to structure zone files.
+Note that the serial *must* store in a 32 bits integer so keep it at 10 digits for simplicity.
+<code>
+# cat /root/containers/coredns/necto.org.db
+necto.org. IN SOA ns1.necto.org. administrator.necto.org. 2024071901 7200 3600 1209600 3600
+legolas.necto.org. IN A 75.67.215.94
+ns1.necto.org. IN CNAME legolas.necto.org.
+</code>
+===== Start the container =====
+The docker run command mounts the folder from the host into the container and sets the configuration flag to point to the Corefile file inside the container. We also forward UDP 53 to answer queries.
+<code>
+# docker run -d --name coredns --restart=always --volume=/root/containers/coredns/:/root/ -p 53:53/udp coredns/coredns -conf /root/Corefile
+</code>
+**docker ps**, **docker logs** and **docker inspect** can be used to evaluate the state of the container.
+<code>
+# docker ps
+CONTAINER ID   IMAGE             COMMAND                  CREATED       STATUS       PORTS                                       NAMES
+c19f5b978   coredns/coredns   "/coredns -conf /roo…"   3 hours ago   Up 3 hours   53/tcp, 0.0.0.0:53->53/udp, :::53->53/udp   coredns
+# docker logs 330c19f5b978
+necto.org.:53
+CoreDNS-1.11.1
+linux/arm64, go1.20.7, ae2bbc2
+[INFO] 172.17.0.1:36321 - 6587 "A IN legolas.necto.org. udp 58 false 1232" NOERROR qr,aa,rd 68 0.000162407s
+[INFO] 199.47.252.56:36063 - 45182 "A IN legolas.necto.org. udp 58 false 4096" NOERROR qr,aa,rd 68 0.000134611s
+# docker inspect 330c19f5b978
+[
+    {
+        "Id": "330c19f5b978e1101a7f500596b2f26227f49794dccf8f7d48dd8016e1fddc62",
+        "Created": "2024-07-19T12:00:22.78761211Z",
+        "Path": "/coredns",
+...
+</code>
+===== Run the container as a systemd service =====
+To run the container as a systemd service, create the following service file under **/etc/systemd/system/docker.coredns.service**
+<file>
+# cat /etc/systemd/system/docker.coredns.service
+[Unit]
+Description=CoreDNS Container
+After=docker.service
+Requires=docker.service
+[Service]
+TimeoutStartSec=0
+Restart=always
+ExecStartPre=-/usr/bin/docker stop %n
+ExecStartPre=-/usr/bin/docker rm %n
+ExecStartPre=/usr/bin/docker pull coredns/coredns
+ExecStart=/usr/bin/docker run --name %n --volume=/root/containers/coredns/:/root/ -p 53:53/udp coredns/coredns -conf /root/Corefile
+[Install]
+WantedBy=multi-user.target
+</file>
+And run it with the following command:
+<code>
+# systemctl start docker.coredns
+# systemctl|grep coredns
+docker.coredns.service                        loaded active running   CoreDNS Container
+</code>
+Use **systemctl enable docker.coredns** to run it at startup.