Utility to auto forward a port from localhost into ports on Docker containers running in a boot2docker or Docker Machine VM.
When it started it will listen for Docker events (start and die) and reconfigure port forwarding rules for your VirtualBox VM with Docker.
Currently even with Boot2Docker you wouldn't get all Docker experience on your OS X host because your Docker daemon will run in VM, not on localhost, which means that you will have to use Docker VM's IP address instead of "localhost". It causes some fragmentation between native and non-native Docker users. But we can solve it with "Port forwarding" feature in VirtualBox.
Tool is available in two options:
- Binaries. You can download the latest binaries from here: https://github.com/bsideup/forward2docker/releases/
- Go distribution. Install by running 'go get github.com/bsideup/forward2docker'
- Build it yourself. See "Contributing" section
- Run some Docker container:
$ docker run --name f2dtest -d -p 8000:80 nginx
- Open terminal and run forward2docker:
$ forward2docker
(NOTE: it runs in foreground, do not kill it, otherwise mappings will not be updated) - Ensure that port is mapped to your host:
$ curl http://localhost:8000
- Kill your container:
$ docker kill f2dtest
- Ensure that port is unmapped (you should see 'Connection refused'):
$ curl http://localhost:8000
- Run few more containers and verify that you can access them on localhost
no configuration required, but you can pass --run-once
flag to prevent forward2docker to listen for events and quit right after the first port assignment.
GNU Make is used as a build tool. Following commands are available:
make bootstrap
- you should call it (once) before you start. Will download all dependenciesmake build
- will rungo vet
,go fmt
and compile binary for current platformmake build_all
- will compile binaries for every supported platform. All binaries will be saved to./bin/
folder