kolla-ansible/docs/developer-env.md
Steven Dake 5bfc3e11f6 Add pid: host to libvirt
Without pid: host, nova-compute and libvirt fail to operate correctly
together.  I don't understand why, and I wish it weren't so, but it means
folks will have to install docker-compose from my personal github account
until the pull request is merged upstream.

Change-Id: I24e55405139c831f2df246f54c5b6fd39d00656a
2015-03-20 10:05:03 -07:00

58 lines
1.7 KiB
Markdown

# Developer env
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.
It must be retrieved via git and installed:
git pull http://github.com/sdake/fig
cd fig
sudo pip install .
sudo pip install -U docker-py
The basic starting environment will be created using `docker-compose`.
This environment will start up the openstack services listed in the
compose directory.
To start, setup your environment variables.
$ cd kolla
$ ./tools/genenv
The `genenv` script will create a compose/openstack.env file
and an openrc file in your current directory. The openstack.env
file contains all of your initialized environment variables, which
you can edit for a different setup.
Next, run the start script.
$ ./tools/start
The `start` script is responsible for starting the containers
using `docker-compose -f <osp-service-container> up -d`.
If you want to start a container set by hand use this template
$ docker-compose -f glance-api-registry.yml up -d
# Debug
You can follow a container's status by doing
$ sudo docker ps -a
If any of the containers exited you can check the logs by doing
$ sudo docker logs <glance-api-container>
$ docker-compose logs <glance-api-container>
If you want to start a individual service like `glance-api` by hand, then use
this template. This is a good method to test and troubleshoot an individual
container.
$ docker run --name glance-api -d \
--net=host
--env-file=openstack.env kollaglue/fedora-rdo-glance-api:latest