index.rst 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. .. cloudbridge documentation master file, created by
  2. sphinx-quickstart on Sat Oct 10 03:17:52 2015.
  3. You can adapt this file completely to your liking, but it should at least
  4. contain the root `toctree` directive.
  5. Welcome to CloudBridge's documentation!
  6. =======================================
  7. CloudBridge aims to provide a simple layer of abstraction over
  8. different cloud providers, reducing or eliminating the need to write
  9. conditional code for each cloud.
  10. Usage example
  11. -------------
  12. The simplest possible example for doing something useful with CloudBridge would
  13. look like the following.
  14. .. code-block:: python
  15. from cloudbridge.cloud.factory import CloudProviderFactory, ProviderList
  16. provider = CloudProviderFactory().create_provider(ProviderList.AWS, {})
  17. print(provider.compute.instances.list())
  18. In the example above, the AWS_ACCESS_KEY and AWS_SECRET_KEY environment variables
  19. must be set to your cloud credentials.
  20. Quick Reference
  21. ---------------
  22. The following object graph shows how to access various provider services, and the resource
  23. that they return. Click on any object to drill down into its details.
  24. .. raw:: html
  25. <object data="_images/object_relationships_detailed.svg" type="image/svg+xml"></object>
  26. Installation
  27. ------------
  28. The latest release can always be installed form PyPI. For other installation
  29. options, see the `installation page <topics/install.html>`_::
  30. pip install cloudbridge
  31. Documentation
  32. -------------
  33. .. toctree::
  34. :maxdepth: 2
  35. concepts.rst
  36. getting_started.rst
  37. topics/overview.rst
  38. topics/contributor_guide.rst
  39. api_docs/ref.rst
  40. Page index
  41. ----------
  42. * :ref:`genindex`