You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@libcloud.apache.org by to...@apache.org on 2013/09/21 02:33:18 UTC
[1/6] git commit: docs: fix a typo.
Updated Branches:
refs/heads/trunk 15e103f9a -> 08a325ac7
docs: fix a typo.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/53bc9a20
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/53bc9a20
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/53bc9a20
Branch: refs/heads/trunk
Commit: 53bc9a207f68dca194f9e9c54bf937e62c11464b
Parents: 15e103f
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 21 02:12:15 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 21 02:12:15 2013 +0200
----------------------------------------------------------------------
docs/compute/index.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/53bc9a20/docs/compute/index.rst
----------------------------------------------------------------------
diff --git a/docs/compute/index.rst b/docs/compute/index.rst
index fd5dbf4..fff997e 100644
--- a/docs/compute/index.rst
+++ b/docs/compute/index.rst
@@ -59,7 +59,7 @@ Libcloud provides deployment functionality which makes bootstrapping a server
easier. It allows you to create a server and runn shell commands on it once the
server has been created.
-For more information and exaples, please see the :doc:`deployment page
+For more information and examples, please see the :doc:`deployment page
</compute/deployment>`.
Examples
[6/6] git commit: docs: Link to changelog and upgrade notes from the
index page.
Posted by to...@apache.org.
docs: Link to changelog and upgrade notes from the index page.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/08a325ac
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/08a325ac
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/08a325ac
Branch: refs/heads/trunk
Commit: 08a325ac7124ca00980e4e162728fe26b5df0a61
Parents: 253f70f
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 21 02:32:11 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 21 02:32:11 2013 +0200
----------------------------------------------------------------------
docs/index.rst | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/08a325ac/docs/index.rst
----------------------------------------------------------------------
diff --git a/docs/index.rst b/docs/index.rst
index adea47e..b9af83f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -41,11 +41,13 @@ Main
:maxdepth: 3
getting_started
+ changelog
supported_providers
compute/index
storage/index
loadbalancer/index
dns/index
+ upgrade_notes
troubleshooting
faq
other/*
[5/6] git commit: docs: Add changelog chapter.
Posted by to...@apache.org.
docs: Add changelog chapter.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/253f70f0
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/253f70f0
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/253f70f0
Branch: refs/heads/trunk
Commit: 253f70f03838d399c95c00fdd69d9e7d698ae8d2
Parents: 522d6a0
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 21 02:31:48 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 21 02:31:48 2013 +0200
----------------------------------------------------------------------
docs/changelog.rst | 4 ++++
1 file changed, 4 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/253f70f0/docs/changelog.rst
----------------------------------------------------------------------
diff --git a/docs/changelog.rst b/docs/changelog.rst
new file mode 100644
index 0000000..62e81df
--- /dev/null
+++ b/docs/changelog.rst
@@ -0,0 +1,4 @@
+Changelog
+=========
+
+.. literalinclude:: ../CHANGES
[3/6] git commit: docs: add links to the committer guide to the index
page.
Posted by to...@apache.org.
docs: add links to the committer guide to the index page.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/fe400cda
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/fe400cda
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/fe400cda
Branch: refs/heads/trunk
Commit: fe400cda145d9b488306b3b73ce6a7d2d0d581d5
Parents: 88c833c
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 21 02:14:08 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 21 02:14:08 2013 +0200
----------------------------------------------------------------------
docs/index.rst | 9 +++++++++
1 file changed, 9 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/fe400cda/docs/index.rst
----------------------------------------------------------------------
diff --git a/docs/index.rst b/docs/index.rst
index 414a8ce..adea47e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -60,4 +60,13 @@ Developer Information
developer_information
development
+Committer Guide
+---------------
+
+.. toctree::
+ :glob:
+ :maxdepth: 3
+
+ committer_guide
+
.. _`Apache 2.0 license`: https://www.apache.org/licenses/LICENSE-2.0.html
[4/6] git commit: docs: Move upgrade notes to Sphinx documentation
and update it.
Posted by to...@apache.org.
docs: Move upgrade notes to Sphinx documentation and update it.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/522d6a09
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/522d6a09
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/522d6a09
Branch: refs/heads/trunk
Commit: 522d6a096c404fcae0d3ef88ef409c086f643157
Parents: fe400cd
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 21 02:27:50 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 21 02:29:23 2013 +0200
----------------------------------------------------------------------
docs/upgrade_notes.rst | 110 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 110 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/522d6a09/docs/upgrade_notes.rst
----------------------------------------------------------------------
diff --git a/docs/upgrade_notes.rst b/docs/upgrade_notes.rst
new file mode 100644
index 0000000..33144f2
--- /dev/null
+++ b/docs/upgrade_notes.rst
@@ -0,0 +1,110 @@
+Upgrade Notes
+=============
+
+This page describes how to upgrade from a previous version to a new version
+which contains backward incompatible or semi-incompatible changes and how to
+preserve the old behavior when this is possible.
+
+Libcloud 0.8
+------------
+
+* ``restart_node`` method has been removed from the OpenNebula compute driver,
+ because OpenNebula OCCI implementation does not support a proper restart
+ method.
+
+* ``ex_save_image`` method in the OpenStack driver now returns a ``NodeImage``
+ instance.
+
+For a full list of changes, please see the `CHANGES file <https://git-wip-us.apache.org/repos/asf?p=libcloud.git;a=blob;f=CHANGES;h=fd1f9cd8917bf9d9c5f4d5344872dbccba894444;hb=b26812db71e6c36be3cc5f7fcb87f82b267bfddd>`_.
+
+Libcloud 0.7
+------------
+
+* For consistency, ``public_ip`` and ``private_ip`` attribute on the ``Node``
+ object have been renamed to ``public_ips`` and ``private_ips`` respectively.
+
+In 0.7 you can still access those attributes using the old way, but this option
+will be removed in the next major release.
+
+**Note: If you have places in your code where you directly instantiate a
+``Node`` class, you need to update it.**
+
+Old code:
+
+.. sourcecode:: python
+
+ node = Node(id='1', name='test node', state=NodeState.PENDING,
+ private_ip=['10.0.0.1'], public_ip=['88.77.66.77'],
+ driver=driver)
+
+Updated code:
+
+.. sourcecode:: python
+
+ node = Node(id='1', name='test node', state=NodeState.PENDING,
+ private_ips=['10.0.0.1'], public_ips=['88.77.66.77'],
+ driver=driver)
+
+* Old deprecated paths have been removed. If you still haven't updated your
+code you need to do it now, otherwise it won't work with 0.7 and future releases.
+
+Bellow is a list of old paths and their new locations:
+
+* ``libcloud.base`` -> ``libcloud.compute.base``
+* ``libcloud.deployment`` -> ``libcloud.compute.deployment``
+* ``libcloud.drivers.*`` -> ``libcloud.compute.drivers.*``
+* ``libcloud.ssh`` -> ``libcloud.compute.ssh``
+* ``libcloud.types`` -> ``libcloud.compute.types``
+* ``libcloud.providers`` -> ``libcloud.compute.providers``
+
+In the ``contrib/`` directory you can also find a simple bash script which can
+perform a search and replace for you - `migrate_paths.py <https://svn.apache.org/repos/asf/libcloud/trunk/contrib/migrate_paths.sh>`_.
+
+For a full list of changes, please see the `CHANGES file <https://git-wip-us.apache.org/repos/asf?p=libcloud.git;a=blob;f=CHANGES;h=276948338c2581de1178e51f7f7cdbd4e7ba9286;hb=2ad8f3fa1f258d6c53d7b058cdc6cd9ab1fd579b>`_.
+
+Libcloud 0.6
+------------
+
+* SSL certificate verification is now enabled by default and an exception is
+ thrown if CA certificate files cannot be found.
+
+To revert to the old behavior, set ``libcloud.security.VERIFY_SSL_CERT_STRICT``
+variable to ``False``:
+
+.. sourcecode:: python
+
+ libcloud.security.VERIFY_SSL_CERT_STRICT = False
+
+**Note: You are strongly discouraged from disabling SSL certificate validation.
+If you disable it and no CA certificates files are found on the system you are
+vulnerable to a man-in-the-middle attack**
+
+More information on how to acquire and install CA certificate files on
+different operating systems can be found on :doc:`SSL Certificate Validation
+page </other/ssl-certificate-validation>`
+
+* OpenStack driver now defaults to using OpenStack 1.1 API.
+
+To preserve the old behavior and use OpenStack 1.0 API, pass
+``api_version='1.0'`` keyword argument to the driver constructor.
+
+For example:
+
+.. sourcecode:: python
+
+ Cls = get_provider(Provider.OPENSTACK)
+ driver = Cls('user_name', 'api_key', False, 'host', 8774, api_version='1.0')
+
+* OpenNebula driver now defaults to using OpenNebula 3.0 API
+
+To preserve the old behavior and use OpenNebula 1.4 API, pass
+``api_version='1.4'`` keyword argument to the driver constructor.
+
+For example:
+
+.. sourcecode:: python
+
+ Cls = get_provider(Provider.OPENNEBULA)
+ driver = Cls('key', 'secret', api_version='1.4')
+
+For a full list of changes, please see the `CHANGES file <https://svn.apache.org/viewvc/libcloud/trunk/CHANGES?revision=1198753&view=markup>`_.
[2/6] git commit: docs: Update index page - make it more clear that
CDN functionality is available through the object storage API.
Posted by to...@apache.org.
docs: Update index page - make it more clear that CDN functionality is available
through the object storage API.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/88c833c2
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/88c833c2
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/88c833c2
Branch: refs/heads/trunk
Commit: 88c833c20b4b551ebd509be05e5077de73323cfe
Parents: 53bc9a2
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 21 02:12:30 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 21 02:12:30 2013 +0200
----------------------------------------------------------------------
docs/index.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/88c833c2/docs/index.rst
----------------------------------------------------------------------
diff --git a/docs/index.rst b/docs/index.rst
index 66587dc..414a8ce 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -20,7 +20,7 @@ Resource you can manage with Libcloud are divided in the following categories:
* :doc:`Cloud Servers and Block Storage </compute/index>` - services such as Amazon EC2 and
RackSpace CloudServers
-* :doc:`Cloud Object Storage </storage/index>` - services such as Amazon S3 and
+* :doc:`Cloud Object Storage and CDN </storage/index>` - services such as Amazon S3 and
Rackspace CloudFiles
* :doc:`Load Balancers as a Service </loadbalancer/index>` - services such as Amazon Elastic Load Balancer and GoGrid LoadBalancers
* :doc:`DNS as a Service </dns/index>` - services such as Amazon Route 53 and Zerigo