Configuration files and scripts to maintain a CPAN Smoker on OpenBSD
Perl Shell Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
CPAN-Reporter-Smoker-OpenBSD
prefs
utils
vagrant
.gitattributes
.gitignore
LICENSE
README.md
TODO.txt

README.md

cpan-openbsd-smoker

Configuration files and scripts to maintain a CPAN Smoker on OpenBSD

This project includes the following:

  • The CPAN-Reporter-Smoker-OpenBSD distribution.
  • A set of CPAN "distroprefs" files to disable distributions that causes the smoker on OpenBSD to halt.
  • A Vagrant configuration file (Vagrantfile) and corresponding shell scripts for provisioning.
  • A VirtualBox image of OpenBSD, optimized to run a CPAN Smoker (available at Vagrant Cloud).
  • A (experimental) Packer configuration file, used to create the base image to be used with Vagrant.

The Vagrant provisioned VM

The associated VMs (see Vagranfile) with this project are based on Vagrant (and Virtualbox as the provider) with the Smoker pre-configured on OpenBSD. Many aspects of the VM can be customized during the provisioning phase, like:

  • Mirrors to be used (OpenBSD and CPAN).
  • Which perl to compile and use for the smoker. This project uses perlbrew to download perl source code and compiles a interpreter. Currently, all compile options supported by perlbrew can be used.
  • Tests submitter identification.
  • Number of processors in the VM: this correlate directly to the number of users/smokers you want to run in parallel.
  • Keyboard selection.
  • An arbitrary number of users with low privileges to execute the CPAN::Reporter::Smoker application.
  • Using a CPAN mirror: you can declare one already available on your local network, configure one inside the VM or do both! Well, not much useful configuration unless you just want to pre-initialize your VM local CPAN mirror first, then latter change the configuration.
  • The OpenBSD version you want to use (see config.vm.box available values).

The VM will have pre-installed and pre-configured:

  • the metabase-relayd to be executed under vagrant user.
  • a optional local CPAN mirror (implemented with minicpan).
  • related packages installed (like Git, compilers, etc).
  • a running Mysql server, configured to run extended tests of DBD::mysql automatically.
  • shared "distroprefs" files for configuring (e.g. blocking) how distributions should be tested under the smoker.
  • several tools and libraries most used for modules that uses XS.
  • automatic updates for updating OpenBSD packages and the CPAN-Reporter-Smoker-OpenBSD distribution by running the provisioning again (idempotent controls are in place to execute only the necessary).
  • the command line utilities provided by CPAN-Reporter-Smoker-OpenBSD distribution.

Most of the process is documented at here.

Quick start

First clone this repository. Then go to the vagrant directory. You should see the following structure:

.
├── metabase
│   └── copy your metabase.json here
├── scripts
│   ├── basic_setup.sh
│   ├── config_smoker.sh
│   ├── config_user.sh
│   └── vagrant_user.sh
└── Vagrantfile

Once there, you will find the Vagrantfile, where the definitions of the CPAN::Reporter::Smoker VM. You will want to look up for the section named "CONFIGURABLE STEPS". Some options are required, others not. Make sure to read the comments, they are currently the only documentation available.

Besides editing the Vagrantfile, you need to copy your metabase_id.json to the metabase directory (there is even a tip over there ;-) ).

Finally, make sure you are in the same directory where the Vagranfile is located and hit vagrant up.

After provisioning, all users including (including vagrant and root) have the password setup to "vagrant". You might want to change that latter.

On going usage

After initial provisioning, you will want to start your smoker with

vagrant up --provision

This project Vangrafile is prepared to implement idempotent operations, so only the operations below will be repeated:

  • Updates OpenBSD packages.
  • Update your local CPAN mirror
  • Updates CPAN-Reporter-Smoker-OpenBSD distribution (available also at CPAN) for the vagrant and other users.
  • Updates the keyboard configuration based on the Vagrantfile respective option.

Packer

This project is now using Packer to build the base image for Vagrant. Packer allows the setup of the VM and install of OpenBSD automatically.

Although still experimental, you might want to test it. Unfortunately the format of the configuration file for Packer is JSON, which doesn't allow for comments, so documentation is still to be developed.

Lines that you probably want to tweak with are:

  • variables
  • builders

FAQ

Does this works with any "basic" OpenBSD VM?

No. The VM specified in the Vagrantfile contains customizations as documented in here. Besides, this box already has required software installed, which reduces the provisioning time substancially.