smartdc 0.1.8

Joyent SmartDataCenter CloudAPI connector using http-signature authentication via Requests

Connect with Joyent’s SmartDataCenter CloudAPI via Python, using secure http-signature signed requests.

This is a third-party effort.

This module currently supports:

• Secure connections (via py-http-signature and ssh-agent, when available)

• Key management

• Browsing and access of datacenters, datasets (OS distributions/VM bundles), and packages (machine sizes and resources)

• Machine listing, search, creation, management (start/stop/reboot/resize/delete), snapshotting, metadata, and tags

• Installing boot scripts on machines

It attempts to provide Pythonic objects (for Data Centers, Machines and Snapshots) and convenience methods only when appropriate, and otherwise deals with string identifiers or dicts as lightweight objects.

Requirements

• requests

• py-http-signature

• PyCrypto (required by py-http-signature)

• ssh (used by py-http-signature for its ssh-agent integration)

We assume that json is present because requests now requires py2.6 and up.

Python SmartDataCenter Links

• Python Smart Data Center Tutorial

• smartdc in PyPI

• http_signature in PyPI

• py-smartdc at GitHub

• py-http-signature at GitHub

• py-smartdc Documentation & API reference

• Joyent CloudAPI Documentation

Installation

pip install smartdc

Quickstart

from smartdc import DataCenter

sdc = DataCenter(location='us-sw-1', key_id='/test/keys/test_key')

sdc.datasets()

sm = sdc.create_machine(name='test', dataset='sdc:sdc:smartosplus:',
      package='Small 1GB')

sm.poll_until('running')

import urllib2

urllib2.urlopen('http://' + sm.public_ips[0]).headers.dict

sm.stop()

sm.poll_until('stopped')

sm.delete()

Why?

A colleague and I wanted something Pythonic to fit into our preferred toolchain, and the easiest approach was to build it myself. Requests made some aspects stupidly easy, which is why I created the dependency for the first version. The colleague wanted integration with ssh-agent, and using ssh was the easiest path to that.

Authors

Adam T. Lindsay

License

MIT

Changes

0.1.8 (2012-05-02)

• Bug fix: double-json encoding on add_key got in way of proper upload

• Introduce python-versioneer to hopefully make version management more palatable

0.1.7 (2012-05-01)

• Renamed metadata_dict and tag_dict parameters to metadata and tags

• POST data as JSON, rather than encoded in URL

• Added boot_script option on machine creation

• Process and expose credentials

• Slight tutorial and other documentation cleanup

• Local filtering on datasets and packages

0.1.6 (2012-04-30)

• Fixed release issues (README)

• Moved long tutorial out of the README

• Integrated with ssh-agent changes in http_signature