Manage a pool of nodes for a distributed test infrastructure
Go to file
Zuul 9a03c679e3 Merge "Add systemd drop-in file for CentOS 7" 2018-05-09 18:09:54 +00:00
devstack Use AFS mirrors for debian-stretch testing 2018-04-03 17:24:22 -04:00
doc Add logo to docs 2018-05-04 14:48:28 -07:00
etc Merge "Add systemd drop-in file for CentOS 7" 2018-05-09 18:09:54 +00:00
nodepool Merge "Make manage_images a property of ProviderConfig" 2018-05-09 18:09:53 +00:00
playbooks Refactor playbooks/nodepool-zuul-functional/pre.yaml 2018-02-20 19:56:11 +01:00
releasenotes/notes Remove initial stub release note 2018-05-04 14:44:43 -07:00
roles/nodepool-zuul-functional Refactor playbooks/nodepool-zuul-functional/pre.yaml 2018-02-20 19:56:11 +01:00
tools Reduce strictness of growroot test 2018-04-11 06:51:26 +10:00
.coveragerc Switch to stestr 2018-04-26 11:52:17 -05:00
.gitignore Ignore .stestr directory in .gitignore 2018-05-07 12:37:44 -04:00
.gitreview Replace master with feature/zuulv3 2018-01-18 10:13:57 -08:00
.stestr.conf Switch to stestr 2018-04-26 11:52:17 -05:00
.zuul.yaml Remove LIBS_FROM_GIT 2018-05-09 10:13:15 -05:00
LICENSE license: remove dos line break 2018-01-19 00:30:22 +00:00
README.rst Rename nodepoold to nodepool-launcher 2017-03-29 09:28:33 -04:00
bindep.txt Ensure only python3 is installed with bindep.txt 2018-02-14 12:19:16 -05:00
requirements.txt Remove use of six 2018-05-08 09:50:59 +10:00
setup.cfg update supported python version in setup.cfg 2018-02-02 04:30:06 +00:00 Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
test-requirements.txt Switch to stestr 2018-04-26 11:52:17 -05:00
tox.ini Switch to stestr 2018-04-26 11:52:17 -05: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