Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Create, use and destroy temporary slaves in the cloud

Project Description

I have a number of different applications that need to fire up instances in the cloud to do various things. This module is supposed to be generically useful for that purpose.

What is it?

It’s an incredibly simple way to fire up instances in the cloud with very little effort. It fires up instances of a predefined flavor based on a predefined image.

What is it not?

A generic wrapper around the various OpenStack client libraries. It does one thing and does it well.

How to use it?

First, you configure a cloud:

>>> from cloudslave.models import Cloud
>>> cloud = Cloud(user_name='user_name',
                  region='XX-YY', # <-- Optional
                  flavor_name = 'm1.small',
                  image_name = 'regex that matches the name of the image (first match will be used)')
>>> cloud.slave()

Then create a reservation:

>>> res = cloud.create_reservation(5)  # Starts 5 instances
>>> res.start()
>>> res.update_state()
>>> res.get_state_display()
>>> res.update_state()
>>> res.get_state_display()
>>> [slave.run_cmd('hostname').strip() for slave in res.slave_set.all()]
['cloudslave-nthdnsrn', 'cloudslave-blhhmncq', 'cloudslave-vygfls4t']


Once you’re done with them, terminate the reservation:

>>> res.terminate()

That’s it.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(15.4 kB) Copy SHA256 Hash SHA256
Source None Jun 27, 2013

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting