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
James E. Blair 6fc61ab201
Format multi-line log entries
2 years ago
contrib/statsd_exporter Add statsd_exporter mapping 4 years ago
doc Merge "Changed informations provided in openshiftpods driver" 2 years ago
etc Merge "Add systemd drop-in file for CentOS 7" 5 years ago
nodepool Format multi-line log entries 2 years ago
playbooks Stop using fedora-30 3 years ago
releasenotes/notes Format multi-line log entries 2 years ago
roles/nodepool-zuul-functional nodepool-zuul-functional: switch to editable install 3 years ago
tools Use rax.dfw mirror for arm64 wheels 3 years ago
.coveragerc Switch to stestr 5 years ago
.dockerignore Build images with Dockerfile instead of pbrx 4 years ago
.gitignore Ignore files produced by tox-cover 5 years ago
.gitreview OpenDev Migration Patch 4 years ago
.stestr.conf Switch to stestr 5 years ago
.zuul.yaml nodepool-functional-k8s: don't run on Xenial 2 years ago
Dockerfile Dockerfile: add xz-utils 3 years ago
LICENSE license: remove dos line break 5 years ago
README.rst Update devstack settings and docs for opendev 4 years ago
TESTING.rst Add more detail to TESTING.rst 3 years ago
bindep.txt Stop using fedora-30 3 years ago
requirements.txt Require diskimage-builder 3.6.0 2 years ago
setup.cfg Add yappi and objgraph to an extra 3 years ago Bump pbr requirements to >=1.3 8 years ago
test-requirements.txt Stop using hacking for anything 3 years ago
tox.ini Merge "Declare support for Python3.8" 3 years 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/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.