A Module for BigV which wraps the BigV CLI
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Python module for BigV

This is an initial attempt at a Python module for BigV, with the eventual idea that this will be incorporated into an Ansible module.

This tool consumes the BigV REST API. The REST API is documented here (and its docs are on Github here), and depends on the python-requests module.


import bigv

act = bigv.BigVAccount(username="alice",password="testing",account="mystuff")
for m in act.machines():
  print "Machine has %d discs" % len(list(m.discs()))
  print m.info()

Usage with Ansible

This repository now contains (possibly buggy) implementations of two Ansible modules, bigv-disc and bigv-vm which are capable of creating new machines and discs. Both modules are idempotent, but note that they will only ever create and delete discs and VMs, and will never edit them.

Spec changes will need to be done manually.

A sample playbook is provided which shows basic usage of the two modules.

Manual Installation Instructions

Since this is very much still in development, installation is a fairly manual process which allows you to pull changes from the git repo directly:

  1. Checkout the repo somewhere
  2. Install the Python module dependencies ('$ pip install -r requirements.txt')
  3. Create a symlink to the bigv/ directory somewhere in the Python Path, you can check it works by running python -c 'import bigv' and making sure it returns 0
  4. Create a library/ directory in the same directory as your Ansible playbook, symlink bigv-disc and bigv-vm into it.