Buildbot/Updating Configs

I was describing how to update buildbot configurations in an e-mail and figured it should probably go on the wiki. This is my (bhearsum's) workflow when updating a Buildbot master's configuration files.

1. Checkout config directory from CVS. These live in mozilla/tools/buildbot-configs. (ie. cvs co -d tryserver mozilla/tools/buildbot-configs/tryserver)
2. Modify the config files to suit your purposes.
3. Make a copy of your working directory, copy checkconfig.py (mozilla/tools/buildbot/contrib/checkconfig.py) to it, and run 'python checkconfig.py master.cfg'. If it does not return 0, there is something wrong with your configs.
4. Create a patch and have somebody review it.
5. Check new configs into CVS.
6. Apply the patch to the buildmaster's directory. Do a 'buildbot reconfig .' to make it pick up the changes.
   • WARNING: Some changes will disrupt running builders. If you make changes that can affect production slaves you should wait until an appropriate time (middle of the night, weekend, tree closure) to do a 'buildbot reconfig'. Use your judgement here.
7. Watch the Buildbot waterfall page. You should see a 'config updated' box for all of the builders. Continue watching this page for a bit to make sure nothing goes crazy.