When Nathan Rijksen created the new Komodo website using docpad,
it allowed for a much more developer friendly way to make changes to the site.
You’d need to have a development environment setup to test your changes locally
but that’s not an issue.. unless you’re like me and work mainly in Windows.
It doesn’t help that I’ve had very little experiences with node.js (which is what
docpad was made width) prior to getting started. I had configured a VM to work
on the website, but doing that each time I switched to a new environment or somehow
nuked my VM seemed silly. Luckily, I had just learned to use Puppet with
Vagrant so I saw a path to easily get things running.
## The Technology
To do this I used 3 pieces of technology:
1. Vagrant deployment utility
2. Puppet orchestration
3. and the VirtualBox Hyper-visor
Using Puppet with Vagrant, it was easy to keep the work separated into two
distinct groups; VM configuration and guest environment configuration. Thankfully all
these technologies play together quite nicely, save for one minor issue that
had me stumped. At some point after Virtualbox version 4.16 was released,
Oracle disabled symlink creation in shared folders. But we’re using Nodejs and
npm soooo, we need symlinks. Thankfully Oracle allowed for this to be enabled
using a VBoxInternal2 setting.
Vagrant was ridiculously easy to use. Their docs get your started in no time.
You can see my vagrant file on github.
I used the Vagrantfile to configure my virtual machine before it starts. I set a
name and small memory footprint for the VM.
Using Puppet to install packages made my life pretty easy. Puppet has a great
resource in the Puppet-Labs open source community. It not only has documentation
but also the puppet forge where you can find and download Puppet
modules for almost any task. You can usually find a branch of each project
on github too. I added the puppet modules I needed as sub-modules to the Komodo-Website
repository to keep things manageable.
Now it’s as easy as pulling the Komodo-website repository and
running ~~~vagrant up~~~ in the repository root and I have a development
environment for the website.
Given that it was 3 tools I was learning, there was a slight learning curve.
But now that it’s setup and I’ve got a basic understanding of how the tools
work, it’s been easy to make changes to the site.
## Issues Resolved
- “bower install” Failing when nothing else was failingPuppet’s not always forthcoming with it’s error output. To figure out an issue with
ko-bower-installclass in development.pp. I ended up appending
the command being run and finally found out that `Puppet` Exec commands are run as
- Symlink errors during
npm installAKA. STUMPED ^^^This either means you didn’t [set the VBox variable to enable Symlinks OR you’re
not running your Windows CMD window (so VBOX implicitly) as Administrator.
If you’re trying to run the Komodo Website; the variable is set in the Vagrantfile
so you’re probably doing the latter.
- default: Error: Connection timeout. Retrying…
You’ll see this while trying to
vagrant up --provisionyour VM. This is usually
only a problem if you’re actively developing your Vagrant/Puppet setup.
Title photo courtesy of Jantine Doornbos on Unsplash.