openstack/kolla
Code Issues Proposed changes

Merge "Update developer documentation"

Browse Source
This commit is contained in:
Jenkins 2015-04-16 01:31:45 +00:00 committed by Gerrit Code Review
commit 5c2e13592b
1 changed files with 18 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
docs/developer-env.md
View File

@ -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.
`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.
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
git clone http://github.com/docker/compose
cd compose
sudo pip install -e .
sudo pip install -U docker-py
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:
If a version of Docker other then 1.6.0-rc3 is running on your system, stop it:
https://github.com/docker/docker/pull/11635#issuecomment-90293460
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