Manage a pool of nodes for a distributed test infrastructure
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Zuul e881199916
Merge "Refactor NodeLauncher to be generic"
5 years ago
devstack Use AFS mirrors for debian-stretch testing 5 years ago
doc Clarify in doc introduction that OpenStack is not required 5 years ago
etc Add example nodepool-launcher systemd service file 5 years ago
nodepool Merge "Refactor NodeLauncher to be generic" 5 years ago
playbooks Refactor playbooks/nodepool-zuul-functional/pre.yaml 5 years ago
releasenotes/notes Support winrm hosts in static driver 5 years ago
roles/nodepool-zuul-functional Refactor playbooks/nodepool-zuul-functional/pre.yaml 5 years ago
tools Reduce strictness of growroot test 5 years ago
.gitignore Add files for zuul-nodepool integration test 6 years ago
.gitreview Replace master with feature/zuulv3 5 years ago
.testr.conf Add a test for subnodes 9 years ago
.zuul.yaml Add debian-stretch to nodepool-functional-py35-debian-src 5 years ago
LICENSE license: remove dos line break 5 years ago
README.rst Rename nodepoold to nodepool-launcher 6 years ago
bindep.txt Ensure only python3 is installed with bindep.txt 5 years ago
requirements.txt requirements: remove paramiko <2.0 cap 5 years ago
setup.cfg update supported python version in setup.cfg 5 years ago Bump pbr requirements to >=1.3 7 years ago
test-requirements.txt Add reno releasenotes support 5 years ago
tox.ini Update tox docs environment to match build-sphinx-docs 5 years ago



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