OpenStack devstack

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Created page with "[http://devstack.org Devstack] is a script used primarily for upstream OpenStack development. This wiki page documents usage information for devstack on Fedora. = Getting Devsta...")
 
Line 31: Line 31:
  
 
= Running Devstack =
 
= Running Devstack =
 +
 +
To run devstack, you just run the <code>stack.sh</code> script.
  
 
{{admon/note|Root|Note that this script expects to be run as non-root, but with sudo access.  If you run the script as root, it will automatically create a new user.}}
 
{{admon/note|Root|Note that this script expects to be run as non-root, but with sudo access.  If you run the script as root, it will automatically create a new user.}}
  
 
  $ ./stack.sh
 
  $ ./stack.sh
 +
 +
= Using the environment =
 +
 +
Once the stack is up and running, you can use it like you would any other OpenStack deployment.  Devstack includes a couple of files that will populate your environment with the needed variables for various tools to work: <code>openrc</code> and <code>eucarc</code>.
 +
 +
$ . ./openrc
 +
$ nova list
 +
 +
$ . ./eucarc
 +
$ euca-describe-instances
 +
 +
= Running the devstack exercises =
 +
 +
Devstack includes a set of exercise scripts to do some basic testing of the running stack.  These tests are used by jenkins to gate commits to various OpenStack projects.  To run them, run the <code>exercise.sh</code> script.
 +
 +
$ ./exercise.sh
 +
 +
To see a list of tests:
 +
 +
$ ls exercises/
 +
boot_from_volume.sh  bundle.sh  client-args.sh  client-env.sh  euca.sh  floating_ips.sh  swift.sh  volumes.sh
 +
 +
To skip a set of exercises, specify a comma separated list of exercise names in the <code>SKIP_EXERCISES</code> variable:
 +
 +
$ SKIP_EXERCISES=switft,volumes
 +
$ ./exercise.sh

Revision as of 21:24, 21 March 2012

Devstack is a script used primarily for upstream OpenStack development. This wiki page documents usage information for devstack on Fedora.

Contents

Getting Devstack for Fedora

Devstack does not currently officially support Fedora. However, there is a patch that adds support for Fedora 16 which you can find here. Optionally, you can grab a version from github that includes support for using Qpid as the messaging system instead of RabbitMq: russellb's github repo.

In either case, start by clong the upstream devstack repo.

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

Using the patch from gerrit

Go to the gerrit page for the patch and find the Download section. It will provide a git command to use to get the latest version of the patch.

Using russellb's github repo

 $ git remote add russellb git://github.com/russellb/devstack.git
 $ git remote update
 $ git checkout -b fedora-support russellb/fedora-support

Initial Setup

Devstack allows you to create a localrc file with settings specific to your environment. Creating this file isn't strictly necessary, but it's likely you'll want to use it at some point. Here are some options commonly used that are worth noting:

  • MESSAGING_SYSTEM=qpid
    • Set this option if you are using the version from russellb's github repo and would like to use Qpid instead of RabbitMQ.
  • HOST_IP_IFACE=em1
    • By default, devstack assumes your primary network interface is eth0. Set this option if it's something else, like em1.

For a list of other variables that can be specified, including ones that allow you specify custom git repos and branches to use for testing, see the stackrc file.

Running Devstack

To run devstack, you just run the stack.sh script.

Note.png
Root
Note that this script expects to be run as non-root, but with sudo access. If you run the script as root, it will automatically create a new user.
$ ./stack.sh

Using the environment

Once the stack is up and running, you can use it like you would any other OpenStack deployment. Devstack includes a couple of files that will populate your environment with the needed variables for various tools to work: openrc and eucarc.

$ . ./openrc
$ nova list
$ . ./eucarc
$ euca-describe-instances

Running the devstack exercises

Devstack includes a set of exercise scripts to do some basic testing of the running stack. These tests are used by jenkins to gate commits to various OpenStack projects. To run them, run the exercise.sh script.

$ ./exercise.sh

To see a list of tests:

$ ls exercises/
boot_from_volume.sh  bundle.sh  client-args.sh  client-env.sh  euca.sh  floating_ips.sh  swift.sh  volumes.sh

To skip a set of exercises, specify a comma separated list of exercise names in the SKIP_EXERCISES variable:

$ SKIP_EXERCISES=switft,volumes
$ ./exercise.sh