https://github.com/oppodelldog/docker-dns

docker / docker-compose helper to easily define custom dns mappings
https://github.com/oppodelldog/docker-dns

dns docker docker-compose

Last synced: 5 days ago
JSON representation

docker / docker-compose helper to easily define custom dns mappings

• Host: GitHub
• URL: https://github.com/oppodelldog/docker-dns
• Owner: Oppodelldog
• Created: 2018-09-21T18:08:19.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-04-19T12:18:33.000Z (9 months ago)
• Last Synced: 2024-04-19T13:37:12.909Z (9 months ago)
• Topics: dns, docker, docker-compose
• Language: Go
• Homepage:
• Size: 869 KB
• Stars: 12
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.com/Oppodelldog/docker-dns.svg?branch=master)](https://travis-ci.com/Oppodelldog/docker-dns)

# docker-dns

> dns container for custom aliases

![DOCKER-DNS](docker-dns.png)

**Problem**

* You maintain a lot of domains, steadily growing.

* Your docker-compose.yaml already has way too many aliases for your LB.

* You want to update the dns list automatically without patching the compose file.

**Solution**

* Write a DNS Server that sits in your compose environment, and enables you to define mappings

from ```domain alias``` to ```container name```.

This is what this experiment was about. And it worked.

### Configuration

Since it's an experiment there is not much config options.

>Define the aliases in **dnsserver/data/alias**

The rest should be obvious from docker-compose.yaml or the go code.

### Restrictions

**Restrictions for the docker-compose setup:**

* you need to attach your docker services via IP address to this DNS Service

* so you need to define a docker network

### Tests

Since this project was a just a quick try, there are no unit tests yet.

But to hold the code stable there is at least a functional test.

* [functional tests](test/README.md)

### Go simply rocks

**It was fun to implement using go and those nice libraries:**

DNS: htts://github.com/miekg/dns

Docker: https://github.com/docker/docker