openstack/kolla-ansible
Code Issues Proposed changes

Updated some requirements about docker

Browse Source 
We were requiring docker 1.7 for a few reasons at one point. Those
reasons are no longer valid and this change reflects that.

Additionally, this adds some clarifications on the issues with Ubuntu
and AUFS.

Change-Id: I56ca1b08f0abecb6f7644bf63ca939f588ed3ee2
This commit is contained in:
Sam Yaple 2015-08-06 01:41:38 +00:00
parent 12b70241ba
commit c8904e6985
1 changed files with 11 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
docs/dev-quickstart.md
View File

@ -23,37 +23,19 @@ dependencies:
cd kolla cd kolla
sudo pip install -r requirements.txt sudo pip install -r requirements.txt
In order to run Kolla, it is mandatory to run a version of `docker` In order to run Kolla, it is mandatory to run a version of `docker` that is
that is 1.7.0-dev or later. Docker 1.5.0 has a defect in `--pid=host` 1.6.0 or later. Docker 1.5.0 has a defect in `--pid=host` support where the
support where the libvirt container cannot be stopped. Docker 1.6.0 lacks libvirt container cannot be stopped and crashes nova-compute on start.
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.7.0-dev is running on your system, stop it: For most systems you can install the latest stable version of Docker with the
following command:
curl -sSL https://get.docker.io | bash
sudo systemctl stop docker For Ubuntu based systems, do not use AUFS when starting Docker daemon unless
sudo killall -9 docker you are running the Utopic (3.19) kernel. AUFS requires CONFIG_AUFS_XATTR=y
set when building the kernel. On Ubuntu, versions prior to 3.19 did not set that
If using an RPM based system, use the Docker 1.7.0-dev RPMs provided by the flag. If you are unable to upgrade your kernel, you should use a different
Fedora project: storage backend such as btrfs.
sudo rpm -Uvh --nodeps 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
For Ubuntu based systems, do not use aufs when starting Docker daemon. Instead
use other storage options, e.g., btrfs. This is because cap_set_file is not
permitted on aufs when building docker images.
Next, install the OpenStack python clients if they are not installed: Next, install the OpenStack python clients if they are not installed: