README 6.13 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
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

Holger Levsen's avatar
Holger Levsen committed
13
http://jenkins.debian.net is pretty much *work in progress*, (hopefully) doing something useful since October 15th 2012.
Holger Levsen's avatar
Holger Levsen committed
14
15
16

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

Holger Levsen's avatar
Holger Levsen committed
17
The (virtualized) hardware is sponsored by http://www.profitbricks.com - currently it's using 4 cores and 6 GB memory, thanks a lot!
Holger Levsen's avatar
Holger Levsen committed
18
19

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

21
22
If you notice some jobs has problems and you want to find out why, read <<debug,debug certain jobs>> to learn how to do this locally.

23
24
=== Feedback

Holger Levsen's avatar
Holger Levsen committed
25
I love to get feedback on this! Please send an email to debian-qa@lists.debian.org or just join #debian-qa on irc.debian.org to report bugs or give other feedback there! 
26

27
28
29
30
31
32
33
34
=== 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].

35
36
== Jobs being run

37
38
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!

39
=== g-i-installation jobs
Holger Levsen's avatar
Holger Levsen committed
40

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

Holger Levsen's avatar
update    
Holger Levsen committed
43
44
* 'g-i-installation_debian_sid_daily-rescue'
** boot of rescue system with daily build sid image
45

Holger Levsen's avatar
update    
Holger Levsen committed
46
47
48
49
* 'g-i-installation_debian_sid_daily-lxde' and '-xfce'
** sid installation of XFCE/LXDE desktop with daily build sid image

* 'g-i-installation_debian_wheezy_lxde','-xfce','-kde' and '-gnome'
Holger Levsen's avatar
Holger Levsen committed
50
** wheezy installation of XFCE/LXDE/KDE desktop with weekly build wheezy image
51

Holger Levsen's avatar
update    
Holger Levsen committed
52
53
54
* 'g-i-installation_debian_squeeze_xfce'
** wheezy installation of XFCE desktop with squeeze image

Holger Levsen's avatar
Holger Levsen committed
55
* Debian Edu installation tests of specific profiles and suites:
56
** 'g-i-installation_debian-edu_squeeze-test_standalone'
57
58
59
** 'g-i-installation_debian-edu_squeeze-test_workstation'
** 'g-i-installation_debian-edu_squeeze-test_combi-server'
** 'g-i-installation_debian-edu_wheezy-test_standalone'
60
** 'g-i-installation_debian-edu_wheezy-test_workstation'
61
** 'g-i-installation_debian-edu_wheezy-test_combi-server'
62
63
64

=== debian-installer jobs

Holger Levsen's avatar
Holger Levsen committed
65
* 'd_i_build_$source_package'
Holger Levsen's avatar
Holger Levsen committed
66
67
** 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.)
68
** while these jobs are triggered on commits, the SCM is only polled every 6min to see if there are new commits.
Holger Levsen's avatar
Holger Levsen committed
69

Holger Levsen's avatar
Holger Levsen committed
70
71
* '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 suitable patterns.
72
** while this job is triggered on commits, the SCM is only polled every 15min to see if there are new commits.
Holger Levsen's avatar
Holger Levsen committed
73

Holger Levsen's avatar
Holger Levsen committed
74
* 'd_i_manual_$language_html'
Holger Levsen's avatar
Holger Levsen committed
75
** builds a language (on wheezy) on every commit of svn/trunk/manual/$LANG with `make languages=$LANG architectures=amd64 formats=html`.
76
** while these jobs are triggered on commits, the SCM is only polled every 15min to see if there are new commits.
Holger Levsen's avatar
Holger Levsen committed
77
** on successful build, 'd_i_manual_$lang_pdf' is triggered.
Holger Levsen's avatar
Holger Levsen committed
78

Holger Levsen's avatar
Holger Levsen committed
79
* '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.
80
** this job is run daily.
Holger Levsen's avatar
Holger Levsen committed
81

82
=== chroot-installation jobs
83

84
85
Installation tests inside chroot environments.

Holger Levsen's avatar
Holger Levsen committed
86
* 'chroot-installation_housekeeping':
87
** make sure chroots have been cleaned up properly
88
** runs at 05:00 UTC and triggers the bootstrap jobs on success
89
90
91

* $distro-bootstrap jobs:
** just `debootstrap $distro` (install a base Debian distribution $distro)
Holger Levsen's avatar
Holger Levsen committed
92
93
** there is one job for *sid* and one for *wheezy*: 'chroot-installation_sid_bootstrap' and 'chroot-installation_wheezy_bootstrap'
** plus there is 'chroot-installation_squeeze_bootstrap_upgrade_to_wheezy', which bootstraps *squeeze* and upgrades that to *wheezy*
94
95
96
97
** on successful run of the bootstrap job, six $distro-install(+upgrade) jobs are triggered.

* $distro-install jobs (and $distro-install+upgrade jobs):
** `debootstrap $distro`, install a *$set_of_packages* (and upgrade to *$2nd_distro*)
98
** these $set_of_packages exist: 'gnome', 'kde', 'kde-full', 'lxde', 'xfc', 'full_desktop' (all five desktops plus `vlc evince iceweasel chromium cups build-essential devscripts mplayer wine texlive-full asciidoc vim emacs`) and 'develop'
99
*** install is done with `apt-get install`, except for 'develop' where `apt-get build-dep` is used to install the build dependencies of these packages.
Holger Levsen's avatar
Holger Levsen committed
100

101
102
=== webcheck jobs

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

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

Holger Levsen's avatar
Holger Levsen committed
108
109
110
111
=== self jobs

These are jobs for making sure jenkins.debian.net is running smoothly.

112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
[[debug]]
== Debugging certain jobs

*FIXME*: To debug certain jobs, a jenkins setup is actually not needed. Make this easy and describe here.

*This is work in progress too and is not full done yet!*

Build this source as a debian package and install the jenkins.d.n-debug package and all it's recommends.

=== Debugging g-i-installation jobs

as user run:

----
mkdir workspace ; cd workspace # test-script should check if they are in a directory called workspace and if not, mkdir it and cd into it.
/srv/jenkins/bin/cd_tester.sh 2 squeeze-test-debian-edu-standalone 20 http://ftp.skolelinux.org/cd-squeeze-test-amd64-i386-netinst/debian-edu-amd64-i386-NETINST-1.iso

----
See the *fourth line* on *any* log to find out how to debug any job. Point this out at the end of any log.


TODO: Currently as easy: svn/git using test-scripts need to learn checkout out - currently this is always done by jenkins.

135
== License
136

137
* See link:http://anonscm.debian.org/gitweb/?p=users/holger/jenkins.debian.net.git;a=blob;f=LICENSE[LICENSE].
138