From 65f89001d04d4c4999ffd40693f947e59432c64b Mon Sep 17 00:00:00 2001 From: Jeff Peeler Date: Fri, 26 Jun 2015 16:42:15 -0400 Subject: [PATCH] Document installation of docker-compose 1.3.0 Also, change all references from fig to docker-compose. Change-Id: I6bff2ab57cd6a06293d0a6d130d1cf9bc885b712 Closes-bug: #1468999 --- docker/centos/binary/docker-compose/README.md | 25 ++++++++++--------- docs/dev-quickstart.md | 14 +++++------ 2 files changed, 19 insertions(+), 20 deletions(-) diff --git a/docker/centos/binary/docker-compose/README.md b/docker/centos/binary/docker-compose/README.md index a63e7fbc92..857202e779 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 7158e9d7c7..0f718e22e5 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. +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/docker/compose - cd compose - sudo pip install -e . + 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`