Skip to content
Snippets Groups Projects
Commit 529e5785 authored by Jenkins's avatar Jenkins Committed by Gerrit Code Review
Browse files

Merge "Document installation of docker-compose 1.3.0"

parents 8708de74 65f89001
No related branches found
No related tags found
No related merge requests found
...@@ -41,23 +41,24 @@ There are commands to: ...@@ -41,23 +41,24 @@ There are commands to:
Installation and documentation 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 Use wtih Kolla
-------------- --------------
Fig (ie docker-compose) is being used to compose one or more co-located Docker-compose is being used to compose one or more co-located containers know
containers know as [container sets][]. Fig is deployed as a container from the as [container sets][]. docker-compose is deployed as a container from the
kollaglue [repository][] to Kolla nodes using the Heat orchestration [template]. kollaglue [repository][] to Kolla nodes using the Heat orchestration
The fig container creates a host mount to communicate with the docker api over [template]. The docker-compose container creates a host mount to communicate
a unix socket. The docker engine could be configured to expose the API over TCP with the docker api over a unix socket. The docker engine could be configured
and may be evaluated for future use. An additional host mount to to expose the API over TCP and may be evaluated for future use. An additional
/opt/docker-compose for fig to read the .yml file. This allows for seperating host mount to /opt/docker-compose for docker-compose to read the .yml file.
the fig code from the data/configuration information. This allows for seperating the docker-compose code from the data/configuration
information.
Either create or modify the existing docker-compose.yml file at Either create or modify the existing docker-compose.yml file at
/opt/docker-compose. Here is a simple example of a single container for /opt/docker-compose. Here is a simple example of a single container for
RabbitMQ RabbitMQ:
``` ```
rabbitmq: rabbitmq:
...@@ -79,7 +80,7 @@ Then run up to instantiate the container-set: ...@@ -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 $ 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 [container sets]: https://github.com/stackforge/kolla/blob/master/specs/containerize-openstack.rst
[template]: https://github.com/stackforge/kolla/tree/master/devenv [template]: https://github.com/stackforge/kolla/tree/master/devenv
...@@ -90,7 +91,7 @@ Contribute to Kolla Fig ...@@ -90,7 +91,7 @@ Contribute to Kolla Fig
Clone the repo: 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: Set the following ENVs in the project's Dockerfile:
``` ```
......
...@@ -15,15 +15,13 @@ these images because a dependent package supermin in CentOS needs to be ...@@ -15,15 +15,13 @@ these images because a dependent package supermin in CentOS needs to be
updated to add .xz compressed format support. updated to add .xz compressed format support.
In order to run Kolla, it is mandatory to run a version of `docker-compose` 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 that includes pid: host support. Support was added in version 1.3.0 and is
includes support but the pip packaged version of 1.2.0 does not. We expect specified in the requirements.txt. To install this and other potential future
the pip packaged version of docker-compose 1.3.0 to include the necessary dependencies:
features, so these next steps won't be necessary if installed from pip or
distro packaging. git clone http://github.com/stackforge/kolla
cd kolla
git clone http://github.com/docker/compose sudo pip install -r requirements.txt
cd compose
sudo pip install -e .
In order to run Kolla, it is mandatory to run a version of `docker` 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` that is 1.7.0-dev or later. Docker 1.5.0 has a defect in `--pid=host`
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment