docky 6.0.1

verbose [True, False]:

Verbose mode is activated by default in order to help you to learn what docky do

env [dev, prod, preprod]:

Specify which kind of environment is used

Introduction

When doing dev, is quickly a mess to manage the port of your container

Previous version of docky was including a proxy based on nginx docker image. This solution was adding some restriction (like using the same network for all container) Now we recommands to simply install traefik and dns resolver like dnsmasq on your host.

Dnsmasq will resolve all .dy domain to your localhost 127.0.0.1

Traefik will route the domain name my-customer.dy to the container of your customer

Install traefik (1.7)

Download traefik binary

sudo curl https://github.com/containous/traefik/releases/download/v1.7.11/traefik_linux-amd64 -o /usr/bin/traefik
sudo chmod 755 /usr/bin/traefik

Add systemd configuration in /etc/systemd/system/traefik.service

sudo curl https://raw.githubusercontent.com/akretion/docky/master/traefik/traefik.service -o /etc/traefik/traefik.service

Add traefik configuration at /etc/traefik/traefik.toml (create missing directory before)

sudo mkdir /etc/traefik
sudo curl https://raw.githubusercontent.com/akretion/docky/master/traefik/traefik.toml -o /etc/traefik/traefik.toml

Create specific user

sudo useradd -G docker -r -s /bin/false -U -M traefik

Start traefik automatically

sudo systemctl enable traefik

Install Dnsmasq (For Ubuntu 18.04)

sudo apt-get install dnsmasq-base

# See resolved.conf(5) for details

[Resolve]
#DNS=
#FallbackDNS=
#Domains=
#LLMNR=no
#MulticastDNS=no
#DNSSEC=no
#Cache=yes
DNSStubListener=no   #<---- add this line here

systemctl restart systemd-resolved

[main]
plugins=ifupdown,keyfile
dns=dnsmasq       #<---- just add this line

[ifupdown]
managed=false

[device]
wifi.scan-rand-mac-address=no

sudo rm /etc/resolv.conf ; sudo ln -s /var/run/NetworkManager/resolv.conf /etc/resolv.conf

echo 'address=/.dy/127.0.0.1' | sudo tee /etc/NetworkManager/dnsmasq.d/dy-wildcard.conf

sudo systemctl reload NetworkManager

For Mac (dnsmasq)

Google is your friend by some link found, please share the doc you have found

https://passingcuriosity.com/2013/dnsmasq-dev-osx/ https://www.computersnyou.com/3786/how-to-setup-dnsmasq-local-dns/

For Windows (Acrylic DNS)

Dnsmasq is not available on windows but you can use Acrylic DNS to do exactly the same thing. See answer here: https://stackoverflow.com/questions/138162/wildcards-in-a-windows-hosts-file?answertab=votes#tab-top

Traefik Labels

traefik.frontend.rule: Host:mycustomer.dy

Will route the domain mycustomer.dy to your container more information here : https://docs.traefik.io/configuration/backends/docker/#on-containers

Docky Labels

docky.access.help: http://mycustomer.dy/mystuff

Will show the following help when starting the container

The service odoo is accessible on http://mycustomer.dy/mystuff

The label docky.main.service and docky.user

docky.main.service: odoo
docky.user: odoo

Allow to define the main service of your docker compose and the user that should be user to enter in the container