start linux builder doc
authorMichael Meffie <mmeffie@sinenomine.net>
Fri, 20 Jul 2018 21:20:22 +0000 (17:20 -0400)
committerMichael Meffie <mmeffie@sinenomine.net>
Fri, 20 Jul 2018 21:20:22 +0000 (17:20 -0400)
devel/BuildbotLinuxBuilder.mdwn [new file with mode: 0644]
devel/index.mdwn

diff --git a/devel/BuildbotLinuxBuilder.mdwn b/devel/BuildbotLinuxBuilder.mdwn
new file mode 100644 (file)
index 0000000..8588477
--- /dev/null
@@ -0,0 +1,63 @@
+Bsuildbot linux rc builder for OpenAFS
+=====================================
+
+Changes to the mainline Linux source code frequently requires changes to the
+OpenAFS kernel module code. In order to catch build errors as the Linux and
+OpenAFS code changes, a nightly builder on the OpenAFS buildbot has been
+created to automatically build the various git branches of OpenAFS on the most
+recent Linux kernel release candidate every day.  The builder spins up a
+virtual machine guest, installs the most recent Linux release candidate image
+and headers, reboots the guest, then attempts to build and run OpenAFS on the
+release candidate.
+
+Linux KVM virtualization and `libvirt` commands is used for virtualization.
+The builder downloads pre-build Linux release candidates published by the
+Ubuntu Kernel Team.
+
+The components of this system are:
+
+* A Linux KVM host system (`kvm`, `qemu`, and `libvirt`)
+* An Ubuntu base image to be cloned
+* A script called `kernel-ppa` to find and download the most recent Linux kernels
+  from the Ubuntu Kernel Team's site.
+* A script called `virt-run` to clone the base image, run commands on the clone,
+  then destroy the clone
+* A buildbot worker which is always running
+* The buildbot master configuration
+
+Linux KVM host system
+---------------------
+
+todo
+
+Ubuntu base image
+-----------------
+
+todo
+
+`kernel-ppa`
+------------
+
+todo
+
+`virt-run`
+----------
+
+todo
+
+Buildbot worker
+---------------
+
+todo
+
+Buildbot master configuration
+-----------------------------
+
+todo
+
+
+
+====
+
+https://github.com/meffie/virt-utils.git
+
index d8f277b..f3faf2b 100644 (file)
@@ -4,6 +4,7 @@
 * [[BinaryThirdParty]]
 * [[buildbotmasternotes]]
 * [[buildbot]]
+* [[BuildbotLinuxBuilder]]
 * [[BuildbotSlaveHowto]]
 * [[CodeArchitectureFSYNC]]
 * [[CodeArchitecture]]