openstack/ironic
Code Issues Proposed changes
ironic/doc/source/dev/dev-quickstart.rst
Devananda van der Veen 676a157f42 More doc updates. 
Create doc/source/dev/ directory, and add several files that got
accidentaly ignored because they were under doc/source/api/.

Also move some files from doc/source into doc/source/dev to clean up the
base doc dir.

Change-Id: Ief9777216db82ec3be32b7a73e2d268a3a973ef8
2013-05-29 16:20:58 -07:00

1.3 KiB
Raw Blame History

Developer Quick-Start

This is a quick walkthrough to get you started developing code for Ironic. This assumes you are already familiar with submitting code reviews to an OpenStack project.

Ironic source code should be pulled directly from git:

cd <your source dir>
git clone https://github.com/openstack/ironic
cd ironic

Install prerequisites:

# Ubuntu/Debian:
sudo apt-get install python-dev swig libssl-dev python-pip libmysqlclient-dev libxml2-dev libxslt-dev

# Fedora/RHEL:
sudo yum install python-devel swig openssl-devel python-pip mysql-libs libxml2-devel libxslt-devel

sudo easy_install nose
sudo pip install virtualenv setuptools-git flake8 tox

Setting up a local environment for development can be done with tox:

# create virtualenv
tox -evenv -- echo 'done'

# activate the virtualenv
source .tox/venv/bin/activate

# run testr init
testr init

To run the pep8/flake8 syntax and style checks:

# run pep8/flake8 checks
flake8

To run Ironic's unit test suite:

# run unit tests
testr run

When you're done, to leave the venv:

# deactivate the virtualenv
deactivate