salt.modules.butterkvm¶

Specialized routines used by the butter cloud component

salt.modules.butterkvm.create(instance, vda, image, pin)¶

Create a virtual machine, this is part of the butter vm system and assumes that the files prepared by butter are available via shared storage. AKA - don't call this from the command line!

instance : string

The path to the instance directory for the given vm on shared storage

vda

The location where the virtual machine image needs to be placed

image

The image to move into place

pin

A "pin" data structure defining the myriad of possible vdb-vbz disk images to generate

CLI Example:

salt '*' butterkvm.create <instance dir> <root image location>\
    <Destination> <pin data>

salt.modules.butterkvm.full_butter_data(local_path)¶

Return the full virt info, but add butter data!

CLI Example:

salt '*' buttervm.full_butter_data <image_path>

salt.modules.butterkvm.libvirt_creds()¶

Returns the user and group that the disk images should be owned by

CLI Example:

salt '*' butterkvm.libvirt_creds

salt.modules.butterkvm.local_images(local_path)¶

return the virtual machine names for all of the images located in the butter cloud's local_path in a list:

['vm1.boo.com', 'vm2.foo.com']

CLI Example:

salt '*' buttervm.local_images <image_path>