Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ewindisch/dockenstack
OpenStack Devstack on Docker
https://github.com/ewindisch/dockenstack
Last synced: 3 months ago
JSON representation
OpenStack Devstack on Docker
- Host: GitHub
- URL: https://github.com/ewindisch/dockenstack
- Owner: ewindisch
- License: other
- Created: 2014-01-20T20:34:21.000Z (almost 11 years ago)
- Default Branch: openstack-ci
- Last Pushed: 2017-07-24T18:52:06.000Z (over 7 years ago)
- Last Synced: 2024-08-02T12:51:27.652Z (6 months ago)
- Language: Shell
- Homepage:
- Size: 71.3 KB
- Stars: 153
- Watchers: 13
- Forks: 58
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - ewindisch/dockenstack - OpenStack Devstack on Docker (others)
README
# Openstack on Docker
Dockenstack builds an image for running OpenStack's devstack development and testing environment inside of a Docker container. This image currently supports running the docker and libvirt-lxc virtualization drivers for Nova. KVM/Qemu support is being tested.
Using dockenstack, developers may quickly iterate changes in a container and locally invoke functional tests without needing to first submit their changes for code-review.
The quick iteration cycle of dockenstack versus other local environments (such as devstack-vagrant) is accomplished by precaching and preinstalling most or all network resources and OS packages. This speeds up running the container and, when running many, eliminates the problems that might result from offline or rate-limited apt and pip services.
Users may expect dockenstack to take 2-4 minutes on a fast machine from "docker run" through having an operational OpenStack installation.
# Build & Run
## Quickstart: Using Docker Compose
```
$ git clone https://github.com/ewindisch/dockenstack.git
$ cd dockenstack
$ docker-compose up
```
This will automatically build a Dockenstack image and run OpenStack.
The first run will take a long time due to the length process of
building the Docker image (~60m). Subsequent runs of this image will be
quicker (~5m). Even faster, of course, is restarting a container.
## Alternative Install: Building Manually
The following is the process undertaken by Docker Compose.
Building the image may take approximately 60 minutes.
```
git clone https://github.com/ewindisch/dockenstack.git
cd dockenstack
docker build -t ewindisch/dockenstack dockenstack
docker build -t ewindisch/dockenstack-tempest dockenstack-tempest
docker run --privileged -t -i ewindisch/dockenstack
```
# Using OpenStack
If you've started dockenstack interactively without extra arguments, you'll end up with a shell and can run these steps immediately.
```
source /devstack/openrc
nova boot --image busybox --flavor 1 test
nova list
docker ps
```
A future version of this README will explain how to use the OpenStack installation from outside of the dockenstack container.
# Running Tempest
Launch the container as such:
```
docker run --privileged -t -i ewindisch/dockenstack-tempest
```
Running Tempest in Dockenstack may take approximately 30 minutes.
Arguments to run-tempest may be passed, the arguments are the same as run_tempest.sh (see Tempest documentation / source)
# Configuration
Dockenstack should understand all of the devstack environment variables
passed as enviroment variables to 'docker run'. If using Docker Compose,
these environment variables may be added to the fig.yml file.
# Notes
* Requires Docker 1.5 or later.
* AUFS / Volumes - Using AUFS and nested-docker, one may need to mount /var/lib/docker as a volume or a bind-mount. (pass '-v /var/lib/docker' to 'docker run')
* Libvirt guests may need kernel modules loaded. Libvirt/Qemu support is neither tested nor complete.
# Authors
* Eric Windisch
* Paul Czarkowski
# License
Apache2 - see `LICENSE`