Manage a pool of nodes for a distributed test infrastructure
Go to file
Ian Wienand d6ab8ac2cc Require DIB 3.13.0
The important change here relates to mounting /sys as RO in chroots
during build, which signals to things such as udev/systemd that you're
in a container and avoids some packages hanging when they are
installed under docker.

Change-Id: I88ffe04ad3b2f5aa938879126093efa0b1bfc6e3
2021-07-23 14:08:39 +10:00
contrib/statsd_exporter Add statsd_exporter mapping 2019-09-29 09:30:45 +00:00
doc Merge "Azure: update documentation" 2021-06-25 22:08:44 +00:00
etc Merge "Add systemd drop-in file for CentOS 7" 2018-05-09 18:09:54 +00:00
nodepool First ensure ssh connection is valid before scanning keys 2021-07-19 08:58:56 -04:00
playbooks Fix gate for Focal issues 2021-05-19 08:18:24 +10:00
releasenotes/notes Add release note for previous commit 2021-07-19 20:03:32 -04:00
roles/nodepool-zuul-functional Upgrade pip before installing zuul 2021-02-14 09:21:02 +01:00
tools Install podman in container for container-based builds 2021-05-05 10:34:42 +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 Require TLS 2021-02-19 18:42:33 +00: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 Fix gate for Focal issues 2021-05-19 08:18:24 +10:00
bindep.txt Fix gate for Focal issues 2021-05-19 08:18:24 +10:00
Dockerfile Dockerfile: podman -- handle new configuration file 2021-05-11 11:34:50 +10: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
requirements.txt Require DIB 3.13.0 2021-07-23 14:08:39 +10:00
setup.cfg Add python-logstash-async to container images 2021-03-09 13:17:28 -08:00 Bump pbr requirements to >=1.3 2015-09-14 16:19:13 -04:00
test-requirements.txt Azure: switch to Azul 2021-03-08 14:58:31 -08:00
TESTING.rst Add more detail to TESTING.rst 2020-06-09 08:48:43 -07:00
tox.ini Require TLS 2021-02-19 18:42:33 +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.