A Little Puppet Open Source Ecosystem Using Vagrant, Borrowing from binford2k's puppet-in-a-box
Puppetverse provides a small, virtual Puppet lab you can deploy using VirtualBox and Vagrant. After installing VirtualBox and Vagrant, you can clone this repository,
cd into its directory, and issue the command
vagrant up to set up and provision a working puppet master (
master) and two agents (
It's o.k., but it's also just a few hours' work hacking on someone else's thing to suit my Debianesque proclivities.
You need VirtualBox and Vagrant.
VirtualBox is freely available virtualization software that provides the headless VMs Vagrant provisions. You can download it from https://www.virtualbox.org/wiki/Downloads. Once you have it installed, you won't need to do anything else with it. Vagrant will handle the rest.
Vagrant is an open source tool that allows you to quickly stand up virtual environments and code that closely match production environments. You can download Vagrant from http://downloads.vagrantup.com and follow the installation instructions on the Vagrant site.
You can clone this project with the following command:
git clone git://github.com/pdxmph/puppetverse.git
$ cd puppetverse
$ vagrant up
If you'd prefer to bring up a single agent without the others, pass the agent name(s) as arguments to
vagrant up, e.g.
vagrant up master or
vagrant up master arrakis
If you don't customize anything, the following commands will log you in to each of the nodes:
$ vagrant ssh master
$ vagrant ssh caladan
$ vagrant ssh arrakis
Once you're logged in, passwordless
sudo is available, e.g.
$ vagrant ssh caladan
$ sudo puppet agent -t
Halting vs. Destroying
- Done with your environment, but want to keep your changes and power down your VMs?
$ vagrant halt
- Done with your environment, but want to keep your changes and pause your VMs without having to start them from boot later?
$ vagrant suspend
- Done with your environment, and want to destroy your changes and start fresh?
$ vagrant destroy
Individual nodes can be halted (shut down), suspended (paused), or destroyed (reset to their initial status before you modified them) by entering their names after the
$ vagrant halt arrakis
$ vagrant destroy arrakis
$ vagrant suspend arrakis
Changes to the Puppet Environment
For now, if you decide to change the
site.pp manifest on the
master node, you'll need to reprovision
master for the puppet master running on it to register the change:
$ vagrant provision master
- Adding Hosts: The
Vagrantfileis where you can add/change the nodes Vagrant stands up as agents in
:hostname => IP_ADDRESSpairs.
- Networking: The master is assigned the IP address 192.168.33.10. If you don't like this, or if it conflicts with your network settings, you'll need to change that in a few places:
- Host names: By default, you get
arrakis. You can change the agent names by editing the
- Base Box: The base box is an Ubuntu/Precise VM provided by the Vagrant project. You can change the base box by editing the
- RAM: The master is configured to use 1024MB of RAM, the agents are configured to use 512MB of RAM. Look for
mconfig.vm.customize ["modifyvm", :id, "--memory", 1024]in
Vagrantfileto change this.
A few things you might or might not want to attend to before using:
- puppetverse makes sure it has the Puppet apt repository set up and upon
vagrant upit will make sure it has the very newest version of Puppet Open Source (running an
apt-get updateduring the provisioning phase). If you peek into
/manifests/master.ppand remove the
exec, provisioning will speed up a little, but you'll get Puppet 2.7 (if you keep the default box, which is Ubuntu Precise).
- Make modules dir portable
- Separate the "vagrant provisions" part from the "puppet master stands on its own hind legs" part and put the
/etc/puppettree in a mounted directory so it can be manipulated from outside the VM without having to reprovision.
- Do more with templates so it's easier to fiddle with the network address, host names, etc.
- Make NFS mounts make sense for the bits where all the nodes are spun up and independent of Vagrant's bootstrap/provision sequence.