Repository: libcloud Updated Branches: refs/heads/trunk 4c1f26f34 -> 5b17c0778
Add some basic docs for azure blobs. Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/206fd87c Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/206fd87c Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/206fd87c Branch: refs/heads/trunk Commit: 206fd87c557de366f8677500033e82e48a7315ff Parents: 4c1f26f Author: Tomaz Muraus <[email protected]> Authored: Tue Apr 7 19:45:20 2015 +0200 Committer: Tomaz Muraus <[email protected]> Committed: Tue Apr 7 19:45:20 2015 +0200 ---------------------------------------------------------------------- .../misc/azure_blobs_manage_access_keys_1.png | Bin 0 -> 64259 bytes .../misc/azure_blobs_manage_access_keys_2.png | Bin 0 -> 26247 bytes docs/examples/storage/azure/instantiate.py | 7 +++++ docs/storage/_supported_providers.rst | 2 +- docs/storage/drivers/azure_blobs.rst | 28 +++++++++++++++++++ 5 files changed, 36 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/libcloud/blob/206fd87c/docs/_static/images/misc/azure_blobs_manage_access_keys_1.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/azure_blobs_manage_access_keys_1.png b/docs/_static/images/misc/azure_blobs_manage_access_keys_1.png new file mode 100644 index 0000000..ca1b1c2 Binary files /dev/null and b/docs/_static/images/misc/azure_blobs_manage_access_keys_1.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/206fd87c/docs/_static/images/misc/azure_blobs_manage_access_keys_2.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/azure_blobs_manage_access_keys_2.png b/docs/_static/images/misc/azure_blobs_manage_access_keys_2.png new file mode 100644 index 0000000..6337fcd Binary files /dev/null and b/docs/_static/images/misc/azure_blobs_manage_access_keys_2.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/206fd87c/docs/examples/storage/azure/instantiate.py ---------------------------------------------------------------------- diff --git a/docs/examples/storage/azure/instantiate.py b/docs/examples/storage/azure/instantiate.py new file mode 100644 index 0000000..bc0a62a --- /dev/null +++ b/docs/examples/storage/azure/instantiate.py @@ -0,0 +1,7 @@ +from libcloud.storage.types import Provider +from libcloud.storage.providers import get_driver + +cls = get_driver(Provider.AZURE_BLOBS) + +driver = cls(key='your storage account name', + secret='your access key') http://git-wip-us.apache.org/repos/asf/libcloud/blob/206fd87c/docs/storage/_supported_providers.rst ---------------------------------------------------------------------- diff --git a/docs/storage/_supported_providers.rst b/docs/storage/_supported_providers.rst index 6d5ef97..bffae46 100644 --- a/docs/storage/_supported_providers.rst +++ b/docs/storage/_supported_providers.rst @@ -1,7 +1,7 @@ ============================= =============================================== ================= ============================================== ==================================== Provider Documentation Provider constant Module Class Name ============================= =============================================== ================= ============================================== ==================================== -`Microsoft Azure (blobs)`_ AZURE_BLOBS :mod:`libcloud.storage.drivers.azure_blobs` :class:`AzureBlobsStorageDriver` +`Microsoft Azure (blobs)`_ :doc:`Click </storage/drivers/azure_blobs>` AZURE_BLOBS :mod:`libcloud.storage.drivers.azure_blobs` :class:`AzureBlobsStorageDriver` `CloudFiles`_ CLOUDFILES :mod:`libcloud.storage.drivers.cloudfiles` :class:`CloudFilesStorageDriver` `CloudFiles (UK)`_ CLOUDFILES_UK :mod:`libcloud.storage.drivers.cloudfiles` :class:`CloudFilesUKStorageDriver` `CloudFiles (US)`_ CLOUDFILES_US :mod:`libcloud.storage.drivers.cloudfiles` :class:`CloudFilesUSStorageDriver` http://git-wip-us.apache.org/repos/asf/libcloud/blob/206fd87c/docs/storage/drivers/azure_blobs.rst ---------------------------------------------------------------------- diff --git a/docs/storage/drivers/azure_blobs.rst b/docs/storage/drivers/azure_blobs.rst new file mode 100644 index 0000000..f08b6f8 --- /dev/null +++ b/docs/storage/drivers/azure_blobs.rst @@ -0,0 +1,28 @@ +Azure Blobs Storage Driver Documentation +======================================== + +Connecting to Azure Blobs +------------------------- + +To connect to Azure Blobs you need your storage account name and access key.A + +You can retrieve this information in the Azure Management portal by going to +Storage -> Manage Access Keys as shown on the screenshots below. + +.. figure:: /_static/images/misc/azure_blobs_manage_access_keys_1.png + :align: center + :width: 900 + + +.. figure:: /_static/images/misc/azure_blobs_manage_access_keys_2.png + :align: center + :width: 500 + +Instantiating a driver +~~~~~~~~~~~~~~~~~~~~~~ + +Once you have obtained your credentials you can instantiate the driver as shown +below. + +.. literalinclude:: /examples/storage/azure/instantiate.py + :language: python
