Project description

The main attraction is make_provisioner, which creates an image
bootstrapping script: given a directory and a script within, it generates a
single-file, self-extracting archive that unpacks the directory on the guest
and runs the configured script.

It’s designed for convenient use as a Packer shell provisioner, or a layer in
a Dockerfile.

There’s another script, fedora2ova, which converts a (possibly
xz-compressed) Fedora Cloud raw disk image into a VirtualBox OVA using the
VBoxManage tool.

Dependencies

The host requires Python 2.7 or Python 3.3.4 and runs on any OS.

Note that Python 2 support has been added to the original project, so that OS
X and some Linux users won’t have to install Python 3 to get things running.

make_provisioner has no further dependencies.

fedora2ova requires the Fedora Cloud raw image, xorriso, and
VirtualBox management tools (VBoxManage). It must run on a host that
supports running Fedora as a VirtualBox guest in order for the guest’s
cloud-config to perform the configuration.

On OS X, xorriso is available via homebrew, and the VirtualBox
management tools are usually installed with VirtualBox itself.

Guest OS Support

The launch script generated by make_provisioner is intended to run on
any Linux or BSD distro, and any other guest with a POSIX /bin/sh.
Please open an issue on github if it does not.

Quick Start Guide

This repo is installable through the standard setup.py (or wheel) method,
or it can be run in-place using python -m from the root of the project.

For instance, to run an installedmake_provisioner:

$ make_provisioner --help

To run the same command from the directory containing this README file:

$ python -m make_provisioner --help

The help documents and the bundled provisioner.ini are most likely to be the
authoritative, up-to-date documentation.

Official Distributions

License

MIT.

Changes from Fedora-Pack 0.7

As noted in the description, this version uses Python 2.7 or Python 3.3.4+
instead of Perl to do all the work.

Distros and Versions are gone

Much of what the provisioner used to do has been removed in this version.
We do not pre-install any dependencies; since the script can be
system-specific, it can install its own dependencies and launch a stage 3
script if it wants. And now, make_provisioner works as-is on many more
systems and versions, since it knows very little about them.

Cautionary note for Windows hosts

Your stage2 script may fail to start with ‘no such file or directory’ or
possibly ‘bad interpreter’ if you accidentally save it with CRLF line-endings.
In vim, be sure to use :set ff=unix to change the fileformat.

Byzantine command-line replaced with config file

cloud-maker’s make_provisioner uses a configuration file instead of
specifying everything on the command-line. It’s in the DOS/INI format that
Python’s configparser reads. So you’ll write a config like
provisioner.ini, defining at least one system (one machine or machine
image) as a section, then use that section name to launch the command: