Poni is a simple system configuration management tool implemented in Python.
|email:||mika dot eloranta at gmail dot com|
Installing and operating Poni requires:
- Python 2.6 (or greater)
- setuptools installed
- Internet connection for downloading the dependency Python packages from PyPI
Using Amazon EC2 requires setting the following environment variables:
export AWS_ACCESS_KEY_ID=<your aws access key> export AWS_SECRET_ACCESS_KEY=<your aws secret access key>
Additionally, running the included automated tests requires:
Building HTML files from the included ReST documentation requires:
NOTE: during installation the following packages and their dependencies are automatically installed from PyPI:
Installing the following Python libraries will add optional functionality:
- Cheetah (text-based templating language)
- Genshi (XML-based templating language)
- Mako (text-based templating language)
- Paramiko (Remote node control using SSH)
- GitPython (Version controlling the repository with Git)
- Boto (Amazon EC2 virtual machine provisioning)
- pyvsphere (VMWare virtual machine provisioning)
- libvirt-python (libvirt virtual machine provisioning)
- PyDNS (libvirt provisioning dependency)
- lxml (libvirt provisioning dependency)
Poni can be installed from Python Package Index (PyPI) by running pip install poni or easy_install poni.
- Unpack the poni-v.vv.tar.gz package
- cd poni-v.vv/
- python setup.py install
- You should be able to import poni from Python
- The poni command-line tool is installed (to a platform-specific location), try running poni -h for help
- Running automated tests: cd poni-v.vv/ && nosetests
Please refer to the documentation under the doc/ directory (published at http://melor.github.com/poni/) and to the example systems under the examples/ directory.
Thanks for the contributions!
- Oskari Saarenmaa (features)
- Santeri Paavolainen (fixes)
- Lakshmi Vyas (new features for AWS-EC2 support)
- Lauri Heiskanen (enabling pseudo-tty)
- F-Secure Corporation (major improvements, VMWare vSphere and libvirt support)
This package is licensed under the open-source "Apache License, Version 2.0".
The full license text is available in the file LICENSE and at http://www.apache.org/licenses/LICENSE-2.0.txt
Note: poni versions older than 0.6 were licensed under the MIT license.