Jump to: navigation, search

Difference between revisions of "Neutron/TempestAPITests"

(Tempest API Tests for Neutron)
(Tempest API Tests for Neutron)
Line 14: Line 14:
 
===Setting up a development system===
 
===Setting up a development system===
  
[http://devstack.org/ Devstack] is a documented shell script to install and run an OpenStack cloud on your laptop. Most developers don't run DevStack on their laptops "bare hardware". Instead, DevStack is frequently deployed to VM created using virtualization software such as (or ev DevStack is ideal for potential users who want to see what the Dashboard looks like from an admin or user perspective, and OpenStack contributors wanting to test against a complete local environment
+
[http://devstack.org/ Devstack] is a documented shell script to install and run an OpenStack cloud on your laptop. Most developers don't run DevStack on their laptop's "bare metal". Instead, DevStack is frequently deployed to a VM created using virtualization software such as [https://www.virtualbox.org/ VirtualBox], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.ibm.com/developerworks/cloud/library/cl-managingvms/ Virtual Machine Manager]. DevStack is ideal for potential users who want to see what the Dashboard looks like from an admin or user perspective, and OpenStack contributors wanting to test against a complete local environment.

Revision as of 00:26, 9 December 2013

Tempest API Tests for Neutron

The fundamental interface to the OpenStack services is a set of ReST API's. Other interfaces, such as CLI commands or the Horizon portal, are built on top of these ReST API's. As a consequence, it is of paramount importance to have tools to validate that an OpenStack deployment behaves according to the ReST API's specification.

Tempest is a set of functional integration tests intended to be run against actual OpenStack deployments. It is a functional testing framework that uses the testools Python library as a base. Test cases execute a series of API calls against OpenStack service endpoints (like Neutron or Nova) and validate the responses received from said endpoints.

The purpose of this page is to walk new OpenStack developers through the initial steps of writing Tempest API tests for Neutron.


If you are an absolute beginner: joining the community

Before writing any code for OpenStack or Tempest, you need need to take some administrative steps to join the community. Colin McNamara put together an excellent presentation on this topic. You can watch Colin delivering the presentation here.


Setting up a development system

Devstack is a documented shell script to install and run an OpenStack cloud on your laptop. Most developers don't run DevStack on their laptop's "bare metal". Instead, DevStack is frequently deployed to a VM created using virtualization software such as VirtualBox, VMware Fusion or Virtual Machine Manager. DevStack is ideal for potential users who want to see what the Dashboard looks like from an admin or user perspective, and OpenStack contributors wanting to test against a complete local environment.