https://github.com/whiteducksoftware/az-dns-forwarder

A containerized Azure DNS Forwarder 🛠
https://github.com/whiteducksoftware/az-dns-forwarder

aci aks azure bind container dns forwarder

Last synced: 6 months ago
JSON representation

A containerized Azure DNS Forwarder 🛠

• Host: GitHub
• URL: https://github.com/whiteducksoftware/az-dns-forwarder
• Owner: whiteducksoftware
• License: mit
• Created: 2020-06-03T09:29:54.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-09-02T06:40:36.000Z (about 5 years ago)
• Last Synced: 2025-03-24T19:35:49.507Z (7 months ago)
• Topics: aci, aks, azure, bind, container, dns, forwarder
• Language: Dockerfile
• Homepage: https://whiteduck.de
• Size: 10.7 KB
• Stars: 62
• Watchers: 6
• Forks: 29
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Containerized Azure DNS Forwarder

> This project is inspired by the [DNS Forwarder VM](https://github.com/Azure/azure-quickstart-templates/tree/master/301-dns-forwarder/). It provides a similar experience for a containerized environment. 

This project provides a containerized DNS server that forwards queries to Azure's internal DNS servers so that hostnames in the virtual network can be resolved from outside the network. This is helpful, for example, when you need to resolve Private Link enabled resources from your on-premises networks connected via Side-to-Side VPN or ExpressRoute. 

This Container can be deployed and exposed internally with Azure Kubernetes Service as well as Azure Container Instances.

![DNS Forwarder](https://docs.microsoft.com/en-us/azure/private-link/media/private-endpoint-dns/hybrid-scenario.png)

## Get started

Below you find get started guides for AKS as well as ACI.

### Azure Kubernetes Service

You need make sure that all needed private Azure DNS zones are linked to the virtual network used for AKS. Without this the DNS forwarder will not be able to resolve them.

```

kubectl apply -f https://raw.githubusercontent.com/whiteducksoftware/az-dns-forwarder/master/deploy.yaml

```

This will deploy the Azure DNS Forwarder container as Deployment with 3 replicas. It also creates an LoadBalancer services using an internal Azure Loadbalancer to expose the DNS forwarder internally. 

### Azure Container Instances

You can also run the DNS Forwarder as a serverless instance with ACI. Once again, you will need to make sure to expose ACI internally and make sure that all needed Azure private DNS zones are linked to the used virtual network.

```

az container create \

  --resource-group  \

  --name dns-forwarder \

  --image ghcr.io/whiteducksoftware/az-dns-forwarder/az-dns-forwarder:latest \

  --cpu 1 \

  --memory 0.5 \

  --restart-policy always \

  --vnet  \

  --subnet  \

  --ip-address private \

  --location  \

  --os-type Linux \

  --port 53 \

  --protocol UDP

```