aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSteven Dake <stdake@cisco.com>2015-04-13 10:24:04 -0700
committerSteven Dake <stdake@cisco.com>2015-04-14 11:41:10 -0700
commit9bbf1ba87bf0207d11a4455e5f5296863c9c327e (patch)
tree99dd0ed3667a53ea9f0c9920761117794aa1bfd0
parentfa789ab8babfd2612289a1e2b0bd00bbbc80a440 (diff)
downloadkolla-9bbf1ba87bf0207d11a4455e5f5296863c9c327e.tar.gz
kolla-9bbf1ba87bf0207d11a4455e5f5296863c9c327e.zip
Update developer documentation
Tell users to pull docker-compose from Docker Inc. Recommend rc3 or greater Tell users the thread where the bump releases are being discussed Fix typo in libvirtd Change-Id: Ib47d3a57452a4266db2b47b41a789908365fda9b
-rw-r--r--docs/developer-env.md45
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