Resources

Miscellaneous

• Jenkins Best Practices
• plugins
  • Git plugin
  • Copy Artifact plugin can be used to run a test job against the result of a build job, e.g. for Debian packages (think Lintian) or Tails ISO images; see grml's setup documentation that uses it.
• the jenkins and jenkins-slave JuJu charms may be good sources of inspiration for deployment
• Net-Jenkins (not in Debian) allows to interact with a Jenkins server: create and start jobs, get information about builds etc.

Jobs management

• Job builder provides one-way (Git to Jenkins) jobs synchronization; it's in Debian sid.
  • configuration documentation
  • Debian uses it in their update_jdn.sh: it runs jenkins-jobs update $config after importing updated YAML job config files from Git.
  • Tor use it too.
• jenkins.debian.net uses the SCM Sync plugin, that apparently handles committing to the VCS on configuration changes done in the web interface, and maybe more.
• jenkins-yaml might make it easy to generate a large number of similar Jenkins jobs, e.g. one per branch
• jenkins_jobs puppet module

Web setup

Visible read-only on the web

We'd like our Jenkins instance to be visible read-only on the web. We'd rather not rely on Jenkins authentication / authorization to enforce this read-only policy. We'd rather see the frontend reverse proxy take care of this.

The getUnprotectedRootActions()) method should return the list of URL prefixes that we want to allow. And we could forbid anything else.

The Reverse Proxy Auth Jenkins plugin can be useful to display an example usage of this method.

Miscellaneous

• sample nginx configuration

Notifications

• IRC plugin, but I'm told that the jenkins email notifications are way nicer than what this plugin can do, so see a better way to do it
• Jenkins-NotificationListener is a server that listens to messages from Jenkins Notification plugin.

How others use Jenkins

• jenkins.debian.net's:
  • setup documentation
  • configuration: git://git.debian.org/git/users/holger/jenkins.debian.net.git
• Tor's jobs
• Ubuntu QA Jenkins instance
• grml's Michael Prokop talks about autotesting in KVM during his talk at DebConf 10; they use Jenkins:
  • Jenkins instance
  • unittests
  • debian-glue Jenkins plugin
  • kantan: simple test suite for autotesting using Grml and KVM
  • Jenkins server setup documentation
• jenkinstool has the tools Lars Wirzenius uses to manage his CI (Python projects test suite, Debian packages, importing into reprepro, VM setup of all needed stuff); the whole thing is very ad-hoc but many bits could be used as inspiration sources.

Jenkins for Perl projects

• a collection of links on the Jenkins wiki
• an overview of the available tools: Task::Jenkins
• a tutorial
• another tutorial
• use TAP::Formatter::JUnit (in Wheezy) rather than the Jenkins TAP plugin
• use prove --timer to know how long each test takes