Jump to: navigation, search

Difference between revisions of "Neutron/TempestAPITests"

(Tempest API Tests for Neutron)
(Tempest API Tests for Neutron)
Line 17: Line 17:
  
 
These are [https://wiki.openstack.org/wiki/NeutronDevstack specific instructions] on how to set-up DevStack for Neutron. Kyle Mestery, one of the Neutron core developers, put together [http://www.slideshare.net/mestery/openstack-development-using-devstack this presentation] about using DevStack for Neutron development.
 
These are [https://wiki.openstack.org/wiki/NeutronDevstack specific instructions] on how to set-up DevStack for Neutron. Kyle Mestery, one of the Neutron core developers, put together [http://www.slideshare.net/mestery/openstack-development-using-devstack this presentation] about using DevStack for Neutron development.
 +
 +
 +
===Learning the Neutron API===
 +
 +
This is the official [http://docs.openstack.org/api/openstack-network/2.0/content/ Neutron ReST API documentation].

Revision as of 00:39, 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.

These are specific instructions on how to set-up DevStack for Neutron. Kyle Mestery, one of the Neutron core developers, put together this presentation about using DevStack for Neutron development.


Learning the Neutron API

This is the official Neutron ReST API documentation.