openstack/barbican
Code Issues Proposed changes
2acc1f4911
barbican/doc/source/setup/devstack.rst
Christopher Solis e171dcdca2 Update Devstack deployment and docs 
Move the devstack files inside Barbican tree. Also updates
the devstack documentation for installing barbican via
vagrant or manually.

Closes-bug: #1499112
Change-Id: Ifd09aa3c120033f4043d1a0c106a5ea653ee3c68
2015-10-29 14:45:27 -05:00

3.1 KiB
Raw Blame History

Running Barbican on DevStack

Barbican is currently available via the plugin interface within devstack

We provide two ways of deploying a DevStack environment with a running Barbican. The easy mode uses vagrant and automatically creates the VM with all necessary dependencies to run DevStack. It is recommended to use this process if it is your first time.

If you are familiar with DevStack you can use the steps in the manual setup section to install Barbican onto your already running DevStack installation.

Warning

This process takes anywhere from 10-30 minutes depending on your internet connection.

Easy Mode

To simplify the setup process of running Barbican on DevStack, there is a Vagrantfile that will automatically setup up a VM containing Barbican running on Devstack.

  1. Obtain Barbican vagrant file If you don't already have the file then clone the repo below

    git clone https://github.com/openstack/barbican.git

  2. Move the barbican-vagrant directory outside of the Barbican directory and into your current directory for vagrant files. If you do not have one, then just copy it into your home directory.

    cp -r barbican/devstack/barbican-vagrant <directory>

  3. Get into the barbican-vagrant directory

    cd barbican-vagrant

  4. Start create a new VM based on the cloned configuration

    vagrant up

  5. Once the VM has been successfully started and provisioned, ssh into the VM.

    vagrant ssh

  6. Once inside the VM, change your directory to the devstack folder.

    cd /opt/stack/devstack/

  7. Start DevStack

    ./stack.sh

Manual Setup

These steps assume you are running within a clean Ubuntu 14.04 virtual machine (local or cloud instance). If you are running locally, do not forget to expose the following ports

  1. Barbican - 9311
  2. Keystone API - 5000
  3. Keystone Admin API - 35357

Installation

  1. Make sure you are logged in as a non-root user with sudo privileges

  2. Install git

    sudo apt-get install git

  3. Clone DevStack

    git clone https://github.com/openstack-dev/devstack.git

  4. Add the Barbican plugin to the local.conf file and verify the minimum services required are included. You can pull down a specific branch by appending the name to the end of the git url. If you leave the space empty like below, then origin/master will be pulled.

    enable_plugin barbican https://git.openstack.org/openstack/barbican
enable_service rabbit mysql key

    If this is your first time and you do not have a local.conf file, there is an example in the Barbican github. Copy the file and place it in the devstack/ directory.

  5. Start DevStack

    cd devstack/
./stack.sh