From fc3c30450429be230a5e992c314f6d318057b236 Mon Sep 17 00:00:00 2001 From: Steven Dake Date: Wed, 27 May 2015 07:13:12 -0700 Subject: [PATCH] Change documentation to recommend Docker 1.7.0-dev Docker 1.7.0-dev is required to support cinder and neutron thin containers. It would also be helpful that we validate that Docker 1.7.0-dev is working well with Kolla. For more details on the Neutron thin containers check out: https://github.com/SamYaple/yaodu/blob/master/ansible/roles/docker_build/files/ubuntu/neutron/ip_wrapper.py Change-Id: Ie422185ea090090b35fcaa2e1c6ecab1c8ea326b --- devenv/kollanode.yaml | 5 ++--- docs/dev-quickstart.md | 26 ++++++++++++++++++++------ 2 files changed, 22 insertions(+), 9 deletions(-) diff --git a/devenv/kollanode.yaml b/devenv/kollanode.yaml index e213ef3c22..1dee949030 100644 --- a/devenv/kollanode.yaml +++ b/devenv/kollanode.yaml @@ -161,9 +161,8 @@ resources: # Install base packages yum -y install wget ntp git tcpdump python-pip - # Install Docker from binaries due to: - # https://github.com/docker/docker/issues/11760#issuecomment-88288278 - curl https://fedorapeople.org/groups/heat/docker-1.6.0-rc5 -o /usr/local/sbin/docker + # Install Docker from binaries + curl -L https://master.dockerproject.com/linux/amd64/docker-1.7.0-dev -o /usr/local/sbin/docker chmod +x /usr/local/sbin/docker && cd /usr/local/sbin/ ./docker -d & diff --git a/docs/dev-quickstart.md b/docs/dev-quickstart.md index e471ae7903..0dc4d5ce04 100644 --- a/docs/dev-quickstart.md +++ b/docs/dev-quickstart.md @@ -21,18 +21,32 @@ distro packaging. sudo pip install -e . In order to run Kolla, it is mandatory to run a version of `docker` -that is a 1.6.0. Docker 1.5.0 has a defect in `--pid=host` support where -the libvirt container cannot be stopped. +that is 1.7.0-dev or later. Docker 1.5.0 has a defect in `--pid=host` +support where the libvirt container cannot be stopped. Docker 1.6.0 lacks +specific features needed by the master of Kolla. Docker 1.7.0-dev introduces +mount propogation which is necessary for Neutron thin containers +and bindmounting of the /dev filesystem which is mandatory for the cinder +container. -If a version of Docker less than 1.6.0 is running on your system, stop it: +If a version of Docker less than 1.7.0-dev is running on your system, stop it: sudo systemctl stop docker sudo killall -9 docker -Next, download and run the Docker 1.6.0 binary provided by Docker Inc.: +If using an RPM based system, use the Docker 1.7.0-dev RPMs provided by the +Fedora project: - curl https://get.docker.com/builds/Linux/x86_64/docker-1.6.0 -o docker - sudo ./docker -d & + sudo yum install https://kojipkgs.fedoraproject.org//packages/docker/1.7.0/6.git56481a3.fc23/x86_64/docker-1.7.0-6.git56481a3.fc23.x86_64.rpm + +For Debian based systems, use the Docker installation tool provided by Docker, +Inc.: + + curl -sSL https://test.docker.com/ | sh + +For Ubuntu based systems, use the Docker installation tool provided by Docker, +Inc.: + + curl -sSL https://test.docker.com/ubuntu | sh Next, install the OpenStack python clients if they are not installed: