Welcome to Apache Libcloud’s documentation!

Apache Libcloud is a Python library which hides differences between different cloud provider APIs and allows you to manage different cloud resources through a unified and easy to use API.

Resource you can manage with Libcloud are divided in the following categories:

• Cloud Servers and Block Storage - services such as Amazon EC2 and RackSpace CloudServers
• Cloud Object Storage and CDN - services such as Amazon S3 and Rackspace CloudFiles
• Load Balancers as a Service - services such as Amazon Elastic Load Balancer and GoGrid LoadBalancers
• DNS as a Service - services such as Amazon Route 53 and Zerigo

A subset of supported providers in Libcloud.

Documentation

Main

• Getting Started
  • Installation (stable version)
  • Installation (development version)
  • Upgrading
  • Using it
  • Where to go from here?
• Changelog
• Supported Providers
  • Compute
    • Provider Matrix
    • Supported Methods (Main)
    • Supported Methods (Block Storage)
  • Load Balancer
    • Provider Matrix
    • Supported Methods
  • Object Storage
    • Provider Matrix
    • Supported Methods (Main)
    • Supported Methods (CDN)
  • DNS
    • Provider Matrix
    • Supported Methods
• Compute
  • Terminology
    • Compute
    • Block Storage
  • Supported Providers
  • Pricing
  • Deployment
  • Examples
  • API Reference
• Object Storage
  • Terminology
  • Supported Providers
  • Examples
  • API Reference
• Load Balancer
  • Terminology
  • Supported Providers
  • Examples
  • API Reference
• DNS
  • Terminology
  • Supported Providers
  • Examples
  • API Reference
• Upgrade Notes
  • Libcloud 0.14.0
    • Cache busting functionality is now only enabled in Rackspace first-gen driver
    • New default kernel versions used when creating Linode servers
    • Addition of new “STOPPED” node state
    • Amazon EC2 compute driver changes
    • Rackspace compute driver changes
    • CloudStack compute driver changes
    • Joyent compute driver changes
    • ElasticHosts compute driver changes
    • Unification of extension arguments for security group handling in the EC2 driver
    • CloudFiles Storage driver changes
    • Rackspace DNS driver changes
    • Rackspace load balancer driver changes
    • ScriptDeployment and ScriptFileDeployment constructor now takes args argument
    • Pricing data changes
    • RecordType ENUM value is now a string
  • Libcloud 0.8
  • Libcloud 0.7
  • Libcloud 0.6
• Troubleshooting
  • Debugging
• Frequently Asked Questions (FAQ)
  • Why are the block storage related management methods located in the compute API?
  • What are the extension methods and arguments?
  • How do I test if provider credentials are valid?
  • I want do add a new provider driver what should I do?
  • I want to add / propose a new API, what should I do?
• Registering a third party driver
• SSL Certificate Validation
  • Acquiring CA Certificates
• Using Libcloud in multi-threaded and async environments
  • Libcloud and thread-safety
  • Using Libcloud with gevent
  • Using Libcloud with Twisted
• Working with the object oriented APIs
  • Example 1 - listing records for a zone with a known id
  • Example 2 - creating an EC2 instance with a known NodeSize and NodeImage id
  • Example 1 - listing records for a zone with a known id
  • Example 2 - creating an EC2 instance with a known NodeSize and NodeImage id
  • Example 3 - creating an EC2 instance with an IAM profile

Developer Information

• Developer Information
  • Mailing Lists
  • Issue Tracker
  • Testing
  • Continuous Integration
  • Test Coverage
• Development
  • Contributing
  • Style guide
  • Git pre-commit hook
  • General guidelines
  • Contribution workflow
    • 1. Start a discussion on the mailing list
    • 2. Open a new issue on our issue tracker
    • 3. Fork our Github repository
    • 4. Create a new branch for your changes
    • 5. Make your changes
    • 6. Write tests for your changes and make sure all the tests pass
    • 7. Commit your changes
    • 8. Open a pull request with your changes
    • 9. Wait for the review
    • 10. Attach a final patch with your changes to the corresponding JIRA ticket
    • Note about Github
    • Syncing your git(hub) repository with an official upstream git repository
    • Contributing Bigger Changes
  • Supporting Multiple Python Versions
    • Context Managers
    • Exception Handling
    • Utility functions for cross-version compatibility

Committer Guide

• Committer Guide
  • New committer guidelines
    • 1. Subscribe to the public mailing lists
    • 2. Subscribe to the private mailing list
    • 3. Create PyPi account
  • Applying a patch
  • Making a release (for release managers)
  • Mailing list email templates
    • Release voting thread template
    • Release announcement

Other

• Security
  • Reporting a vulnerability
  • How are vulnerabilities handled?

Note

Unless noted otherwise, all of the examples and code snippters in the documentation are licensed under the Apache 2.0 license.