README

Provis

Infrastructure Provisioning Scripts and Configuration Sets

A Python package with a few tests, system bootstrap scripts, and a Makefile for building and configuring cloud servers with a number of helpful tools:

• Ubuntu Linux
• Packer (Go)
• Vagrant (Ruby)
• Salt (Python)

Installation

• Install build requirements
• Install the Provis Package

Install the Provis Package

Clone and install the package from source:

pip install -e ssh://[email protected]/westurner/provis#egg=provis

Or, clone the repository and manually install:

## clone
git clone ssh://[email protected]/westurner/provis
git clone https://github.com/westurner/provis

cd ./provis

## install
python setup.py develop  # creates a provis.egg-link in site-packages
python setup.py install  # copies the binary dist to site-packages

Install Python requirements:

cd ./provis
pip install -r requirements.txt

Install Build Requirements

Ubuntu 12.04 LTS

Install make, build requirements:

apt-get install make python pip

• Install `make`_:

  apt-get install make
  

• Install `pip`_:

  apt-get install pip
  pip install --upgrade pip
  

• Install virtualenv and virtualenvwrapper (optional):

  pip install virtualenv virtualenvwrapper
  

  Create a virtualenv with virtualenvwrapper (optional):

  mkvirtualenv provis
  workon provis
  

Usage

Tests

Run the Provis Python package tests with the current environment:

## Check localhost
python runtests.py  # python setup.py test

## Check reference set
python runtests.py tests/provis_tests.py

Run the Provis Python package tests with tox and many environments:

tox

Makefile

Install make (if it is not already installed):

sudo apt-get install make

List Makefile command descriptions:

make help
make

#cd ./provis
ls -al

$EDITOR Makefile

Run make with the Makefile:

cd ./provis
make
make help
make setup

License

• Free software: BSD license