Metadata-Version: 2.0
Name: plancton
Version: 0.5.2
Summary: An opportunistic distributed computing project based on Docker
Home-page: https://github.com/mconcas/plancton
Author: Matteo Concas
Author-email: matteo.concas@cern.ch
License: GPL
Keywords: HEP Computing
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: docker-py
Requires-Dist: prettytable
Requires-Dist: pyyaml

# Plancton: an opoortunistic computing project based on Docker containers
[![Build Status](https://travis-ci.org/mconcas/plancton.svg?branch=master)](https://travis-ci.org/mconcas/plancton)

Plancton is a lightweight daemon written in Python, with the aim to administer a set of docker containers, regardless
of the application running on top of the service (i.e. inside containers).

To work it requires the [Docker](https://www.docker.com/) engine on the host, and few more python modules (installed via `pip`):
1. [`docker-py`](https://github.com/docker/docker-py) Python module to access the Docker API interface
2. [`prettytable`](https://pypi.python.org/pypi/PrettyTable) to better format Plancton logfile
3. [`pyyaml`](http://pyyaml.org/) to parse Plancton configuration

## Installation
Plancton is installable via pip:

	$ pip install plancton

## Configuration
Plancton needs to be bootstrapped from a configuration, by design cloned from a `git` repository.
As super-user run:

	# plancton-bootstrap <repository-name:branch-tag>

### Dryrun
A dry-run example is available by running:

	# plancton-bootstrap <mconcas/plancton-conf:dryrun>

or:

	# plancton-bootstrap --dryrun

It will run a sample of a Plancton setup relying only on `busybox` pilot containers that will sleep for some time and will auto-terminate after that.


[Credits for the name to G.]


