Welcome to Apache Libcloud’s documentation!

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
• - services such as Amazon S3 and Rackspace CloudFiles
• Load Balancers as a Service - services such as Amazon Elastic Load Balancer and GoGrid LoadBalancers
• - services such as Amazon Route 53 and Zerigo
• Container Services - container virtualization like Docker and Rkt as well as container based services
• - services such as Amazon EBS and OpenStack Freezer

A subset of supported providers in Libcloud.

Documentation

• • Installation (stable version)
  • Upgrading
  • Where to go from here?
• • Compute
    • Supported Methods (Base compute)
    • Supported Methods (Key pair management)
  • • Provider Matrix
  • Object Storage
    • Supported Methods (Main)
  • Container
    • Supported Methods
  • • Provider Matrix
  • DNS
    • Supported Methods
• • Compute
• Compute
  • • Compute
    • Block Storage
  • Pricing
  • SSH key pair management
  • API Reference
• • Terminology
  • Examples
• Load Balancer
  • Supported Providers
  • API Reference
• • Terminology
  • Examples
• Container
  • Simple Container Support
  • Bootstrapping Docker with Compute Drivers
  • Examples
  • Utility Classes
• • Terminology
  • Examples
• Troubleshooting
  • • Example 1 - Logging output to standard error
• API Documentation
• • Why are the block storage related management methods located in the compute API?
  • How do I test if provider credentials are valid?
  • I want to add / propose a new API, what should I do?
• Changes in Apache Libcloud v2.0
  • • Allow redirects is enabled by default
  • Adding support for Python 3.6 and deprecation of Python 3.2
  • • Providing a list of CA trusts is no longer supported
  • Changes to the storage API
  • Other minor changes
• SSL Certificate Validation in <v2.0
  • Acquiring CA Certificates
  • Adding additional CA certificate to the path
  • Changing used SSL / TLS version
• • Known limitations
  • • 1. Using / htps_proxy environment variable
    • 3. Calling set_http_proxy method
• Using Libcloud in multi-threaded and async environments
  • Using Libcloud with gevent
• Working with the object oriented APIs
  • Example 2 - creating an EC2 instance with a known and NodeImage id
  • Example 2 - creating an EC2 instance with a known and NodeImage id

• Developer Information
  • Mailing Lists
  • Issue Tracker
  • Continuous Integration
• Development
  • Getting started with contributing to Libcloud
  • Code style guide
  • Code conventions
    • 2. Function and method ordering
    • 4. Don’t abuse **kwargs
    • 6. Prefer to use “is not None” when checking if a variable is provided or defined
  • Contribution workflow
    • 2. Open a new issue on our issue tracker
    • 4. Create a new branch for your changes
    • 6. Write tests for your changes and make sure all the tests pass
    • 8. Open a pull request with your changes
  • Supporting Multiple Python Versions
    • Utility functions for cross-version compatibility

• • New committer guidelines
    • 2. Subscribe to the private mailing list
    • 4. Link your ASF and Github account
  • Making a release (for release managers)
    • 1. Pre-release check list
    • 3. Creating release artifacts
    • 5. Upload the release artifacts and start a [VOTE] thread
    • 7. Publishing package to PyPi
    • 9. Updating doaplibcloud.rdf, \_init__.py
    • 11. Sending announcements
  • • Release voting thread template

• Changelog
  • General
  • Compute
  • Changes in Apache Libcloud 2.6.1
    • Storage
  • Changes in Apache Libcloud 2.6.0
    • Compute
    • DNS
  • • General
    • Compute
    • Container
    • Storage
  • • Common
    • DNS
    • Other
  • • Common
    • Storage
  • • Common
    • Tests
  • • Compute
  • • Common
    • Container
    • Load Balancer
  • Changes in Apache Libcloud 2.1.0
    • Compute
    • Storage
  • • Common
    • DNS
  • • Common
    • Storage
  • • Common
  • Changes in Apache Libcloud 1.5.0
    • Compute
  • Changes in Apache Libcloud 1.4.0
    • Container
    • Storage
  • • General
    • Container
    • Storage
  • • Backup
  • • General
    • Load balancer
    • Container
  • Changes with Apache Libcloud 1.1.0
    • Compute
    • Load Balancer
  • • General
    • Storage
    • DNS
  • • General
    • Storage
    • DNS
  • Changes with Apache Libcloud 1.0.0-pre1
    • Compute
  • Changes with Apache Libcloud 0.20.1
  • Changes with Apache Libcloud 0.20.0
    • Compute
    • Loadbalancer
  • Changes with Apache Libcloud 0.19.0
    • Compute
    • Loadbalancer
  • Changes with Apache Libcloud 0.18.0
    • Compute
    • Loadbalancer
  • Changes with Apache Libcloud 0.17.0
    • Compute
    • Loadbalancer
  • Changes with Apache Libcloud 0.15.1
    • DNS
  • • General
    • Storage
    • DNS
  • • Compute
    • Storage
  • Changes with Apache Libcloud 0.14.0
    • Compute
    • DNS
  • • General
    • Storage
    • DNS
  • • Compute
  • • General
    • Storage
    • DNS
  • • General
    • Storage
  • • General
  • • Compute
    • Load Balancer
  • • Compute
  • Changes with Apache Libcloud 0.12.3
    • Compute
  • Changes with Apache Libcloud 0.12.1
    • Compute
    • DNS
  • Changes with Apache Libcloud 0.11.4
    • Compute
    • DNS
  • • Storage
  • • General
    • Storage
  • Changes with Apache Libcloud 0.11.1
  • Changes with Apache Libcloud 0.11.0
    • DNS
    • Other
  • • General
    • Storage
  • Changes with Apache Libcloud 0.9.1
    • Compute
    • Load-balancer
  • Changes with Apache Libcloud 0.8.0
    • Compute
    • Load-balancer
  • • General
  • • General
    • Load-balancer
  • • General
    • Storage
  • Changes with Apache Libcloud 0.6.1
    • Compute
    • DNS
  • • General
    • Storage
    • DNS
  • • Compute
  • Changes with Apache Libcloud 0.5.0
  • Changes with Apache Libcloud 0.4.0 [Released October 6, 2010]
  • Changes with Apache Libcloud 0.3.0 [Tagged May 6, 2010, not released]
• Upgrade Notes
  • Libcloud 1.0.0
  • Libcloud 0.19.0
  • • Changes in the OpenStack authentication and service catalog classes
  • • Fix record name inconsistencies in the Rackspace DNS driver
  • • Default Content-Type is now provided if none is supplied and none can be guessed
    • New default kernel versions used when creating Linode servers
    • Amazon EC2 compute driver changes
    • CloudStack compute driver changes
    • ElasticHosts compute driver changes
    • CloudFiles Storage driver changes
    • Rackspace load balancer driver changes
    • Pricing data changes
    • Cache busting functionality is now only enabled in Rackspace first-gen driver
    • get_container method changes in the S3 driver
  • Libcloud 0.7
• Security

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