02b36d9702
Basic develop quickstart guide to setup kolla using docker-compose. Change-Id: I3c0c3d92ee4bccfa4173c05be6755bd048296daf
44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# Developer env
|
|
|
|
The basic starting enviroment 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.sh
|
|
|
|
The `genenv.sh` script will create an 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.
|
|
|
|
$ ./start.sh
|
|
|
|
The `start.sh` 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
|