Documentation/Nightly/Developers/Build system/SlicerBot

Overview

Each time a task associated to the wiki, repository or bug tracker is automated by the execution of a script on a machine, the machine user running such script will be identified as SlicerBot.

Type of SlicerBot

Wiki

This SlicerBot user publishes update on the Slicer wiki. The associated wiki account is UpdateBot

Git

This SlicerBot user can commit changes to a defined subset of Slicer repositories. The associated github account is slicerbot and it can commit changes to all repositories associated with the slicerbot-team in Slicer github organization.

As documented on managing deploy keys Github guide, there are multiple approaches to grant a machine access to a repository. We chose the machine user one.

In a nutshell, the steps to configure a git machine user are:

• Generate SSK keys without pass-phrase:

ssh-keygen -t rsa -C "slicerbot@slicer.org"

• Add the generated id_rsa.pub key to the list of SSH keys associated with slicerbot user. Each key *SHOULD* be named slicerbot-<hostname>. For example slicerbot-factory-south-ubuntu

• Setup git username and email:

git config --global user.name "Slicer Bot"
git config --global user.email "slicerbot@slicer.org"

SVN2GitHub synchronization

• See SVN2GitHub

HtmlDoc

Every night Slicer-cpp.tar.gz and SlicerWizard.tar.gz are generated on factory-south-ubuntu and pushed on Kitware public web server:

• http://public.kitware.com/Slicer-cpp.tar.gz
• http://public.kitware.com/SlicerWizard.tar.gz

Then, few times during the day these archives are pulled from http://public.kitware.com/ by love.bwh.harvard.edu to ensure the content served by these URLs is updated:

• http://slicer.org/doc/html/
• http://slicer.org/doc/SlicerWizard/

Packages

These bots can upload packages on http://slicer.kitware.com/midas3

Applications

The group with "write" permission on the NA-MIC/Public/Slicer/Packages/Applications/ folder is Slicer App Packages Uploader

Bots currently associated with this group are:

• Slicerbot Kitware
• Slicerbot Perklab

Organization of packages listed on https://download.slicer.org is specified on https://github.com/mhalle/slicer4-download

Extensions

Extensions are organized in three different folders:

• NA-MIC/Public/Slicer/Packages/Extensions/Nightly
• NA-MIC/Public/Slicer/Packages/Extensions/Continuous
• NA-MIC/Public/Slicer/Packages/Extensions/Experimental

Currently, any user associated with the Experimental Uploader group as "write" permission to these folders.

In additional to users who requested to be added to the Experimental Uploaded group, the following bots are included:

• Slicerbot Kitware
• Slicerbot Perklab

Note: The concept of channels is being discussed (See #2334). By default, only extension associated with the "official" would be listed in the extensions manager. User will have the option to select other channels.

SlicerBots

As of 2014-12-23, the machines with SlicerBot accounts are:

• factory
• factory-south-ubuntu
• factory-south-win7