Docker Development Stack

🎊 Access your Docker containers from a domain name using HTTP or HTTPS 🎊

This project provide :

• a DNS server (Dnsmasq with regex support),
• an HTTP reverse proxy (Træfɪk),
• and a Watcher that listen to started containers in order to generate TLS certificates.

Requirements

• Docker
• Docker Compose.

Usage

Simple and easy :

make run

You should be able to access:

• The Traefik FrontEnd on http://127.0.0.1:80 (you should see 404 page not found)
• The Traefik Web UI on http://127.0.0.1:8080
• A Local DNS Web UI on http://127.0.0.1:8053
• A Key/Value store Web UI on http://127.0.0.1:8500

For Windows users

Please read this (in french)

Test your stack

There is a docker-compose.yml example located in ./examples/docker-compose.yml, please read it carefully.

From your project root execute :

docker-compose -f example/docker-compose.yml up

Note: Ctrl+C to exit

Open your browser on http://dev.domain.fr or https://dev.domain.fr

Customize

By default, the local DNS server is configured to resolve every domains starting with dev. to your local IP address.

You can change that by modifying the address instruction in http://localhost:8053

You can modify the existing address or add additionnal ones.

Examples :

# A regex (must be wrapped between colons), that match domain starting with "dev."
address=/:^dev\.:/127.0.0.1

# A standard rule that match domain ending with ".docker"
address=/.docker/127.0.0.1

# A regex that match domains starting with "test." and ending with "domain.fr"
address=/:^test\..+domain.fr$:/127.0.0.1

Once done, click on Save, it will restart automatically