Forge Home

vkick

Puppet module to create virtual machines defined by code via Kickstart files.

11,829 downloads

9,066 latest version

0.4 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.4.2 (latest)
  • 0.4.1
  • 0.4.0
  • 0.3.0
  • 0.2.0
  • 0.1.1
  • 0.1.0
released Jul 21st 2014

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'tuxomatic-vkick', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add tuxomatic-vkick
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install tuxomatic-vkick --version 0.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

tuxomatic/vkick — version 0.1.0 Jul 21st 2014

Puppet vKick Module

Define KVM virtual machines and the guest's OS setup

  • Combine KVM definition and Kickstart OS setup in a single module declaration.
  • Create multiple virtual machines on a single Puppet node.
  • Can be faster than bootstrapping an image, especially if you want an up to date OS.

Example

You'll find 3 main themes to define a virtual machine: network, partitioning and packages. The simplest definition will only need network settings and will create a basic VM with 2 vcpu, 2GB of RAM and a 40GB disk image.

 vkick::guest { 'instance1.domain.com':
       root_intial_passwd => "5hould8eReplaced"
       ipaddress   => "173.255.197.131",
       subnetmask  => "255.255.255.0",
       broadcast   => "173.255.197.255",
       gateway     => "173.255.197.254",
       nameserver  => "208.67.222.222",
 }

Requirements

  • A working network bridge device defined on the host.
  • An access to the internet for the guest's IP or a local HTTP mirror.
  • A recent version of libvirt/qemu (as shipped with EL 6.x) to support injecting Kickstart definition without local ISO installation image.

Known Limitations

  • Only works on Linux distributions supporting Kickstart files such as RedHat, CentOS, Fedora and Ubuntu (not tested).
  • Requires a guest setup with static IP, ethier public or private if local mirror available.
  • Doesn't create other user accounts than root on a guest.