aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJenkins <jenkins@review.openstack.org>2015-06-26 21:43:52 +0000
committerGerrit Code Review <review@openstack.org>2015-06-26 21:43:52 +0000
commit529e5785ca443ed1e6570656f58c23604bae6694 (patch)
treec63f6a29ff08ce0aba9053401ae6723220c71235
parent8708de74fbab57fa3925d2881ad3115ce7df35a4 (diff)
parent65f89001d04d4c4999ffd40693f947e59432c64b (diff)
downloadkolla-529e5785ca443ed1e6570656f58c23604bae6694.tar.gz
kolla-529e5785ca443ed1e6570656f58c23604bae6694.zip
Merge "Document installation of docker-compose 1.3.0"
-rw-r--r--docker/centos/binary/docker-compose/README.md25
-rw-r--r--docs/dev-quickstart.md16
2 files changed, 20 insertions, 21 deletions
diff --git a/docker/centos/binary/docker-compose/README.md b/docker/centos/binary/docker-compose/README.md
index a63e7fbc9..857202e77 100644
--- a/docker/centos/binary/docker-compose/README.md
+++ b/docker/centos/binary/docker-compose/README.md
@@ -41,23 +41,24 @@ There are commands to:
Installation and documentation
------------------------------
-Full documentation is available on [Fig's website](http://www.fig.sh/).
+Full documentation is available on [Docker's website](https://docs.docker.com/compose/).
Use wtih Kolla
--------------
-Fig (ie docker-compose) is being used to compose one or more co-located
-containers know as [container sets][]. Fig is deployed as a container from the
-kollaglue [repository][] to Kolla nodes using the Heat orchestration [template].
-The fig container creates a host mount to communicate with the docker api over
-a unix socket. The docker engine could be configured to expose the API over TCP
-and may be evaluated for future use. An additional host mount to
-/opt/docker-compose for fig to read the .yml file. This allows for seperating
-the fig code from the data/configuration information.
+Docker-compose is being used to compose one or more co-located containers know
+as [container sets][]. docker-compose is deployed as a container from the
+kollaglue [repository][] to Kolla nodes using the Heat orchestration
+[template]. The docker-compose container creates a host mount to communicate
+with the docker api over a unix socket. The docker engine could be configured
+to expose the API over TCP and may be evaluated for future use. An additional
+host mount to /opt/docker-compose for docker-compose to read the .yml file.
+This allows for seperating the docker-compose code from the data/configuration
+information.
Either create or modify the existing docker-compose.yml file at
/opt/docker-compose. Here is a simple example of a single container for
-RabbitMQ
+RabbitMQ:
```
rabbitmq:
@@ -79,7 +80,7 @@ Then run up to instantiate the container-set:
```
$ docker run --privileged -v /opt/docker-compose:/opt/docker-compose -v /var/run/docker.sock:/var/run/docker.sock kollaglue/fedora-rdo-docker-compose up -d
```
-The -d flag tells fig to run the container set in daemonized mode.
+The -d flag tells docker-compose to run the container set in daemonized mode.
[container sets]: https://github.com/stackforge/kolla/blob/master/specs/containerize-openstack.rst
[template]: https://github.com/stackforge/kolla/tree/master/devenv
@@ -90,7 +91,7 @@ Contribute to Kolla Fig
Clone the repo:
```
-git clone https://github.com/docker/fig.git
+git clone https://github.com/docker/compose.git
```
Set the following ENVs in the project's Dockerfile:
```
diff --git a/docs/dev-quickstart.md b/docs/dev-quickstart.md
index 7158e9d7c..0f718e22e 100644
--- a/docs/dev-quickstart.md
+++ b/docs/dev-quickstart.md
@@ -15,15 +15,13 @@ these images because a dependent package supermin in CentOS needs to be
updated to add .xz compressed format support.
In order to run Kolla, it is mandatory to run a version of `docker-compose`
-that includes pid: host support. The `docker-compose` master repository
-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 .
+that includes pid: host support. Support was added in version 1.3.0 and is
+specified in the requirements.txt. To install this and other potential future
+dependencies:
+
+ git clone http://github.com/stackforge/kolla
+ cd kolla
+ sudo pip install -r requirements.txt
In order to run Kolla, it is mandatory to run a version of `docker`
that is 1.7.0-dev or later. Docker 1.5.0 has a defect in `--pid=host`