Added: libcloud/site/trunk/source/getting-started.md URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/getting-started.md?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/getting-started.md (added) +++ libcloud/site/trunk/source/getting-started.md Tue Dec 31 02:10:00 2013 @@ -0,0 +1,111 @@ +--- +layout: page_with_sidebar +title: Getting Started +description: Get up and running with Libcloud in just a couple of minutes +--- + +# {{ page.title }} + +This page contains short instructions on how to get up and running with +Libcloud in just a couple of minutes. + +For more in-depth instructions and examples, please refer to the +[documentation][8]. + +<a name="installation-stable" id="installation-stable"><h2 class="anchor">Installation (stable version)</h2></a> + +Libcloud is available on [PyPi][2]. You can install latest stable version using +pip: + +{% highlight bash %} +pip install apache-libcloud +{% endhighlight %} + +<a name="installation-dev" id="installation-dev"><h2 class="anchor">Installation (development version)</h2></a> + +If you feel adventurous and want the latest and greatest, you can install latest +development version from our Git repository: + +{% highlight bash %} +pip install -e https://git-wip-us.apache.org/repos/asf/libcloud.git@trunk#egg=apache-libcloud +{% endhighlight %} + +Keep in mind that trunk is usually under heavy development and can contain +backward incompatible changes. You should only use it if you know what you are +doing. + +<a name="using-it" id="using-it"><h2 class="anchor">Using it</h2></a> + +This section describes a standard work-flow which you follow when working +with Libcloud drivers. + +Code snippet bellow use compute API as an example, but exactly the same +work-flow is followed also when working with other APIs. + +1.. Obtain reference to the provider driver + +{% highlight python %} +from pprint import pprint + +from libcloud.compute.types import Provider +from libcloud.compute.providers import get_driver + +cls = get_driver(Provider.RACKSPACE) +{% endhighlight %} + +2.. Instantiate the driver with your provider credentials + +{% highlight python %} +driver = cls('my username', 'my api key') +{% endhighlight %} + +Keep in mind that some drivers take additional arguments such as ``region`` +and ``api_version``. + +For more information on which arguments you can pass to your provider driver, +see provider-specific documentation and the driver docstrings. + +3.. Start using the driver + +{% highlight python %} +pprint(driver.list_sizes()) +pprint(driver.list_nodes()) +{% endhighlight %} + +4.. Putting it all together + +{% highlight python %} +from pprint import pprint + +from libcloud.compute.types import Provider +from libcloud.compute.providers import get_driver + +cls = get_driver(Provider.RACKSPACE) +driver = cls('my username', 'my api key') + +pprint(driver.list_sizes()) +pprint(driver.list_nodes()) +{% endhighlight %} + +<a name="where-to-go-from-here" id="where-to-go-from-here"><h2 class="anchor">Where to go from here?</h2></a> + +The best thing to do after understanding the basic driver work-flow is to visit +the documentation chapter for the API you are interested in ([Compute][4], +[Object Storage][5], [Load Balance][6], [DNS][7]). Chapter for each API +explains some basic terminology and things you need to know to make an +effective use of that API. + +After you have a good grasp of those basic concepts, you are encouraged to +check the documentation for the provider you are interested in (if available) +and usage examples. If the driver specific documentation for the provider +you are interested in is not available yet, you are encouraged to check +docstrings for that driver. + +[1]: {{ page.url }} +[2]: http://pypi.python.org/pypi/apache-libcloud +[3]: https://libcloud.readthedocs.org/en/latest/getting_started.html#using-it +[4]: https://libcloud.readthedocs.org/en/latest/compute/index.html +[5]: https://libcloud.readthedocs.org/en/latest/storage/index.html +[6]: https://libcloud.readthedocs.org/en/latest/loadbalancer/index.html +[7]: https://libcloud.readthedocs.org/en/latest/dns/index.html +[8]: https://libcloud.readthedocs.org/en/latest/index.html
Added: libcloud/site/trunk/source/gsoc-2012.md URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/gsoc-2012.md?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/gsoc-2012.md (added) +++ libcloud/site/trunk/source/gsoc-2012.md Tue Dec 31 02:10:00 2013 @@ -0,0 +1,79 @@ +--- +layout: page +title: Google Summer of Code 2012 +--- + +# {{ page.title }} + +Google Summer of Code is a program where Google sponsors students from around +the world to spend their summer working on open-source projects. Student is +paid 5000$ if they successfully complete all of their evaluations. More +information about the program can be found on the [project website][5]. + +<a href="http://google-melange.appspot.com/gsoc/homepage/google/gsoc2012"; target="_blank"> +<img src="/images/gsoc/gsoc2012.png" class="img-responsive inline center" /></a> + +## Accepted Projects + +### Libcloud REST + +HTTP interface for Libcloud (http://libcloud.apache.org/) which exposes +all the Libcloud functionality through a RESTful API. Currently Libcloud +has a big limitation - you can only use it with Python. Adding a REST +interface would allow users to leverage Libcloud functionality through an +arbitrary language which knows how to talk HTTP. + +**Mentor**: Tomaz Muraus +**Student**: Ilgiz Islamgulov +**Strategic plan**: [click][4] + +Project progress can be tracked on [Github][3] and weekly updates are sent to +the mailing list. + +## Project Ideas + +Some of the existing project ideas proposed by Libcloud developers can be found +on our [ticket tracker][6]. Students are also more than welcome to propose +their own ideas. + +## Available Mentors + +* Tomaz Muraus (tomaz) - UTC -8 +* Roman Bogorodsky (rbogorodskiy) - UTC +4 +* Jed Smith (jed) - UTC -8 + +## Student Applications + +Application template can be found in the section bellow. Before submitting +your application please start a discussion about the project idea on our +mailing list ([email protected]). + +## Student Application Template + +* Name and surname +* E-mail address +* Blog / homepage (if you have one) +* IRC nick and network +* Google+ handle / Skype handle +* Name of school/ university, country, year, your average grade (and describe what this grade means) +* Age +* Which languages do you actively speak (and write)? +* Project / proposal title +* Project / proposal description +* Project / proposal schedule. How long will the project take? When can you begin work? +* Availability. How many hours per week can you spend working on this? What other obligations do you have this summer? +* Deliverables. It is very important to list quantifiable results here, for example: + * Improve X modules in ways Y and Z. + * Write 3 new documentation pages for the new interfaces. + * Improve test coverage by writing X more unit/regression tests. + * Improve performance in FOO by X%. +* How do you plan to continue with your project / proposal and within the Apache Libcloud community after GSoC? +* Benefits to the Free Software Community, who would gain from your project? +* Biography and Free Software experiences. Who are you? What makes you the best person to work on this project/proposal? What free and/or open source projects have you participated in? Please describe your contributions with references. + +[1]: {{ page.url }} +[2]: http://google-melange.appspot.com/ +[3]: https://github.com/islamgulov/libcloud.rest +[4]: https://docs.google.com/document/d/1P9fIxILn-WdgpkXDPydHB_dghGs-BYuoSmkFwh0Y36w +[5]: http://google-melange.appspot.com/gsoc/homepage/google/gsoc2012 +[6]: http://s.apache.org/lcgsoc2012tasks Added: libcloud/site/trunk/source/gsoc.md URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/gsoc.md?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/gsoc.md (added) +++ libcloud/site/trunk/source/gsoc.md Tue Dec 31 02:10:00 2013 @@ -0,0 +1,26 @@ +--- +layout: page +title: Google Summer of Code +--- + +# {{ page.title }} + +Google Summer of Code is a program where Google sponsors students from around +the world to spend their summer working on open-source projects. Student is +paid 5000$ if they successfully complete all of their evaluations. More +information about the program can be found on the [project website][2]. + +## Currently active Google Summer of Code Program + +Currently there is no active GSoC program or we aren't participating in it. + +## Archive + +Here is a list of links to the archive pages of Google Summer of Code programs +we have participated in the past: + +* [Google Sumer of Code 2012][3] + +[1]: {{ page.url }} +[2]: http://google-melange.appspot.com/ +[3]: /gsoc-2012.html Added: libcloud/site/trunk/source/images/apple-touch-icon.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/apple-touch-icon.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/apple-touch-icon.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/favicon.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/favicon.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/favicon.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/gsoc/gsoc2012.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/gsoc/gsoc2012.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/gsoc/gsoc2012.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/libcloud_logo.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/libcloud_logo.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/libcloud_logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/media/libcloud-logo-with-text-large-thumb.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/media/libcloud-logo-with-text-large-thumb.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/media/libcloud-logo-with-text-large-thumb.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/media/libcloud-logo-with-text-large.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/media/libcloud-logo-with-text-large.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/media/libcloud-logo-with-text-large.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/media/libcloud-logo-with-text-medium.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/media/libcloud-logo-with-text-medium.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/media/libcloud-logo-with-text-medium.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/media/libcloud-logo-without-text-large-thumb.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/media/libcloud-logo-without-text-large-thumb.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/media/libcloud-logo-without-text-large-thumb.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/media/libcloud-logo-without-text-large.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/media/libcloud-logo-without-text-large.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/media/libcloud-logo-without-text-large.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/posts/tbd/preview.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/posts/tbd/preview.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/posts/tbd/preview.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/aws.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/aws.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/aws.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/cloudstack.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/cloudstack.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/cloudstack.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/digitalocean.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/digitalocean.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/digitalocean.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/eucalyptus.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/eucalyptus.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/eucalyptus.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/exoscale.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/exoscale.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/exoscale.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/gce.jpg URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/gce.jpg?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/gce.jpg ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/gce.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/gce.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/gce.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/joyent.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/joyent.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/joyent.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/linode.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/linode.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/linode.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/nephoscale.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/nephoscale.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/nephoscale.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/openstack.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/openstack.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/openstack.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/rackspace.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/rackspace.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/rackspace.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/vmware.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/vmware.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/vmware.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/provider-logos/zerigo.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/provider-logos/zerigo.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/provider-logos/zerigo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/social-icons/github.jpg URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/social-icons/github.jpg?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/social-icons/github.jpg ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/social-icons/google+.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/social-icons/google%2B.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/social-icons/google+.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/social-icons/ohloh.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/social-icons/ohloh.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/social-icons/ohloh.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/social-icons/sourcegraph.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/social-icons/sourcegraph.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/social-icons/sourcegraph.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/social-icons/twitter.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/social-icons/twitter.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/social-icons/twitter.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/whois-using/cloudcontrol.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/whois-using/cloudcontrol.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/whois-using/cloudcontrol.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/whois-using/divvycloud.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/whois-using/divvycloud.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/whois-using/divvycloud.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/whois-using/mistio.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/whois-using/mistio.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/whois-using/mistio.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/whois-using/rackspace.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/whois-using/rackspace.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/whois-using/rackspace.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/whois-using/saltstack.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/whois-using/saltstack.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/whois-using/saltstack.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/images/whois-using/scalr.png URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/images/whois-using/scalr.png?rev=1554351&view=auto ============================================================================== Binary file - no diff available. Propchange: libcloud/site/trunk/source/images/whois-using/scalr.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: libcloud/site/trunk/source/index.html URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/index.html?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/index.html (added) +++ libcloud/site/trunk/source/index.html Tue Dec 31 02:10:00 2013 @@ -0,0 +1,175 @@ +--- +layout: default +title: Apache Libcloud is a standard Python library that abstracts away differences among multiple cloud provider APIs +description: Apache Libcloud is a Python library that abstracts away differences among multiple cloud provider APIs +--- +<div class="row section"> + <div class="col-lg-12"> + <div class="main-content text-center"> + <h1>One Interface To Rule Them All</h1> + <h2 class="tagline">Apache Libcloud is Python library that abstracts away differences among multiple cloud provider APIs. </h2> + + <p>Supports <a href="https://libcloud.readthedocs.org/en/latest/supported_providers.html"; target="_blank">more than 30</a> providers such as</p> + + <div id="carousel-provider-logos" class="carousel slide" data-ride="carousel" data-interval="3500"> + <!-- Wrapper for slides --> + <div class="carousel-inner"> + <div class="item active"> + <a href="https://libcloud.readthedocs.org/en/latest/compute/drivers/rackspace.html"; target="_blank"> + <img src="/images/provider-logos/rackspace.png" class="provider-logo" /></a> + <a href="https://libcloud.readthedocs.org/en/latest/compute/drivers/ec2.html"; target="_blank"> + <img src="/images/provider-logos/aws.png" class="provider-logo" /></a> + <a href="https://libcloud.readthedocs.org/en/latest/compute/drivers/cloudstack.html"; target="_blank"> + <img src="/images/provider-logos/cloudstack.png" class="provider-logo" /></a> + </div> + <div class="item"> + <a href="https://libcloud.readthedocs.org/en/latest/compute/drivers/openstack.html"; target="_blank"> + <img src="/images/provider-logos/openstack.png" class="provider-logo" /></a> + <img src="/images/provider-logos/digitalocean.png" class="provider-logo" /> + <img src="/images/provider-logos/eucalyptus.png" class="provider-logo" /> + </div> + <div class="item"> + <img src="/images/provider-logos/joyent.png" class="provider-logo" /> + <img src="/images/provider-logos/linode.png" class="provider-logo" /> + <a href="https://libcloud.readthedocs.org/en/latest/compute/drivers/exoscale.html"; target="_blank"> + <img src="/images/provider-logos/exoscale.png" class="provider-logo" /></a> + </div> + <div class="item"> + <img src="/images/provider-logos/nephoscale.png" class="provider-logo" /> + <img src="/images/provider-logos/gce.png" class="provider-logo" /> + <img src="/images/provider-logos/zerigo.png" class="provider-logo" /> + </div> + </div> + + <!-- Controls --> + <a class="left carousel-control" href="#carousel-provider-logos" data-slide="prev"> + <span class="glyphicon glyphicon-chevron-left"></span> + </a> + <a class="right carousel-control" href="#carousel-provider-logos" data-slide="next"> + <span class="glyphicon glyphicon-chevron-right"></span> + </a> + </div> + </div> + + <div class="row section row-2"> + <div class="col-md-6"> + <h3>Installation</h3> + <p>Latest stable version: <a href="https://pypi.python.org/pypi/apache-libcloud/0.13.2"; target="_blank">0.13.2</a></p> + <p><code>pip install apache-libcloud</code></p> + <p>Or <a href="downloads.html">download it from our servers</a> and install it manually.</p> + </div> + + <div class="col-md-6"> + <h3>Features</h3> + <ul> + <li>Avoid vendor lock-in</li> + <li>Use the same API to talk to many different providers</li> + <li>More than <a href="https://libcloud.readthedocs.org/en/latest/supported_providers.html";> + 30 supported providers</a> total</li> + <li>Four main APIs: + <a href="https://libcloud.readthedocs.org/en/latest/compute/index.html";>Compute</a>, + <a href="https://libcloud.readthedocs.org/en/latest/storage/index.html";>Storage</a>, + <a href="https://libcloud.readthedocs.org/en/latest/loadbalancer/index.html";>Load Balancers</a>, + <a href="https://libcloud.readthedocs.org/en/latest/dns/index.html";>DNS</a></li> + <li>Supports <a href="/about.html#supported-python-versions">Python 2.5, Python 2.6, Python 2.7, PyPy + and Python 3</a></li> + </ul> + </div> + + </div> + + <div class="row section row-3"> + <div class="col-md-6"> + <h3>Compute Example - Create a node</h3> + {% highlight python %} +from libcloud.compute.types import Provider +from libcloud.compute.providers import get_driver + +cls = get_driver(Provider.RACKSPACE) +driver = cls('username', 'api key', region='iad') + +sizes = driver.list_sizes() +images = driver.list_images() + +size = [s for s in sizes if s.id == 'performance1-1'][0] +image = [i for i in images if 'Ubuntu 12.04' in i.name][0] + +node = driver.create_node(name='libcloud', size=size, image=image) +print(node) +{% endhighlight %} + <p>For more compute examples, see <a href="https://libcloud.readthedocs.org/en/latest/compute/examples.html";>documentation</a>.</p> + </div> + + <div class="col-md-6"> + <h3>DNS Example - Create a DNS record</h3> + {% highlight python %} +from libcloud.dns.types import Provider, RecordType +from libcloud.dns.providers import get_driver + +cls = get_driver(Provider.ZERIGO) +driver = cls('email', 'api key') + +zones = driver.list_zones() +zone = [zone for zone in zones if zone.domain == 'mydomain.com'][0] + +record = zone.create_record(name='www', type=RecordType.A, data='127.0.0.1') +print(record) +{% endhighlight %} + <p>For more DNS examples, see <a href="https://libcloud.readthedocs.org/en/latest/dns/examples.html";>documentation</a>.</p> + </div> + </div> + + <div class="row section row-4"> + + <div class="col-md-4"> + <h3>Latest Blog Posts</h3> + {% for post in site.posts limit:4 %} + {% unless post.exclude_from_index %} + <p><a href="{{ post.url }}">{{ post.title }}</a> + {% endunless %} + {% endfor %} + + <p>You can also subscribe and stay up to date using our + <a href="/blog/atom.xml">RSS / Atom feed.</a></p> + </div> + + <div class="col-md-4"> + <h3>Whois using Libcloud?</h3> + + <div class="whos-using text-center"> + <a href="http://www.saltstack.com/community/"; alt="SaltStack" title="SaltStack - Central system and configuration manager" rel="tooltip" "target="_blank"><img src="/images/whois-using/saltstack.png" class="logo" /></a> + <a href="https://www.cloudcontrol.com"; alt="CloudControl" title="cloudControl - Rock-solid European Platform as a Service" rel="tooltip" target="_blank"><img src="/images/whois-using/cloudcontrol.png" class="logo" /></a> + <a href="https://mist.io"; alt="mist.io" title="mist.io - Cloud management in your pocket" rel="tooltip" target="_blank"><img src="/images/whois-using/mistio.png" class="logo" /></a> + </div> + + <div class="whos-using text-center"> + <a href="http://www.scalr.com"; alt="Scalr" title="Scalr - Enterprise Cloud Management Platform" rel="tooltip" target="_blank"><img src="/images/whois-using/scalr.png" class="logo" /></a> + <a href="http://www.rackspace.com"; alt="Rackspace" title="Rackspace - The Open Cloud Company" rel="tooltip" target="_blank"><img src="/images/whois-using/rackspace.png" class="logo" /></a> + <a href="http://www.divvycloud.com/"; alt="DivvyCloud" title="DivvyCloud - Hybrid Cloud Management" rel="tooltip" target="_blank"><img src="/images/whois-using/divvycloud.png" class="logo" /></a> + </div> + + <p>See <a href="/whois-using.html">more projects and companies</a> using Libcloud.</p> + </div> + + <!--<div class="col-md-4"> + <h3>Need Help?</h3> + </div>--> + + <div class="col-md-4"> + <h3>Get in Touch, Follow Us</h3> + + <p>Users mailing list: <a href="mailto:[email protected]";>[email protected]</a></p> + <p>Developers mailing list: <a href="mailto:[email protected]";>[email protected]</a></p> + <p>IRC channel: <a href="https://kiwiirc.com/client/irc.freenode.net/libcloud";>#libcloud on Freenode</a></p> + + <div style="margin-top: 20px"> + <a href="https://github.com/apache/libcloud"; title="Libcloud on Github" rel="tooltip" target="_blank"><img src="/images/social-icons/github.jpg" title="Libcloud on Github" alt="Libcloud on Github" class="social-icon" /></a> + <a href="https://plus.google.com/100590055818889164025"; title="Libcloud on Google+" rel="tooltip" target="_blank" title="test"><img src="/images/social-icons/google+.png" alt="Libcloud on Google+" class="social-icon" /></a> + <a href="https://twitter.com/libcloud"; title="Libcloud on Twitter" rel="tooltip" target="_blank"><img src="/images/social-icons/twitter.png" alt="Libcloud on Twitter" class="social-icon" /></a> + <a href="https://www.ohloh.net/p/libcloud/"; title="Libcloud on Ohloh" rel="tooltip" target="_blank"><img src="/images/social-icons/ohloh.png" alt="Libcloud on Ohloh" class="social-icon" /></a> + <a href="https://sourcegraph.com/github.com/apache/libcloud"; title="Libcloud on SourceGraph" rel="tooltip" target="_blank"><img src="/images/social-icons/sourcegraph.png" alt="Libcloud on SourceGraph" class="social-icon" /></a> + </div> + </div> + </div> + </div> +</div> Added: libcloud/site/trunk/source/media.md URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/media.md?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/media.md (added) +++ libcloud/site/trunk/source/media.md Tue Dec 31 02:10:00 2013 @@ -0,0 +1,42 @@ +--- +layout: page +title: Media +--- + +# {{ page.title }} + +This page contains images and project logo files you can use if you want to +link to our website. + +For more information on how you are allowed to use those images (besides +linking to our website), please refer to the [Apache Trademark Policy][2]. + +To save bandwidth, we ask you to download those images and serve them from +your servers instead of directly linking to the files on our servers. + +## Large logo with text + +**Dimensions**: 800x800px +**Format**: Raster (.png) +**URL**: [{{ site.url }}/images/media/libcloud-logo-with-text-large.png][4] +**Preview**: + +<a href="/images/media/libcloud-logo-with-text-large.png"> + <img src="/images/media/libcloud-logo-with-text-large-thumb.png" /> +</a> + +## Large logo without text + +**Dimensions**: 500x306px +**Format**: Raster (.png) +**URL**: [{{ site.url }}/images/media/libcloud-logo-without-text-large.png][3] +**Preview**: + +<a href="/images/media/libcloud-logo-without-text-large.png"> + <img src="/images/media/libcloud-logo-without-text-large-thumb.png" /> +</a> + +[1]: {{ page.title }} +[2]: http://www.apache.org/foundation/marks/ +[3]: {{ site.url }}/images/media/libcloud_logo_without_text_large.png +[4]: {{ site.url }}/images/media/libcloud_logo_with_text_large.png Added: libcloud/site/trunk/source/robots.txt URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/robots.txt?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/robots.txt (added) +++ libcloud/site/trunk/source/robots.txt Tue Dec 31 02:10:00 2013 @@ -0,0 +1 @@ +Sitemap: http://libcloud.apache.org/sitemap.xml Added: libcloud/site/trunk/source/security.md URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/security.md?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/security.md (added) +++ libcloud/site/trunk/source/security.md Tue Dec 31 02:10:00 2013 @@ -0,0 +1,84 @@ +--- +layout: page_with_sidebar +title: Security +description: See a list of known vulnerabilities which have been fixed and find information on how to report a new vulnerability +--- + +# {{ page.title }} + +<a name="security-vulnerabilities" id="security-vulnerabilities"><h2 class="anchor">Security Vulnerabilities</h2></a> + +<a name="CVE-2012-3446"><h3 class="anchor">[CVE-2012-3446] Possible SSL MITM due to invalid regular expression used to validate the target server hostname</h3></a> + +**Severity**: Medium +**Affected Versions**: Apache Libcloud 0.4.2 to 0.11.1 (version prior to 0.4.2 +don't preform any target SSL certificate validation) +**Description**: + +When establishing a secure (SSL / TLS) connection to a target server an +invalid regular expression has been used for performing the hostname +verification. Subset instead of the full target server hostname has been +marked as an acceptable match for the given hostname. + +For example, certificate with a hostname field of `aexample.com` was considered +a valid certificate for domain `example.com`. + +**Mitigation**: + +This vulnerability has been fixed in version 0.11.1 so all the users should +upgrade to version 0.11.1 or higher. + +**Credits**: + +This issue was discovered by researchers from the University of Texas at Austin +(Martin Georgiev, Suman Jana and Vitaly Shmatikov). + +<a name="CVE-2010-4340"><h3 class="anchor">[CVE-2010-4340] SSL MITM vulnerability</h3></a> + +**Severity**: Medium +**Affected versions**: All the versions prior to **0.4.2** +**Description**: + +Python SSL library doesn't validate a host SSL certificate and as a +consequence, versions prior to **0.4.2** are vulnerable to a man-in-the-middle +attack. + +**Mitigation**: + +This vulnerability has been fixed in the version 0.4.2. You are strongly +encouraged to upgrade to this version and set +`libcloud.security.VERIFY_SSL_CERT` variable to `True`. + +<a name="reporting-a-vulnerability" id="reporting-a-vulnerability"><h2 class="anchor">Reporting a Vulnerability</h2></a> + +<div class="alert alert-info">Please do <strong>not</strong> report security +issues using our public JIRA instance. Use the private mailing list +described bellow.</div> + +If you believe you found a security issue or a vulnerability, please send a +description of it to our private mailing list at +[[email protected]][3]. + +You are also encouraged to encrypt this email using PGP. Keys of our developers +can be found at [https://www.apache.org/dist/libcloud/KEYS][4]. + +Once you've submitted an issue, you should receive an acknowledgment from one +our of team members in 48 hours or less. If further action is necessary, you +may receive additional follow-up emails. + +<a name="how-are-vulnerabilities-handled" id="how-are-vulnerabilities-handled"><h2 class="anchor">How are vulnerabilities handled?</h2></a> + +We follow a standard Apache Software Foundation vulnerability handling process +which is described at +[http://www.apache.org/security/committers.html#vulnerability-handling][5]. + +<a name="errors-and-omissions" id="errors-and-omissions"><h2 class="anchor">Errors and Omissions</h2></a> + +Please report any errors or omissions to +<a href="mailto:[email protected]";>[email protected]</a>. + +[1]: {{ page.url }} +[2]: https://libcloud.readthedocs.org/en/latest/security.html#reporting-a-vulnerability +[3]: mailto:[email protected] +[4]: https://www.apache.org/dist/libcloud/KEYS +[5]: http://www.apache.org/security/committers.html#vulnerability-handling Added: libcloud/site/trunk/source/whois-using.md URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/whois-using.md?rev=1554351&view=auto ============================================================================== --- libcloud/site/trunk/source/whois-using.md (added) +++ libcloud/site/trunk/source/whois-using.md Tue Dec 31 02:10:00 2013 @@ -0,0 +1,168 @@ +--- +layout: page +title: Who's Using Libcloud? +description: See which companies, organizations and projects are using Libcloud and learn from their usage. +--- + +# {{ page.title }} + +This page includes a non-exhaustive list of projects, companies and +organizations which are using Libcloud. + +## Projects + +**Name:** mist.io +**Website:** [https://github.com/mistio/mist.io](https://github.com/mistio/mist.io) +**Description:** Mist.io is an open source software and a hosted service that +helps you manage and monitor your servers across several cloud from any web +device. + +**Name:** Dewpoint +**Website:** [https://github.com/secondstory/dewpoint](https://github.com/secondstory/dewpoint) +**Description:** A command line tool for cloud computing. + +**Name:** felicity +**Website:** [https://github.com/mig5/felicity](https://github.com/mig5/felicity) +**Description:** A Python script for performing backups to different clouds. + +**Name:** Frigg +**Website:** [https://github.com/mig5/frigg](https://github.com/mig5/frigg) +**Description:** Script for provisioning a server and installing +[Aegir](http://aegirproject.org/) on it. + +**Name:** fusefs-cloudstorage +**Website:** [https://github.com/novel/fusefs-cloudstorage](https://github.com/novel/fusefs-cloudstorage) +**Description:** FUSE-based filesystem for accessing cloud storage such as +Rackspace CloudFiles and Amazon S3. + +**Name:** Kraftwerk +**Website:** [https://github.com/jokull/kraftwerk](https://github.com/jokull/kraftwerk) +**Description:** Command line utility that enables easier deployment and commissioning of cloud servers. + +**Name:** lc-tools +**Website:** [http://novel.github.com/lc-tools/](http://novel.github.com/lc-tools/) +**Description:** A set of command line tools for controlling various clouds. + +**Name:** OOI Cyberinfrastructure +**Website:** [http://ci.oceanobservatories.org/](http://ci.oceanobservatories.org/) +**Description:** Interfacing with a wide variety of software packages and computational resource providers. + +**Name:** overmind +**Website:** [https://github.com/tobami/overmind](https://github.com/tobami/overmind) +**Description:** A complete server provisioning and configuration management application. + +**Name:** rackspace-monitoring +**Website:** [https://github.com/racker/rackspace-monitoring](https://github.com/racker/rackspace-monitoring) +**Description:** Library for Rackspace Cloud Monitoring API built on the libcloud framework. + +**Name:** rocket +**Website:** [https://github.com/ssimasanti/rockets](https://github.com/ssimasanti/rockets) +**Description:** Cloud server management tool using fabric, libcloud and Django CLI. + +**Name:** Silver Lining +**Website:** [http://cloudsilverlining.org/](http://cloudsilverlining.org/) +**Description:** Application for painless and simple deployment of Python and +PHP applications to the Ubuntu based cloud servers. + +**Name:** madelon +**Website:** [https://github.com/mig5/madelon](https://github.com/mig5/madelon) +**Description:** libcloud-api wrapper to provision a server & run puppet +manifests on it. +**Source code:** [https://github.com/mig5/madelon](https://github.com/mig5/madelon) + +**Name:** CeleryManagement +**Website:** [http://bmbouter.github.com/CeleryManagement/](http://bmbouter.github.com/CeleryManagement/) +**Description:** Allows users to manage and in dynamic mode automatically +provision celery works on the cloud. +**Source code:** [https://github.com/bmbouter/CeleryManagement](https://github.com/bmbouter/CeleryManagement) + +**Name:** provision +**Website:** [https://github.com/genforma/provision](https://github.com/genforma/provision) +**Description:** Provision enables users to deploy customized nodes, either via +shell commands, or as a Python library. +**Source code:** [https://github.com/genforma/provision](https://github.com/genforma/provision) + +**Name:** Salt Cloud +**Website:** [http://saltstack.org](http://saltstack.org) +**Description:** Salt Cloud is a cloud provisioning system that makes extensive +use of libcloud to provision and manage cloud vms. It is primarily used to +automate the setup of cloud vms and make them check back into Salt. +**Source code:** [https://github.com/saltstack/salt-cloud](https://github.com/saltstack/salt-cloud) + +**Name:** File Syncer +**Website:** [https://file-syncer.readthedocs.org/en/latest/](https://file-syncer.readthedocs.org/en/latest/) +**Description:** Python program which synchronizes files from a local directory +to one of the cloud object storage providers supported by Libcloud and +vice-versa. +**Source code:** [https://github.com/Kami/python-file-syncer/](https://github.com/Kami/python-file-syncer/) + +**Name:** depot +**Website:** [https://github.com/coderanger/depot](https://github.com/coderanger/depot) +**Description:** Allows you to manage package repositories in the cloud. +**Source code:** [https://github.com/coderanger/depot](https://github.com/coderanger/depot) + +**Name:** wonton +**Website:** [https://github.com/rackerlabs/wonton](https://github.com/rackerlabs/wonton) +**Description:** Gevent-based, multithreaded tool for bulk transferring objects +from Amazon S3 to Rackspace Cloud Files or vice versa. +**Source code:** [https://github.com/rackerlabs/wonton](https://github.com/rackerlabs/wonton) + +**Name:** fabric-maestro +**Website:** [https://github.com/ehazlett/fabric-maestro](https://github.com/ehazlett/fabric-maestro) +**Description:** Maestro is a Fabric based toolkit for managing systems. There +is also integration with cloud providers via Apache Libcloud. +**Source code:** [https://github.com/ehazlett/fabric-maestro](https://github.com/ehazlett/fabric-maestro) + +**Name:** Nimrod Toolkit +**Website:** [http://www.messagelab.monash.edu.au/Nimrod](http://www.messagelab.monash.edu.au/Nimrod) +**Description:** A toolkit for scheduling and distributing embarrassingly +parallel parameter driven sweeps across heterogeneous compute resources. + +## Companies and Organizations + +**Name:** Rackspace +**Website:** [http://www.rackspace.com/](http://www.rackspace.com/) + +**Name:** SixSq +**Website:** [http://sixsq.com/](http://sixsq.com/) + +**Name:** CloudControl +**Website:** [https://www.cloudcontrol.com/](https://www.cloudcontrol.com/) + +**Name:** mist.io +**Website:** [https://mist.io](https://mist.io) + +**Name:** Cloudkick +**Website:** [https://www.cloudkick.com](https://www.cloudkick.com) +**Reference:** [Announcing libcloud](https://www.cloudkick.com/blog/2009/jul/23/libcloud-announced/) + +**Name:** GlobalRoute +**Website:** [http://globalroute.net/](http://globalroute.net) + +**Name:** Server Density +**Website:** [http://www.serverdensity.com/](http://www.serverdensity.com/) +**Reference:** [Using vCloud and Amazon CloudWatch with libcloud](http://blog.boxedice.com/2010/03/04/using-vcloud-and-amazon-cloudwatch-with-libcloud/) + +**Name:** CollabNet +**Website:** [http://www.collab.net/](http://www.collab.net/) +**Reference:** [CollabNet Automates Build, Test And DevOps In The Cloud With New Version Of CollabNet Lab Management](http://www.itnewsonline.com/showprnstory.php?storyid=215128) + +**Name:** Salt Stack +**Website:** [http://saltstack.com/](http://saltstack.com/) + +**Name:** Monash eScience and Grid Engineering Laboratory +**Website:** [http://www.messagelab.monash.edu.au](http://www.messagelab.monash.edu.au) + +**Name:** Scalr +**Website:** [http://www.scalr.com/](http://www.scalr.com/) + +**Name:** DivvyCloud +**Website:** [http://www.divvycloud.com/](http://www.divvycloud.com/) + +## Not Listed? + +If you or someone you know is using Libcloud, but is not listed on this page, +please [let us know][2]. + +[1]: {{ page.url }} +[2]: https://libcloud.readthedocs.org/en/latest/developer_information.html#mailing-lists
