Updates Dev Doc for M3 Release
A few errors in the dev doc were causing problems with deploying a dev env. The dev dos has been updated with the correct steps for prep'ing a host for running Kolla. Additionally, wording has been added to reference the Heat template for dev env deployment. Change-Id: I9f0ba1bd2deca490a72b3c54cb1a7df386228ee8
This commit is contained in:
parent
d944259056
commit
a0dfb204ed
@ -1,4 +1,11 @@
|
|||||||
# Developer env
|
# Developer Environment
|
||||||
|
|
||||||
|
If you are developing Kolla on an existing OpenStack cloud
|
||||||
|
that supports Heat, then follow the Heat template [README][].
|
||||||
|
Otherwise, follow the instructions below to manually create
|
||||||
|
your Kolla development environment.
|
||||||
|
|
||||||
|
[README]: https://github.com/stackforge/kolla/tree/version-m3/devenv/README.md
|
||||||
|
|
||||||
In order to run Kolla, it is mandatory to run a version of
|
In order to run Kolla, it is mandatory to run a version of
|
||||||
`docker-compose` that includes pid: host support. One of the
|
`docker-compose` that includes pid: host support. One of the
|
||||||
@ -11,10 +18,12 @@ The pull request is:
|
|||||||
|
|
||||||
Until then, it must be retrieved via git and installed:
|
Until then, it must be retrieved via git and installed:
|
||||||
|
|
||||||
git pull http://github.com/sdake/fig
|
git clone http://github.com/sdake/fig
|
||||||
cd fig
|
cd fig
|
||||||
sudo pip install .
|
sudo pip install -e .
|
||||||
sudo pip install -U docker-py
|
sudo pip install -U docker-py
|
||||||
|
sudo pip install -e .
|
||||||
|
sudo pip install six==1.7.3
|
||||||
|
|
||||||
The docker-compose version available via the sdake repository has been
|
The docker-compose version available via the sdake repository has been
|
||||||
rebased on to a master version of docker-compose which requires the
|
rebased on to a master version of docker-compose which requires the
|
||||||
@ -23,10 +32,16 @@ packaging and is only available by building from source. Docker also
|
|||||||
distributes pre-built binaries for docker. It is recommended to just run
|
distributes pre-built binaries for docker. It is recommended to just run
|
||||||
the docker provided binaries rather then building from source:
|
the docker provided binaries rather then building from source:
|
||||||
|
|
||||||
|
If a version of Docker other than 1.5.0-dev is currently running
|
||||||
|
on your system, stop it:
|
||||||
|
|
||||||
sudo systemctl stop docker
|
sudo systemctl stop docker
|
||||||
sudo killall -9 docker
|
sudo killall -9 docker
|
||||||
curl https://master.dockerproject.com/linux/amd64/docker-1.5.0-dev -o docker-dev
|
|
||||||
sudo ./docker-dev -d
|
Next, download and run the Docker 1.5.0-dev binary:
|
||||||
|
|
||||||
|
wget https://master.dockerproject.com/linux/amd64/docker-1.5.0-dev -O docker
|
||||||
|
sudo ./docker -d &
|
||||||
|
|
||||||
The basic starting environment will be created using `docker-compose`.
|
The basic starting environment will be created using `docker-compose`.
|
||||||
This environment will start up the openstack services listed in the
|
This environment will start up the openstack services listed in the
|
||||||
@ -55,19 +70,22 @@ If you want to start a container set by hand use this template
|
|||||||
|
|
||||||
# Debug
|
# Debug
|
||||||
|
|
||||||
|
All Docker commands should be run from the directory of the Docker binary,
|
||||||
|
by default this is `/`.
|
||||||
|
|
||||||
You can follow a container's status by doing
|
You can follow a container's status by doing
|
||||||
|
|
||||||
$ sudo docker ps -a
|
$ sudo ./docker ps -a
|
||||||
|
|
||||||
If any of the containers exited you can check the logs by doing
|
If any of the containers exited you can check the logs by doing
|
||||||
|
|
||||||
$ sudo docker logs <glance-api-container>
|
$ sudo ./docker logs <glance-api-container>
|
||||||
$ docker-compose 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
|
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
|
this template. This is a good method to test and troubleshoot an individual
|
||||||
container.
|
container.
|
||||||
|
|
||||||
$ docker run --name glance-api -d \
|
$ sudo ./docker run --name glance-api -d \
|
||||||
--net=host
|
--net=host
|
||||||
--env-file=openstack.env kollaglue/fedora-rdo-glance-api:latest
|
--env-file=openstack.env kollaglue/fedora-rdo-glance-api:latest
|
||||||
|
Loading…
x
Reference in New Issue
Block a user