2. Install Docker Engine & Docker Compose¶

2.1.1. Installing Docker on Ubuntu¶

Follow the official Docker documentation: Installation on Ubuntu.

You should edit /etc/default/docker and add:

# We add 8.8.8.8 as default dns server so that
# we can access the Internet even if dnsdock image is not up
DOCKER_OPTS="--bip=172.17.42.1/24 --dns 172.17.42.1 --dns 8.8.8.8"

You may need to also add nameserver 172.17.42.1 to your resolv.conf file:

Edit /etc/resolvconf/resolv.conf.d/head and add:

nameserver 172.17.42.1

Then force update of resolv.conf:

$ sudo resolvconf -u

2.1.2. Installing Docker on Fedora¶

Fedora 21

See also the official Docker documentation: Installation on Fedora.

# Download and install Docker
$ sudo yum install docker

# Start the docker daemon
$ sudo systemctl start docker

# Make the docker daemon start at boot
$ sudo systemctl enable docker

# Add yourself to the docker group to enable running docker commands
# without prefixing with sudo i
$ sudo groupadd docker
$ sudo chown root:docker /var/run/docker.sock
$ sudo usermod -a -G docker $USERNAME

# Configure docker to use our DNS container instead of the default and
# remove the selinux option. In the OPTIONS key, replace '--selinux-enabled'
# by '--bip=172.17.42.1/16 --dns=172.17.42.1'
$ sudo vim /etc/sysconfig/docker

# The following is asked in the sysconfig/docker file but reports an
# error (with Docker 1.6.0 on Fedora 21)
$ sudo setsebool -P docker_transition_unconfined=true

# Resulted in Boolean docker_transition_unconfined is not defined
# Install tool to configure firewalld to allow DNS requests to enable the
# docker containers to use our DNS container (otherwise you can access your
# containers using DNS but they can't use it themselves to link with other
# containers)
$ sudo yum install firewall-config

Next, open the Firewall tool and set and check the DNS box for each of the profiles you use. Then restart Firewalld with $ sudo systemctl restart firewalld.

Finally, open the Network Manager. Go to the PCI Ethernet configuration (or Wi-Fi if you use it). Open the IPv4 tab and in the DNS block toggle “Automatic” to Off and add 172.17.42.1 at the top of the DNS list. Also add 8.8.8.8 after it to keep access to the rest of the net.

Then, reboot. Check that your DNS server is still set and that the docker daemon started.

2.1.3. Installing Docker on Mac OS X¶

Go to https://www.docker.com/docker-toolbox and download Docker Toolbox for Mac OS X. It will install Docker, Docker Machine, Docker Compose, Docker Kitematic and VirtualBox. Once the install is done, launch “Docker Quickstart Terminal”, then follow this documentation.

You should also add the entry tuleap_web_1.tuleap-aio-dev.docker to your /etc/hosts. Run docker-machine env to get your docker machine IP if need be (usually 192.168.99.100).

# contents of /etc/hosts 127.0.0.1 localhost 255.255.255.255 broadcasthost ::1 localhost

192.168.99.100 tuleap_web_1.tuleap-aio-dev.docker