Add devstack external plugin spec
7 years ago
4 changed files
Download Patch File
Download Diff File
@ -20,7 +20,7 @@ DevStack Project Specifications
@ -0,0 +1,97 @@
This work is licensed under a Creative Commons Attribution 3.0 Unported
Devstack external plugins
Support external plugins for devstack.
Devstack has a pretty strong plugin support, you just have to drop
your extra feature in the extras.d/ directory and it will
automatically parse the file and install the feature as long you have
enabled it in your local.conf.
This all works very well but that's not very flexible for projects
that are not able to be integrated directly in devstack
core. Currently an external OpenStack project who wants to tell its
users how to test a feature has to explain how to download a file to
put in the
directory and enabling it.
As for integrated projects they may wants to take care of how they do
devstack directly in their own repo and get devstack to use that
instead of having to request for a change in devstack repository.
Devstack would provide a new enable_plugin function call that would be
of the following format::
enable_plugin <name> <http://git.openstack.org/foo/external_feature>
is an arbitrary name picked for enablement,
full url to a git repo, and
is the optional ref
description (defaulting to
if none is provided).
Devstack would then checkout that repository in
look for a
directory in there from the root of the repo.
Files in there would have :
- a file that gets sourced to override global settings,
those variables become instantly available in the global namespace.
- dispatcher for the various phases
Devstack when executed will then:
* Get the configuration of the
* Clone the extras repository to
* Run all the
scripts at a particular phase
* Run all the plugins
at a particular phase
This would let the out of tree projects that needs to communicate about their
config to export data via settings that would let the other configure based on
The alternative would be to stay as the status quo like we have now and have
them to curl the extras file from the external repository and place it in the
* Chmouel Boudjnah <email@example.com>
* Sean Dague <firstname.lastname@example.org>
Target Milestone for completion:
* Add support in devstack.
* Get an example repository setup.
* Get a project like nova-docker to use it.
* (glusterfs is a good current candidate)
@ -1,4 +1,4 @@
# Copyright 2014 Samsung Electronics
# All Rights Reserved.
@ -24,3 +24,4 @@ commands = sphinx-build -b spelling doc/source doc/build/spelling
./tools/rstcheck.py -d specs
# ./tools/rstcheck.py -d backlog