Manage a pool of nodes for a distributed test infrastructure
Go to file
David Shrewsbury 7e71dc7481 Harden exception handling around instance deletes
It's possible to leave a ZK node in a locked state if deleting an
instance fails for some reason. This hardens the logic in the cleanup
thread to make sure we always attempt to unlock the node if the delete

We have a similar situation in clearing the allocation of nodes whose
request has disappeared.

Also, s/unallocate/deallocate/

Change-Id: I82d9dcb0f86c3296f2427a315e14fce772f5369a
2017-10-17 08:31:26 -04:00
devstack Add support to test fedora-26 2017-07-12 07:06:45 -04:00
doc Fix nodepool's docs about config-drive 2017-09-03 18:55:25 -05:00
nodepool Harden exception handling around instance deletes 2017-10-17 08:31:26 -04:00
tools Move the fakeprovider module to the fake driver 2017-07-28 11:35:07 +00:00
.gitignore Add files for zuul-nodepool integration test 2017-01-24 09:46:08 -08:00
.gitreview Set default branch to feature/zuulv3 2016-08-18 09:08:23 -07:00
.testr.conf Add a test for subnodes 2014-03-31 09:22:00 -07:00
.zuul.yaml Add zuulv3 jobs for nodepool 2017-07-26 14:11:40 -04:00
LICENSE Add LICENSE file 2015-12-10 12:54:23 -05:00
README.rst Rename nodepoold to nodepool-launcher 2017-03-29 09:28:33 -04:00
bindep.txt Add libffi development headers to bindep 2017-03-21 08:53:12 -04:00
requirements.txt Add boot-from-volume support for nodes 2017-05-30 14:23:24 -04:00
setup.cfg Fix internal doc refs to renamed section 2017-04-05 11:07:03 -07:00 Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
test-requirements.txt Block sphinx 1.6 2017-05-16 16:35:51 -05:00
tox.ini Set base environment as python3 2017-08-28 15:06:35 -04: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

Make sure you have pip installed:

sudo python

Install dependencies:

sudo pip install bindep
sudo apt-get install $(bindep -b nodepool)

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.

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
nodepool-launcher -d -c tools/fake.yaml

All logging ends up in stdout.

Use the following tool to check on progress:

nodepool image-list