ubuntu/bind9

ubuntu/bind9 is a rock for bind9 maintained by https://canonical.com/.

BIND 9 provides software for Domain Name System (DNS) management including both defining domain names authoritatively for a given DNS zone, and recursively resolving domain names to their IP addresses.

\https://www.isc.org/bind/%5C]

Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels.

Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

\https://documentation.ubuntu.com/pebble/%5C]

Inspect

To view the https://documentation.ubuntu.com/rockcraft/en/latest/reference/rockcraft-yaml/#services and https://documentation.ubuntu.com/rockcraft/latest/reference/rockcraft-yaml/#checks defined in this rock:

sh
docker run --rm ubuntu/bind9:9.20-25.04_beta plan

sh
docker inspect --format='{{.Config.Entrypoint}} {{.Config.Cmd}}' ubuntu/bind9:9.20-25.04_beta

Run

To run this rock, use any of the usual container runtimes, for example, docker:

sh
docker run --name bind9-container \
    -e TZ=UTC  -p 30053:53/tcp -p 30053:53/udp \
    ubuntu/bind9:9.20-25.04_beta \
    --args <named-args>

Access your Bind9 server at localhost:30053

Additionally, you can use rndc to manage the server:

bash
docker exec bind9-container rndc <command>

A rndc key must have been previously generated either by mounting a volume containing a rndc.key file or by running rndc-confgen with:

bash
docker exec bind9-container rndc-confgen -a
docker restart bind9-container

sh
docker run --name bind9-container \
    -e TZ=UTC -p 30053:53/tcp -p 30053:53/udp \
    ubuntu/bind9:9.20-25.04_beta \
    <named-args>

Get logs

To view the logs of the running container, run:

sh
docker exec bind9-container pebble logs

Or, for a specific service:

sh
docker exec bind9-container pebble logs <service>

sh
docker logs bind9-container

Monitor health checks

Rocks may have predefined health checks that you can list by running:

sh
docker exec bind9-container pebble checks

The overall health of your container can be inspected via:

sh
docker exec bind9-container pebble health

Deploy with Kubernetes

Works with any Kubernetes; if you don't have one, we recommend you https://microk8s.io/. Then, run microk8s.enable dns storage and snap alias microk8s.kubectl kubectl.

Download https://git.launchpad.net/~ubuntu-docker-images/ubuntu-docker-images/+git/bind9/plain/examples/bind9-deployment.yml?h=9.18-22.04 and set containers.bind9.image in bind9-deployment.yml to your chosen channel tag (e.g. ubuntu/bind9:9.20-25.04_beta), then:

sh
kubectl apply -f bind9-deployment.yml

You will now be able to connect to the bind9 server on http://localhost:30053.

Configuration

Environment variables

Volumes

Ports

Other configuration options

\https://github.com/canonical/bind9-rock/issues%5C] \https://github.com/canonical/bind9-rock/%5C]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with https://canonical.com/legal/intellectual-property-policy.