kolla-ansible/docs/developer-env.md
Martin André 888bb9cc8c Move genenv.sh and start.sh to tools directory
Rename them `genenv` and `start`.
Have `genenv` create the openrc file in the top-level directory.

Add openrc and compose/openstack.env to gitignore, as well as *.img.

Change-Id: I5d8006e97efd77cf364215f55d5e585139ae273e
2015-03-20 10:31:02 +09:00

1.3 KiB

Developer env

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