From 8bdfcc1400b91932da631fd9194323a570e0a0d6 Mon Sep 17 00:00:00 2001 From: Holger Levsen Date: Sat, 17 Nov 2012 11:19:22 +0100 Subject: update documentation, split d-i views into three --- INSTALL | 33 ++++++++++++++++++++++++++++++++- README | 15 +++++++++------ TODO | 14 ++++++++++++-- job-cfg/d-i.yaml | 8 ++++---- 4 files changed, 57 insertions(+), 13 deletions(-) diff --git a/INSTALL b/INSTALL index 8f79b6ac..81789353 100644 --- a/INSTALL +++ b/INSTALL @@ -17,7 +17,34 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. === Installed software that makes jenkins.debian.net run * jenkins.debian.net runs Debian wheezy. -* FIXME: describe how jenkins is installed + configured, basically put 'deb http://pkg.jenkins-ci.org/debian-stable binary/' into '/etc/apt/sources.list.d/jenkins.list' and `apt-get update` + +=== Jenkins + +* Currently running the long term support .deb from jenkins-ci.org. +* Jenkins is installed using 'deb http://pkg.jenkins-ci.org/debian-stable binary/' into '/etc/apt/sources.list.d/jenkins.list' and `apt-get update && apt-get install jenkins`. +* I would prefer to run a jenkins package from wheezy-backports. + +==== Jenkins plugins + +* Jenkins Subversion Plug-in +* SCM Sync Configuration Plugin +* Static Analysis Utilities +* Dependency Graph Viewer Plugin +* Nested View Plugin +* Locale plugin +* HTML Publisher plugin +* Jenkins GIT plugin +* View Job Filters +* Read-only configurations +* Sidebar Link +* Green Balls +* Log Parser Plugin +* Jenkins Translation Assistance plugin +* Compact Columns +* Simple Theme Plugin + +=== updating jenkins.debian.net with update_jdn.sh + * needed packages are listed in 'update_jdn.sh' and which will also make sure they are installed ** 'update_jdn.sh' is available in the git repo * package configuration is kept in that git repo and deployed by 'update_jdn.sh' as well. @@ -32,3 +59,7 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. * then run `cd /srv/jenkins/job-cfg ; jenkins-jobs update .` to update jobs * testing: `cd /srv/jenkins/job-cfg ; rm test-output/ -r ; mkdir test-output ; jenkins-jobs test . -o test-output/ ; ls test-output/` + +=== munin + +link://munin-monitoring[Munin] is installed, running with link:http://jenkins.debian.net/munin/[jenkins plugins] not yet published elsewhere. diff --git a/README b/README index 40744f3d..6e6f2a20 100644 --- a/README +++ b/README @@ -13,24 +13,27 @@ About jenkins.debian.net * http://jenkins.debian.net is pretty much work in progress, (hopefully) doing something useful since October 15th 2012. * Join #debian-qa on irc.debian.org to report bugs or give other feedback! Use debian-qa@lists.debian.org if you prefer mail. * '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, but in future there will be installation and tests clients started on demand as well. +* (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 and tests clients started on demand as well. * some stats are available at http://jenkins.debian.net/munin/jenkins-month.html == Jobs being run === chroot-tests jobs -* FIXME: describe them +* FIXME: describe chroot-tests jobs === debian-installer jobs -* FIXME: describe them -** d-i_manual: -** d-i_build: +* 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. +* 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/.*' +* d_i_manual_* - builds a language (on wheezy) on every commit of svn/trunk/manual/$LANG with "make languages=$LANG architectures=amd64 formats=html" +* 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. === webcheck jobs -* FIXME: describe them +* FIXME: describe webcheck jobs ** webcheck debian.org websites ** webcheck debconf.org websites diff --git a/TODO b/TODO index 912ad634..af74a897 100644 --- a/TODO +++ b/TODO @@ -14,6 +14,11 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. == General ToDo +* general housekeeping job: +** run calamaris, visitors etc +** check for stale processes +** check for apt-upgrades +** check for jobs forgetting their triggers * describe jobs in README * support for gitweb in jobs ** needs clean merge of my patches to jenkins-job-builder first... @@ -27,6 +32,7 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. * mail notifications (to where?) * proper backup (=daily), see bottom of this document for what to backup * proper git repo url, outside users/holger +** same for /srv/jenkins.debian.net-scm-sync.git * only trigger (=really run) jobs if available+used packages have changed (save packages in db and compare) * update jdk @@ -34,6 +40,9 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. === Tests for supporting d-i development: +* try http://www.os-autoinst.org/ +* html_publisher doesn't make the results of d-i_manual_* available +* svn:trunk:packages/po/* triggers nothing * notify debian-boot@l.d.o and #debian-boot about jenkins jobs results * run scripts/digress/ * bubulle wrote: "Another interesting target would be d-i builds *including non uploaded packages* (something like "d-i from git repositories" images). That would in some way require to create a quite specific image, with all udebs (while netboot only has udebs needed before one gets a working network setup). @@ -42,6 +51,7 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. === Test cd-images: * start client VMs using the profitbricks API: https://www.profitbricks.com/us/media/docs/PB_PublicAPI_EN.pdf (and dhcp) +** or probably just run kvm... * to test (at first) weekly images of amd64 std,kde,lxde+xfce weekly and the first sid-di daily ** http://cdimage.debian.org/cdimage/weekly-builds/amd64/jigdo-cd/ ** http://cdimage.debian.org/cdimage/daily-builds/sid_d-i/20121020-1/amd64/ @@ -49,7 +59,7 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. === Test tasks: -* test installations with (at least) more language tasks enabled +* test installations with (at least) more language tasks enabled, though tasksel doesn't work like this: ---- how do i install a task outside d-i? @@ -58,7 +68,7 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian. h01ger: http://packages.debian.org/source/sid/tasksel ---- -(FIXME: tasksel doesn't work like this) +Help explaining how to test tasks (ie all the language tasks) very much welcome! === Tests using autopkgtest diff --git a/job-cfg/d-i.yaml b/job-cfg/d-i.yaml index 0319ea5a..66a685a2 100644 --- a/job-cfg/d-i.yaml +++ b/job-cfg/d-i.yaml @@ -12,7 +12,7 @@ text: About jenkins.debian.net icon: /userContent/images/debian-swirl-24x24.png - sidebar: - url: http://jenkins.debian.net/view/debian-installer/ + url: http://jenkins.debian.net/view/d-i_misc/ text: All debian-installer jobs icon: /userContent/images/debian-jenkins-24x24.png - sidebar: @@ -34,7 +34,7 @@ text: About jenkins.debian.net icon: /userContent/images/debian-swirl-24x24.png - sidebar: - url: http://jenkins.debian.net/view/debian-installer/ + url: http://jenkins.debian.net/view/d-i_manual/ text: All debian-installer jobs icon: /userContent/images/debian-jenkins-24x24.png - sidebar: @@ -84,7 +84,7 @@ text: About jenkins.debian.net icon: /userContent/images/debian-swirl-24x24.png - sidebar: - url: http://jenkins.debian.net/view/debian-installer/ + url: http://jenkins.debian.net/view/d-i_packages/ text: All debian-installer jobs icon: /userContent/images/debian-jenkins-24x24.png - sidebar: @@ -135,7 +135,7 @@ - job-template: defaults: d-i name: '{name}_parse_build_logs' - description: 'Parses d-i build logs daily. {do_not_edit}' + description: 'Parses d-i build logs from http://d-i.debian.org/daily-images/build-logs.htmldaily. {do_not_edit}' builders: - shell: '/srv/jenkins/bin/d-i_parse_logs.sh http://d-i.debian.org/daily-images/build-logs.html' triggers: -- cgit v1.2.3-70-g09d2