Manage a pool of nodes for a distributed test infrastructure
Go to file
Paul Belanger 286065ebbc Bump pbr requirements to >=1.3
This is to fix a downstream issue between nodepool and
diskimage-builder pip dependencies. Since nodepool depends on
diskimage-builder, it would be nice to have common depends.

We also bump hacking to deal with pbr version issues.

Change-Id: I0efa395bc66c9e50bfe4a13e971232ad9184ad48
Signed-off-by: Paul Belanger <>
2015-09-14 16:19:13 -04:00
devstack Merge "Test dib image builds with devstack too." 2015-08-21 11:51:54 +00:00
doc Add support for project-name parameter 2015-08-18 18:05:09 -07:00
nodepool Merge "Add support for project-name parameter" 2015-08-20 17:38:49 +00:00
tools Move nodepool test checks into nodepool 2015-08-20 16:01:12 -07:00
.gitignore Ignore vim editor backup and swap files. 2014-01-20 13:23:04 +13:00
.gitreview Added .gitreview 2013-08-13 17:10:06 +00:00
.testr.conf Add a test for subnodes 2014-03-31 09:22:00 -07:00
README.rst Merge "Update Readme config -> system-config repo" 2015-04-27 18:21:45 +00:00
requirements.txt Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
setup.cfg Replace ci.o.o links with docs.o.o/infra 2015-05-14 21:38:16 +00:00 Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
test-requirements.txt Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
tox.ini Add tox 'docs' env to build Sphinx documentation 2015-04-21 17:33:52 +02:00



Nodepool is a service used by the OpenStack CI team to deploy and manage a pool of devstack images on a cloud server for use in OpenStack project testing.

Developer setup

Install dependencies:

sudo apt-get update
sudo apt-get -qy install git mysql-server libmysqlclient-dev g++\
                 python-dev python-pip libffi-dev libssl-dev qemu-utils
mkdir src
cd ~/src
git clone git://
git clone git://
cd nodepool
sudo pip install -U -r requirements.txt
sudo pip install -e .

If you're testing a specific patch that is already in gerrit, you will also want to install git-review and apply that patch while in the nodepool directory, ie:

git review -x XXXXX

Create or adapt a nodepool yaml file. You can adapt an infra/system-config one, or fake.yaml as desired. Note that fake.yaml's settings won't Just Work - consult ./modules/openstack_project/templates/nodepool/nodepool.yaml.erb in the infra/system-config tree to see a production config.

If the cloud being used has no default_floating_pool defined in nova.conf, you will need to define a pool name using the nodepool yaml file to use floating ips.

Set up database for interactive testing:

mysql -u root

mysql> create database nodepool;
mysql> GRANT ALL ON nodepool.* TO 'nodepool'@'localhost';
mysql> flush privileges;

Set up database for unit tests:

mysql -u root
mysql> grant all privileges on *.* to 'openstack_citest'@'localhost' identified by 'openstack_citest' with grant option;
mysql> flush privileges;
mysql> create database openstack_citest;

Export variable for your ssh key so you can log into the created instances:

export NODEPOOL_SSH_KEY=`cat ~/.ssh/ | awk '{print $2}'`

Start nodepool with a demo config file (copy or edit fake.yaml to contain your data):

export STATSD_PORT=8125
nodepoold -d -c tools/fake.yaml

All logging ends up in stdout.

Use the following tool to check on progress:

nodepool image-list

After each run (the fake nova provider is only in-memory):

mysql> delete from snapshot_image; delete from node;