diff options
| author | Jenkins <jenkins@review.openstack.org> | 2015-04-16 01:31:45 +0000 |
|---|---|---|
| committer | Gerrit Code Review <review@openstack.org> | 2015-04-16 01:31:45 +0000 |
| commit | 5c2e13592b37b24ee9426ecf29c9e9c9bd77c9b9 (patch) | |
| tree | 1da6b6886f2837d14ce5be726c78ea505868caba | |
| parent | 4999b0cb5347b916ea99bceb2d32a3a89a0ddcc2 (diff) | |
| parent | 9bbf1ba87bf0207d11a4455e5f5296863c9c327e (diff) | |
| download | kolla-5c2e13592b37b24ee9426ecf29c9e9c9bd77c9b9.tar.gz kolla-5c2e13592b37b24ee9426ecf29c9e9c9bd77c9b9.zip | |
Merge "Update developer documentation"
| -rw-r--r-- | docs/developer-env.md | 45 |
1 files changed, 19 insertions, 26 deletions
diff --git a/docs/developer-env.md b/docs/developer-env.md index 3e11c5446..165d37bad 100644 --- a/docs/developer-env.md +++ b/docs/developer-env.md @@ -10,45 +10,38 @@ your Kolla development environment. ## Installing Dependencies In order to run Kolla, it is mandatory to run a version of -`docker-compose` that includes pid: host support. One of the -authors of Kolla has a pull request outstanding that the -docker-compose maintainers have said they would merge shortly. - -The pull request is: - - https://github.com/docker/compose/pull/1011 - -Until then, it must be retrieved via git and installed: - - git clone http://github.com/sdake/fig - cd fig - sudo pip install -e . - sudo pip install -U docker-py +`docker-compose` that includes pid: host support. The `docker-compose` +master repo includes support but the pip packaged version of 1.2.0 does not. +we expect the pip packaged version of docker-compose 1.3.0 to include +the necessary features, so these next steps won't be necessary if installed +from pip or distro packaging. + + git clone http://github.com/docker/compose + cd compose sudo pip install -e . - sudo pip install six==1.7.3 -The docker-compose version available via the sdake repository has been -rebased on to a master version of docker-compose which requires the -docker API 1.18. the docker API 1.18 is not available in distro -packaging and is only available by building from source. Docker also -distributes pre-built binaries for docker. It is recommended to just run -the docker provided binaries rather then building from source. +In order to run Kolla, it is mandatory to run a version of `docker` +that is a 1.6.0 release candidate greater then rc3. Docker calls increasing +the rc version number an "RC Bump". To read the RC Bump thread where images +can be downloaded: + + https://github.com/docker/docker/pull/11635#issuecomment-90293460 -If a version of Docker other then 1.6.0-rc3 is running on your system, stop it: +If a version of Docker less than 1.6.0-rc3 is running on your system, stop it: sudo systemctl stop docker sudo killall -9 docker -Next, download and run the Docker 1.6.0-rc3 provided by jessfraz (Docker Inc. -Employee - (thanks!): +Next, download and run the Docker 1.6.0-rc5 provided by jessfraz (Docker Inc. +Employee): - curl https://fedorapeople.org/groups/heat/kolla/docker-1.6.0-rc3 -o docker + curl https://test.docker.com/builds/Linux/x86_64/docker-1.6.0-rc5 -o docker sudo ./docker -d & Finally stop libvirt on the host machine. Only one copy of libvirt may be running at a time. - service libvirt stop + service libvirtd stop The basic starting environment will be created using `docker-compose`. This environment will start up the openstack services listed in the |
