Manage a pool of nodes for a distributed test infrastructure
Go to file
James E. Blair 1845788a95 Add more detail to TESTING.rst
Add additional sections to the testing instructions; these are based
on the same sections in the Zuul repo.  This brings the nodepool repo
to parity.

Change-Id: I7a1b2c62963a815a1ab864e3685be1653e5734fc
2020-06-09 08:48:43 -07:00
contrib/statsd_exporter Add statsd_exporter mapping 2019-09-29 09:30:45 +00:00
doc Merge "Allow disabling build-log-retention" 2020-05-12 20:59:37 +00:00
etc Merge "Add systemd drop-in file for CentOS 7" 2018-05-09 18:09:54 +00:00
nodepool Merge "openshiftpods: define ca_crt parameter if available" 2020-05-18 12:14:53 +00:00
playbooks container functional test : allow to specify elements-dir 2020-04-30 11:45:38 +10:00
releasenotes/notes Merge "Allow disabling build-log-retention" 2020-05-12 20:59:37 +00:00
roles/nodepool-zuul-functional nodepool-zuul-functional: switch to editable install 2020-03-25 09:50:17 +11:00
tools Dockerfile: use local openstack-ci-core PPA key 2020-04-30 17:32:02 +10:00
.coveragerc Switch to stestr 2018-04-26 11:52:17 -05:00
.dockerignore Build images with Dockerfile instead of pbrx 2019-01-24 16:11:12 +00:00
.gitignore Ignore files produced by tox-cover 2018-07-23 13:44:06 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:25:31 +00:00
.stestr.conf Switch to stestr 2018-04-26 11:52:17 -05:00
.zuul.yaml Merge "container functional test : allow to specify elements-dir" 2020-05-13 19:09:48 +00:00
Dockerfile Merge "Dockerfile: use local openstack-ci-core PPA key" 2020-05-07 21:24:17 +00:00
LICENSE license: remove dos line break 2018-01-19 00:30:22 +00:00
README.rst Update devstack settings and docs for opendev 2019-04-23 13:03:21 +00:00
TESTING.rst Add more detail to TESTING.rst 2020-06-09 08:48:43 -07:00
bindep.txt Add libc6-dev to bindep 2020-03-26 09:08:14 -05:00
requirements.txt Update dib to 2.36.0 2020-04-28 10:31:38 +10:00
setup.cfg Add yappi and objgraph to an extra 2020-04-16 10:02:01 -05:00 Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
test-requirements.txt Stop using hacking for anything 2020-03-12 15:03:03 -05:00
tox.ini Merge "Declare support for Python3.8" 2020-03-17 23:38:03 +00:00



Nodepool is a system for managing test node resources. It supports launching single-use test nodes from cloud providers as well as managing access to pre-defined pre-existing nodes. Nodepool is part of a suite of tools that form a comprehensive test system, including Zuul.

The latest documentation for Nodepool is published at:

The latest documentation for Zuul is published at:

Getting Help

There are two Zuul-related mailing lists:


A low-traffic announcement-only list to which every Zuul operator or power-user should subscribe.


General discussion about Zuul, including questions about how to use it, and future development.

You will also find Zuul developers in the #zuul channel on Freenode IRC.


To browse the latest code, see: To clone the latest code, use git clone

Bugs are handled at:!/project/zuul/nodepool

Code reviews are handled by gerrit at

After creating a Gerrit account, use git review to submit patches. Example:

# Do your commits
$ git review
# Enter your username if prompted

Join #zuul on Freenode to discuss development or usage.


Nodepool is free software, licensed under the Apache License, version 2.0.

Python Version Support

Nodepool requires Python 3. It does not support Python 2.