Trac

Trac is in ~buildbot/trac-buildbot

• Trac git plugin is under /usr/lib/python2.5/site-packages
  • This is still installed, but mostly disabled. It recognizes SHA1's and links them to github, although it colors them as if they're broken links. Oh well.
• Trac github plugin is, too - it's installed with 'python setup.py install' as directed in  http://github.com/davglass/github-trac

Backups

Backups of trac-buildbot are performed four times daily. buildbot.net admins should do git clone buildbot@buildbot.net:buildbot-trac-backup and pull frequently to provide redundant copies. Remember to keep the contents private: there might be trac passwords inside.

NOTE: this should be done better - perhaps with Amanda and Amazon S3.

Documentation

Buildbot's documentation, http://buildbot.net/buildbot/docs, is a combination of two parts

Static / Historical Documentation

The static "menu" pages and documentation for released versions of Buildbot are in the 'bbdocs' repository - see  http://github.com/buildbot/bbdocs. There is a clone of this repository at /home/buildbot/html/buildbot where you can 'git pull' as necessary. This data is all managed manually - new versions are added by hand and committed, and there is no automatic 'pull' going on on buildbot.net.

Note that there is a Python script, add-tracking.py, in the root of this branch. Run that script, feeding it the names of all of the HTML files, to add the Google Analytics bug so that we can track use of the documentation.

Latest Documentation

At every commit, the MetaBuildbot overwrites /home/buildbot/html/buildbot/docs/latest with the latest generated texinfo and API docs. See the MetaBuildbotConfig for details about how this happens.

The "latest" documentation currently does not get tracked by analytics.

MetaBuildbot

See MetaBuildbotConfig.

Log

• (?)08-May-2009: CoolCold? installed ngnix to cache non-logged-in users, and brought the load average down significantly
• (?)12-May-2009: Dustin noticed similar effects to  http://trac-hacks.org/ticket/3675 and applied  http://trac-hacks.org/attachment/ticket/3675/gitplugin.fix.patch
  • seems to have worked
• 01-Jul-2009 (warner): set up Git-based backup of buildbot.net trac
• 04-Jul-2009: Changed the nav config to point to the new buildbot (in /home/buildbot/trac-buildbot/conf/trac.ini)
• 04-Jul-2009: Dustin installed a buildbot on buildbot.net
• 31-Jul-2009: Dustin added a link to API docs generated by Thomas Vander Stichele
• 03-Jan-2010: Dustin freed up some disk space, installed logrotate, and installed the accountmanager trac plugin ( http://trac-hacks.org/wiki/AccountManagerPlugin); also set up /etc/crontab to blow away old buildmaster logs
• 03-Jan-2010: Dustin upgraded the buildmaster to 0.7.12rc1
• 16-Jan-2010: Dustin installed the github-trac plugin ( http://github.com/davglass/github-trac)
• 24-Jan-2010: Dustin edited the config for the metabuildbot receive-hook (in /etc/event.d/github_buildbot to point to /home/buildbot/github-buildbot-post-receive, then restarted it)
• 31-Jan-2010: On Nicolas's advice, added proxy_buffering off to the metabbot nginx config to enable streaming of logfiles
• 03-Feb-2010: Dustin removed /home/buildbot/apidocs and changed links to point to  http://djmitche.github.com/buildbot/docs/current/reference/. buildbot.net/apidocs is now a redirect to that URL (via nginx)
• 25-Feb-2010: Dustin, with help from verm__, switched to using a web form for authentication to try to limit the spam.
• 25-May-2010: Dustin installed  SpamFilter, but it doesn't seem to do anything.
• 27-May-2010: Dustin installed KeywordSuggestPlugin, which helps a lot, and reorganized the Development section.