Currently when the scripts doing the image-building fail, there is nothing of note put into the publicly-available log files (i.e. those published at nodepool.openstack.org). The exception gets raised and goes back to the main log file but doesn't leave anything in the build log file. This means there is no way to effectively monitor the status of a image build externally, other than making guesses about what should be at the end of the last-running script. This provides some standard sentinel values around script running that can be used to quickly verify the success or failure of scripts. Change-Id: I54db78b028017500b58693ec717c23eaf6a220b6
Nodepool
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
Install dependencies:
sudo apt-get update
sudo apt-get -qy install git mysql-server libmysqlclient-dev g++\
python-dev python-pip libffi-dev libssl-dev qemu-utils
mkdir src
cd ~/src
git clone git://git.openstack.org/openstack-infra/system-config
git clone git://git.openstack.org/openstack-infra/nodepool
cd nodepool
sudo pip install -U -r requirements.txt
sudo pip install -e .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.
Set up database for interactive testing:
mysql -u root
mysql> create database nodepool;
mysql> GRANT ALL ON nodepool.* TO 'nodepool'@'localhost';
mysql> flush privileges;Set up database for unit tests:
mysql -u root
mysql> grant all privileges on *.* to 'openstack_citest'@'localhost' identified by 'openstack_citest' with grant option;
mysql> flush privileges;
mysql> create database openstack_citest;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:
After each run (the fake nova provider is only in-memory):