group-based-policy/doc/source/installation.rst
Igor Duarte Cardoso 5b463f4cfa Migrate DevStack support to a DevStack plugin
This change adds a DevStack plugin for Group-Based Policy.

A new top-level directory, devstack, has been created to fulfill
the contract of the DevStack plugin mechanism [1].

Documentation on how to enable the plugin has been added to
doc/source/installation.rst.

[1] http://docs.openstack.org/developer/devstack/plugins.html

Change-Id: I7e6c95408fbb132e33823d803a44f2867541a922
Closes-Bug: #1564893
2016-04-14 11:44:59 +01:00

1.1 KiB

Installation

At the command line:

$ pip install gbpservice

Or, if you have virtualenvwrapper installed:

$ mkvirtualenv gbpservice
$ pip install gbpservice

Using DevStack

First, clone the latest stable/mitaka branch of DevStack:

$ git clone -b stable/mitaka https://git.openstack.org/openstack-dev/devstack
$ cd devstack

Then, create a basic local.conf including at least the following lines:

[[local|localrc]]
enable_plugin gbp https://git.openstack.org/openstack/group-based-policy master

Finally, you are ready to run stack.sh.

Here is an example of a working Group-Based Policy DevStack local.conf file with logging, a custom password for all services and a custom git remote pointing to GitHub:

[[local|localrc]]
SERVICE_TOKEN=password
ADMIN_PASSWORD=password
DATABASE_PASSWORD=password
RABBIT_PASSWORD=password
SERVICE_PASSWORD=$ADMIN_PASSWORD

LOGFILE=$DEST/logs/stack.sh.log
LOGDAYS=2

GIT_BASE=https://github.com
RECLONE=True

enable_plugin gbp https://github.com/openstack/group-based-policy.git master