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.
James E. Blair 22b82077d0 Remove prelude from AWS release note 2 months ago
devstack Merge "Support userdata for instances in openstack" 4 months ago
doc Merge "Use a pipeline for dib stats" 3 months ago
etc Merge "Add systemd drop-in file for CentOS 7" 1 year ago
nodepool Merge "docker: don't daemonize when starting images" 2 months ago
playbooks Implement an OpenShift resource provider 4 months ago
releasenotes/notes Remove prelude from AWS release note 2 months ago
roles/nodepool-zuul-functional Remove nodepool-k8s-functional and install-nodepool roles 6 months ago
tools Support userdata for instances in openstack 4 months ago
.coveragerc Switch to stestr 1 year ago
.dockerignore Build images with Dockerfile instead of pbrx 4 months ago
.gitignore Ignore files produced by tox-cover 10 months ago
.gitreview Replace master with feature/zuulv3 1 year ago
.stestr.conf Switch to stestr 1 year ago
.zuul.yaml Stop building an explicit nodepool-base image 4 months ago
Dockerfile docker: don't daemonize when starting images 3 months ago
LICENSE license: remove dos line break 1 year ago
README.rst Switch storyboard url to be by name 9 months ago
TESTING.rst Update README and add TESTING similar to Zuul repo 10 months ago
bindep.txt bindep: add sudo 3 months ago
requirements.txt Merge "Amazon EC2 driver" 3 months ago
setup.cfg Update pypi metadata 7 months ago Bump pbr requirements to >=1.3 3 years ago
test-requirements.txt Amazon EC2 driver 3 months ago
tox.ini Implement an OpenShift resource provider 4 months ago



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/openstack-infra/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.