85884775947c2f25c38b6afc5789c76a1decca04
[openafs-wiki.git] / devel / BuildbotLinuxBuilder.mdwn
1 Bsuildbot linux rc builder for OpenAFS
2 =====================================
3
4 Changes to the mainline Linux source code frequently requires changes to the
5 OpenAFS kernel module code. In order to catch build errors as the Linux and
6 OpenAFS code changes, a nightly builder on the OpenAFS buildbot has been
7 created to automatically build the various git branches of OpenAFS on the most
8 recent Linux kernel release candidate every day.  The builder spins up a
9 virtual machine guest, installs the most recent Linux release candidate image
10 and headers, reboots the guest, then attempts to build and run OpenAFS on the
11 release candidate.
12
13 Linux KVM virtualization and `libvirt` commands is used for virtualization.
14 The builder downloads pre-build Linux release candidates published by the
15 Ubuntu Kernel Team.
16
17 The components of this system are:
18
19 * A Linux KVM host system (`kvm`, `qemu`, and `libvirt`)
20 * An Ubuntu base image to be cloned
21 * A script called `kernel-ppa` to find and download the most recent Linux kernels
22   from the Ubuntu Kernel Team's site.
23 * A script called `virt-run` to clone the base image, run commands on the clone,
24   then destroy the clone
25 * A buildbot worker which is always running
26 * The buildbot master configuration
27
28 Linux KVM host system
29 ---------------------
30
31 todo
32
33 Ubuntu base image
34 -----------------
35
36 todo
37
38 `kernel-ppa`
39 ------------
40
41 todo
42
43 `virt-run`
44 ----------
45
46 todo
47
48 Buildbot worker
49 ---------------
50
51 todo
52
53 Buildbot master configuration
54 -----------------------------
55
56 todo
57
58
59
60 ====
61
62 https://github.com/meffie/virt-utils.git
63