iamluc/docker-hostmanager

Update /etc/hosts to access running containers

Tuesday, June 19, 2018
by iamluc
Repository
6 Watchers
72 Stars
29 Installations

PHP
0 Dependents
0 Suggesters
15 Forks
7 Open issues
17 Versions
0 % Grown

The README.md

docker-hostmanager

ABOUT

Update automatically your /etc/hosts to access running containers. Inspired by vagrant-hostmanager., _(*1)

Project homepage: https://github.com/iamluc/docker-hostmanager, _(*2)

USAGE

Linux

The easiest way is to use the docker image, _(*3)

$ docker run -d --name docker-hostmanager --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /etc/hosts:/hosts iamluc/docker-hostmanager

Note: the --restart=always option will make the container start automatically with your computer (recommended)., _(*4)

Mac OS

Download the PHAR executable here : https://github.com/iamluc/docker-hostmanager/releases, _(*5)

And then run it:, _(*6)

$ sudo php docker-hostmanager.phar synchronize-hosts

Note: We run the command as root as we need the permission to write file /etc/hosts. If you don't want to run the command as root, grant the correct permission to you user., _(*7)

Before running the command, don't forget to export your docker environment variables. i.e., _(*8)

$ eval $(docker-machine env mybox)

Also, you should add a route to access containers inside your VM., _(*9)

$ sudo route -n add 172.0.0.0/8 $(docker-machine ip $(docker-machine active))

Windows

If the host, dont use Docker ToolBox or not a Windows 10 PRO, then needs to mount the /c/Windows folder onto VirtualBox., _(*10)

$ docker run -d --name docker-hostmanager --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /c/Windows/System32/drivers/etc/hosts:/hosts iamluc/docker-hostmanager

After run the container we need to add a route to access container subnets., _(*11)

$ route /P add 172.17.0.0/12 192.168.99.100

CONFIGURATION

With networks

When a container belongs to at least one network (typically when using a docker-compose.yml file in version >= 2), the name defined to access the container is CONTAINER_NAME.CONTAINER_NETWORK. It works also with the alias defined for the network., _(*12)

As a container can belongs to several networks at the same time, and thanks to alias, you can define how you want to access your container., _(*13)

Example 1 (default network):, _(*14)

version: '2'

services:
    web:
        image: iamluc/symfony
        volumes:
            - .:/var/www/html

The container web will be accessible with web.myapp_default (if the docker-compose project name is myapp), _(*15)

Example 2 (custom network name and alias):, _(*16)

version: '3.5'

networks:
    default:
        name: myapp

services:
    web:
        image: iamluc/symfony
        volumes:
            - .:/var/www/html

    mysql:
        image: mysql
        networks:
            default:
                aliases:
                    - bdd

The web container will be accessible with web.myapp. The mysql container will be accessible with mysql.myapp or bdd.myapp, _(*17)

Without networks

When a container has no defined network (only the default "bridge" one), it is accessible by its container name, concatened with the defined TLD (.docker by default). It is the case when you run a single container with the docker command or when you use a docker-compose.yml file in version 1., _(*18)

The DOMAIN_NAME environment variable lets you define additional hosts for your container. e.g.:, _(*19)

$ docker run -d -e DOMAIN_NAME=test.com,www.test.com my_image

Tests

To run test, execute the following command : vendor/bin/phpunit, _(*20)

LICENSE

MIT, _(*21)

The Versions

19/06 2018

dev-master

9999999-dev

Update /etc/hosts to access running containers

project docker-hostmanager

Update /etc/hosts to access running containers

iamluc/docker-hostmanager

The README.md

docker-hostmanager

ABOUT

USAGE

Linux

Mac OS

Windows

CONFIGURATION

With networks

Without networks

Tests

LICENSE

The Versions

dev-master

The Requires

The Development Requires

by Luc Vieillescazes

dev-update-readme

The Requires

The Development Requires

by Luc Vieillescazes

dev-develop

The Requires

The Development Requires

by Luc Vieillescazes

v0.4.0

The Requires

The Development Requires

by Luc Vieillescazes

dev-compat-docker-1.12

The Requires

The Development Requires

by Luc Vieillescazes

v0.3.3

The Requires

The Development Requires

by Luc Vieillescazes

v0.3.2

The Requires

The Development Requires

by Luc Vieillescazes

v0.3.1

The Requires

The Development Requires

by Luc Vieillescazes

v0.3.0

The Requires

The Development Requires

by Luc Vieillescazes

dev-networks

The Requires

The Development Requires

by Luc Vieillescazes

dev-feature/install

The Requires

The Development Requires

by Luc Vieillescazes

v0.2.0

The Requires

The Development Requires

by Luc Vieillescazes

v0.2.0-beta2

The Requires

The Development Requires

by Luc Vieillescazes

dev-feature/docker-machine

The Requires

The Development Requires

by Luc Vieillescazes

dev-feature/refacto

The Requires

The Development Requires

by Luc Vieillescazes

v0.2.0-beta1

The Requires

The Development Requires

by Luc Vieillescazes