73 lines
2.6 KiB
Markdown
73 lines
2.6 KiB
Markdown
|
# Vagrant Buildbot System
|
||
|
|
|
||
|
|
This is the code for the Vagrant buildbot system. [Buildbot](http://buildbot.net)
|
||
|
|
is a continuous integration system that offers an extreme amount
|
||
|
|
of flexibility and power.
|
||
|
|
|
||
|
|
This directory contains a few subdirectories to setup this CI system:
|
||
|
|
|
||
|
|
* `buildbot_config` - This contains the custom Python code to setup the
|
||
|
|
various parts of the buildbot configuration.
|
||
|
|
* `master` - This is mostly auto-generated from Buildbot itself, however
|
||
|
|
the `master.cfg` file is the configuration used on the buildmaster.
|
||
|
|
* `slave`- This is mostly auto-generated from Buildbot, but the
|
||
|
|
`buildbot.tac` contains some custom code in it to connect to the Vagrant
|
||
|
|
buildmaster.
|
||
|
|
|
||
|
|
**NOTE:** One of the dependencies for the Vagrant CI system is currently
|
||
|
|
not public, and as such can't be setup by the general public. This will be
|
||
|
|
fixed in the next couple weeks.
|
||
|
|
|
||
|
|
## Contribute a CI Slave!
|
||
|
|
|
||
|
|
**NOTE:** The slave contribution process is still not completely setup and
|
||
|
|
will be ironed out very soon after the CI system is up and running.
|
||
|
|
|
||
|
|
Vagrant is an open source profit which doesn't have any income from support,
|
||
|
|
services, or otherwise. All Vagrant slave machines are donated by the
|
||
|
|
community. Donating a machine doesn't require anything more than installing
|
||
|
|
and running the slave software. Vagrant is specifically looking for slave
|
||
|
|
machines that provide a diverse set of operating systems and cpu architectures
|
||
|
|
for testing Vagrant.
|
||
|
|
|
||
|
|
## Setting up the Buildmaster
|
||
|
|
|
||
|
|
To set up the buildmaster, clone out this directory somewhere and install
|
||
|
|
the dependencies:
|
||
|
|
|
||
|
|
pip install -r requirements.txt
|
||
|
|
|
||
|
|
Once the dependencies are installed, create a configuration file with the
|
||
|
|
settings you want to use somewhere. The settings available for a master are
|
||
|
|
defined in `buildbot_config/config/master.py`. An example configuration file:
|
||
|
|
|
||
|
|
[master]
|
||
|
|
slaves=foo:password,bar:anotherpassword
|
||
|
|
web_port=8000
|
||
|
|
|
||
|
|
Execute the buildbot using:
|
||
|
|
|
||
|
|
BUILDBOT_CONFIG=/path/to/my/config.cfg buildbot start master/
|
||
|
|
|
||
|
|
## Setting up a Buildslave
|
||
|
|
|
||
|
|
To set up a slave, clone out this directory and install the dependencies:
|
||
|
|
|
||
|
|
pip install -r requirements.txt
|
||
|
|
|
||
|
|
Then, create a configuration file with the slave settings. The settings
|
||
|
|
available for a slave are defined in `buildbot_config/config/slave.py`.
|
||
|
|
An example configuration file:
|
||
|
|
|
||
|
|
[slave]
|
||
|
|
master_host=ci.vagrantup.com
|
||
|
|
master_port=9989
|
||
|
|
name=the-love-machine
|
||
|
|
password=foobarbaz
|
||
|
|
|
||
|
|
Note that the password above will be assigned to you as part of donating
|
||
|
|
any slave machine, since it must be setup on the buildmaster side as well.
|
||
|
|
Once the configuration is done, run the slave:
|
||
|
|
|
||
|
|
BUILDBOT_CONFIG=/path/to/my/config.cfg buildslave start slave/
|