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 94c42e9377 Switch docs to alabaster theme 1 year ago
devstack Support ubuntu-bionic (18.04) with nodepool dsvm 1 year ago
doc Switch docs to alabaster theme 1 year ago
nodepool Revert "Add support for STATSD_IPV6" 1 year ago
playbooks Refactor playbooks/nodepool-zuul-functional/pre.yaml 1 year ago
roles/nodepool-zuul-functional Refactor playbooks/nodepool-zuul-functional/pre.yaml 1 year ago
tools Merge "Support ubuntu-bionic (18.04) with nodepool dsvm" 1 year ago
.gitignore Add files for zuul-nodepool integration test 2 years ago
.gitreview Replace master with feature/zuulv3 1 year ago
.testr.conf Add a test for subnodes 5 years ago
.zuul.yaml Publish docs to 1 year ago
LICENSE license: remove dos line break 1 year ago
README.rst Rename nodepoold to nodepool-launcher 2 years ago
bindep.txt Ensure only python3 is installed with bindep.txt 1 year ago
requirements.txt requirements: remove paramiko <2.0 cap 1 year ago
setup.cfg update supported python version in setup.cfg 1 year ago Bump pbr requirements to >=1.3 3 years ago
test-requirements.txt Consolidate node_list, add generic filter 1 year ago
tox.ini Update tox docs environment to match build-sphinx-docs 1 year 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:

Install dependencies:

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:

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:

Start nodepool with a demo config file (copy or edit fake.yaml to contain your data):

All logging ends up in stdout.

Use the following tool to check on progress: