README.rst

README

Docs: https://provis.readthedocs.org/en/latest/

Source: git https://github.com/westurner/provis

Source: git ssh://git@github.com/westurner/provis

Issues: https://github.com/westurner/provis/issues

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)

Contents

• Provis
• Installation
  • Install the Provis Package
  • Install Build Requirements
    • Ubuntu 12.04 LTS
• Usage
  • Tests
  • Makefile
• License

Installation

• Install build requirements
• Install the Provis Package

Install the Provis Package

Clone and install the package from source:

pip install -e ssh://git@github.com/westurner/provis#egg=provis

Or, clone the repository and manually install:

## clone
git clone ssh://git@github.com/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