Files
group-based-policy/doc/source/installation.rst
Sumit Naiksatam 89c8250365 Shared column in APG schema & change devstack plugin name
Also updates exercise script which will catch this.

And also fixes an issue due to which the AIM gate job was
running against the master branch of GBP source versus
the branch checked out for this patchset by the infra
job. This is fixed by changing the GBP devstack plugin name
to group-based-policy instead of the earlier name 'gbp'.
This allows the job to use the 'group-based-policy' source
directory cloned by the OpenStack infra job (for the current
patchset) as opposed to cloning into a new 'gbp' directory
from the master. Unfortunately, a lot of special casing
needs to be introduced for configuration of other services
as well. It is not possible to get away from this special
casing to be able to install from the intree devstack plugin
and the GBP master branch is behind the OpenStack master
release.

Closes-bug: 1674024

Change-Id: I5bd3f1c3ecfbedbd24243c2c111472dcff9059a2
2017-03-20 09:53:48 +00:00

57 lines
1.5 KiB
ReStructuredText

============
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/newton`` branch of DevStack::
$ git clone -b stable/newton 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 group-based-policy https://git.openstack.org/openstack/group-based-policy master
Or, if you need install from a patch under review::
[[local|localrc]]
enable_plugin group-based-policy https://git.openstack.org/openstack/group-based-policy <GITREF>
where, GITREF is the patchset reference of the patchset under review. E.g.::
[[local|localrc]]
enable_plugin group-based-policy https://git.openstack.org/openstack/group-based-policy refs/changes/65/353265/2
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 group-based-policy https://github.com/openstack/group-based-policy.git master