openstack/kolla
Code Issues Proposed changes

Document installation of docker-compose 1.3.0

Browse Source 
Also, change all references from fig to docker-compose.

Change-Id: I6bff2ab57cd6a06293d0a6d130d1cf9bc885b712
Closes-bug: #1468999
This commit is contained in:
Jeff Peeler 2015-06-26 16:42:15 -04:00
parent b2aeebd62e
commit 65f89001d0
2 changed files with 19 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docker/centos/binary/docker-compose/README.md
View File

@ -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:
```

14
docs/dev-quickstart.md
View File

@ -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`