Fix README file
Empty README.rst removed and README was renamed to README.rst Change-Id: I34871727341f67cc344c3928eb08f6081b259621
This commit is contained in:
parent
6020f1db45
commit
533fbca31f
57
README
57
README
|
@ -1,57 +0,0 @@
|
||||||
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 install git mysql-server libmysqlclient-dev g++ python-dev libzmq-dev
|
|
||||||
mkdir src
|
|
||||||
cd ~/src
|
|
||||||
git clone git://git.openstack.org/openstack-infra/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:
|
|
||||||
|
|
||||||
git review -x XXXXX
|
|
||||||
|
|
||||||
If the cloud being used has no default_floating_pool defined in nova.conf,
|
|
||||||
you will need to define a pool name using nodepool.layout to use floating ips.
|
|
||||||
|
|
||||||
Set up database:
|
|
||||||
|
|
||||||
mysql -u root
|
|
||||||
|
|
||||||
mysql> create database nodepool;
|
|
||||||
mysql> GRANT ALL ON nodepool.* TO 'nodepool'@'localhost';
|
|
||||||
mysql> flush privileges;
|
|
||||||
|
|
||||||
Export variable for your ssh key so you can log into the created instances:
|
|
||||||
|
|
||||||
export NODEPOOL_SSH_KEY=`cat ~/.ssh/id_rsa.pub`
|
|
||||||
|
|
||||||
Start nodepool with a demo config file (copy or edit fake.yaml
|
|
||||||
to contain your data):
|
|
||||||
|
|
||||||
export STATSD_HOST=127.0.0.1
|
|
||||||
export STATSD_PORT=8125
|
|
||||||
nodepoold -d -c tools/fake.yaml
|
|
||||||
|
|
||||||
All logging ends up in stdout.
|
|
||||||
|
|
||||||
Use the following tool to check on progress:
|
|
||||||
|
|
||||||
nodepool image-list
|
|
||||||
|
|
||||||
After each run (the fake nova provider is only in-memory):
|
|
||||||
|
|
||||||
mysql> delete from snapshot_image; delete from node;
|
|
57
README.rst
57
README.rst
|
@ -0,0 +1,57 @@
|
||||||
|
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 install git mysql-server libmysqlclient-dev g++ python-dev libzmq-dev
|
||||||
|
mkdir src
|
||||||
|
cd ~/src
|
||||||
|
git clone git://git.openstack.org/openstack-infra/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:
|
||||||
|
|
||||||
|
git review -x XXXXX
|
||||||
|
|
||||||
|
If the cloud being used has no default_floating_pool defined in nova.conf,
|
||||||
|
you will need to define a pool name using nodepool.layout to use floating ips.
|
||||||
|
|
||||||
|
Set up database:
|
||||||
|
|
||||||
|
mysql -u root
|
||||||
|
|
||||||
|
mysql> create database nodepool;
|
||||||
|
mysql> GRANT ALL ON nodepool.* TO 'nodepool'@'localhost';
|
||||||
|
mysql> flush privileges;
|
||||||
|
|
||||||
|
Export variable for your ssh key so you can log into the created instances:
|
||||||
|
|
||||||
|
export NODEPOOL_SSH_KEY=`cat ~/.ssh/id_rsa.pub`
|
||||||
|
|
||||||
|
Start nodepool with a demo config file (copy or edit fake.yaml
|
||||||
|
to contain your data):
|
||||||
|
|
||||||
|
export STATSD_HOST=127.0.0.1
|
||||||
|
export STATSD_PORT=8125
|
||||||
|
nodepoold -d -c tools/fake.yaml
|
||||||
|
|
||||||
|
All logging ends up in stdout.
|
||||||
|
|
||||||
|
Use the following tool to check on progress:
|
||||||
|
|
||||||
|
nodepool image-list
|
||||||
|
|
||||||
|
After each run (the fake nova provider is only in-memory):
|
||||||
|
|
||||||
|
mysql> delete from snapshot_image; delete from node;
|
Loading…
Reference in New Issue