Getting started

Prerequisites

To run Apache LibCloud you will need one of the following versions of Python:

  • 2.6
  • 2.7
  • 3.2
  • 3.3
  • 3.4

You will also need "pip" to install the packages from PyPi. If you are new to Python and you want to get started with the pre-requisites quickly, this is a good guide on installation

Distribution specific packages

Libcloud is also available in standard repositories of many popular Linux distributions.

Ubuntu, Debian (apt)

Package name: python-libcloud
Installation:

 

 

Fedora, RedHat (yum)

Package name: python-libcloud
Installation:

 

 

OpenBSD (ports)

 

 

OS X (MacPorts)

Port name: py-libcloud Installation, if you don't have MacPorts you can download it here https://www.macports.org/install.php 

 

 

Keep in mind that distribution packages may be out of date. If you want to make sure that you are using the latest version, you should install it by downloading the archive from this page or using pip.

PyPi Package

The Python Package Index or PyPI is the official third-party software repository for the Python programming language.

We push all the releases to PyPi so you can also download and install the latest release using pip:

pip install apache-libcloud

Keep in mind that pip install command doesn't verify the package signatures, so if you are worried about that, you should manually download the package and verify the signature using the steps described bellow.

 

Installation (development version)

You can install latest development version from our Git repository:

 

Upgrading

If you used pip to install the library you can also use it to upgrade it:

 

Using it

This section describes a standard work-flow which you follow when working with any of the Libcloud drivers.

  1. Obtain reference to the provider driver

  2. Instantiate the driver with your provider credentials and the Region Codes

 

For more information on which arguments you can pass to your provider driver, see provider-specific documentation and the driver docstrings.

  1. Putting it all together

You can find more examples with common patterns which can help you get started on the Examples page.