forked from docker/docker-hoster
31 lines
1.3 KiB
Markdown
31 lines
1.3 KiB
Markdown
# Hoster
|
|
|
|
A simple "etc/hosts" file injection tool to resolve names of local Docker containers on the host.
|
|
|
|
hoster is intended to run in a Docker container:
|
|
|
|
docker run -d \
|
|
-v /var/run/docker.sock:/tmp/docker.sock \
|
|
-v /etc/hosts:/tmp/hosts \
|
|
dvdarias/docker-hoster
|
|
|
|
The `docker.sock` is mounted to allow hoster to listen for Docker events and automatically register containers IP.
|
|
|
|
Hoster inserts into the host's `/etc/hosts` file an entry per running container and keeps the file updated with any started/stoped container.
|
|
|
|
## Container Registration
|
|
|
|
Hoster provides by default the entries `<container name>, <hostname>, <container id>` for each container and the aliases for each network. Containers are automatically registered when they start, and removed when they die.
|
|
|
|
For example, the following container would be available via DNS as `myname`, `myhostname`, `et54rfgt567` and `myserver.com`:
|
|
|
|
docker run --restart=unless-stopped -d \
|
|
--name myname \
|
|
--hostname myhostname \
|
|
--network somenetwork --network-alias "myserver.com" \
|
|
mycontainer
|
|
|
|
If you need more features like **systemd integration** and **dns forwarding** please check [resolvable](https://hub.docker.com/r/mgood/resolvable/)
|
|
|
|
Any contribution is, of course, welcome. :)
|