README

About jenkins.debian.net
========================
:Author:           Holger Levsen
:Authorinitials:   holger
:EMail:            holger@layer-acht.org
:Status:           in progress
:lang:             en
:Doctype:          article
:Licence:	   GPLv2

== About jenkins.debian.net

http://jenkins.debian.net is pretty much *work in progress*, (hopefully) doing something useful since October 15th 2012.

`git clone git://git.debian.org/git/users/holger/jenkins.debian.net.git`

Virtual hardware sponsored by http://www.profitbricks.com - currently it's just a server (a nice one, with 4 cores and 6 GB memory, thanks a lot!), but in future there will be installation tests on "real" (virtual) hardware and thus more VMs will started on demand as well.

Some stats are available using link:http://jenkins.debian.net/munin/jenkins-month.html[munin-plugins for jenkins].

=== Feedback

I love to get feedback on this! Please join #debian-qa on irc.debian.org to report bugs or give other feedback! Or send an email to debian-qa@lists.debian.org if you prefer mail.

== Jobs being run

Remember, this is still pretty much work in progress. If you can think of ways to improve the usefulness of certain jobs, please do give feedback!

=== g-i-installation jobs

Installation tests with g-i, the graphical version of d-i, the debian-installer.

FIXME: Describe g-i-installation jobs here

=== chroot-installation jobs

Installation tests inside chroot environments.

* chroot-installation_housekeeping:
** make sure chroots have been cleaned up properly
** runs at 05:00 UTC and triggers the bootstrap jobs on success
* chroot-installation_sid_bootstrap
** debootstrap a sid chroot
** triggers the install_gnome job on success
* chroot-installation_sid_install_gnome
** debootstrap a sid chroot and install gnome
* chroot-installation_sid_install_kde
** debootstrap a sid chroot and install kde
* chroot-installation_sid_install_lxde
** debootstrap a sid chroot and install lxde
* chroot-installation_sid_install_xfce
** debootstrap a sid chroot and install xfce
* chroot-installation_squeeze_bootstrap_upgrade_to_wheezy
** debootstrap a squeeze chroot and upgrade it to wheezy
** triggers the upgrade_(gnome|kde|lxde|xfce) jobs on success
* chroot-installation_squeeze_install_gnome_upgrade_to_wheezy
** debootstrap a squeeze chroot, install gnome and upgrade it to wheezy
* chroot-installation_squeeze_install_kde_upgrade_to_wheezy
** debootstrap a squeeze chroot, install kde and upgrade it to wheezy
* chroot-installation_squeeze_install_lxde_upgrade_to_wheezy
** debootstrap a squeeze chroot, install lxde and upgrade it to wheezy
* chroot-installation_squeeze_install_xfce_upgrade_to_wheezy
** debootstrap a squeeze chroot, install xfce and upgrade it to wheezy
** triggers the install_(gnome|kde|lxde|xfce) jobs on success
* chroot-installation_wheezy_bootstrap
** debootstrap a wheezy chroot
* chroot-installation_wheezy_install_gnome
** debootstrap a wheezy chroot and install gnome
* chroot-installation_wheezy_install_kde
** debootstrap a wheezy chroot and install kde
* chroot-installation_wheezy_install_lxde
** debootstrap a wheezy chroot and install lxde
* chroot-installation_wheezy_install_xfce
** debootstrap a wheezy chroot and install xfce
#FIXME: explain full_desktop and developer here, also make this more useful/interesting

=== debian-installer jobs

* d_i_build_* - there is one job for each git repo referred to in http://anonscm.debian.org/viewvc/d-i/trunk/.mrconfig?view=co
Each job pdebuilds the master branch of its git repo on every git push in a sid environment. (If the architecture(s) specified in debian/control are not amd64,all or any the build exits cleanly.)
** while these jobs are triggered on commits, the SCM is only polled every 6min to see if there are new commits.
* d_i_manual - builds the full installation-guide package with pdebuild in sid on every commit to svn://svn.debian.org/svn/d-i/ matching these patterns: 
'/trunk/manual/debian/.\*', '/trunk/manual/po/.\*', '/trunk/manual/doc/.\*' and '/trunk/manual/scripts/.\*'
** while this job is triggered on commits, the SCM is only polled every 15min to see if there are new commits.
* d_i_manual_*_html - builds a language (on wheezy) on every commit of svn/trunk/manual/$LANG with "make languages=$LANG architectures=amd64 formats=html". On successful build, d_i_manual_$lang_pdf is triggered.
** while these jobs are triggered on commits, the SCM is only polled every 15min to see if there are new commits.
* d_i_parse_build_logs - parses logs from http://d-i.debian.org/daily-images/build-logs.html daily, to give them a bit more exposure.
** this job is run daily.

=== webcheck jobs

* three jobs for running webcheck against www.debian.org, www.debian.org/News and www.debian.org/security
* several webcheck jobs for running again various debconf.org websites

These jobs are only run on the first day of each month.

== Setup

See link:http://jenkins.debian.net/userContent/setup.html[INSTALL].

== ToDo

There is still a lot of work left, check the current link:http://jenkins.debian.net/userContent/todo.html[ToDo list].