docs: Update upgrade notes.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/7cb7423f Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/7cb7423f Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/7cb7423f Branch: refs/heads/trunk Commit: 7cb7423f363f0e1137b036e7ab9d3f8abefbb062 Parents: 859fae7 Author: Tomaz Muraus <[email protected]> Authored: Thu Oct 17 22:04:59 2013 +0200 Committer: Tomaz Muraus <[email protected]> Committed: Thu Oct 17 22:04:59 2013 +0200 ---------------------------------------------------------------------- docs/upgrade_notes.rst | 59 ++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 58 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/libcloud/blob/7cb7423f/docs/upgrade_notes.rst ---------------------------------------------------------------------- diff --git a/docs/upgrade_notes.rst b/docs/upgrade_notes.rst index fab3e35..b2433a3 100644 --- a/docs/upgrade_notes.rst +++ b/docs/upgrade_notes.rst @@ -176,7 +176,7 @@ New code (connecting to a next-gen provider) driver2 = cls('username', 'api_key', region='dfw') driver3 = cls('username', 'api_key', region='lon') -CloudStack Compute driver changes +CloudStack compute driver changes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ CloudStack driver received a lot of changes and additions which will make it @@ -230,6 +230,63 @@ Old code: driver = cls('username', 'api_key', region='us-east-1') +ElasticHosts compute driver changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +ElasticHosts compute driver has moved to single class plus ``region`` argument +model. As such, the following provider constants have been deprecated: + +* ``ELASTICHOSTS_UK1`` +* ``ELASTICHOSTS_UK1`` +* ``ELASTICHOSTS_US1`` +* ``ELASTICHOSTS_US2`` +* ``ELASTICHOSTS_US3`` +* ``ELASTICHOSTS_CA1`` +* ``ELASTICHOSTS_AU1`` +* ``ELASTICHOSTS_CN1`` + +And replaced with a single constant: + +* ``ELASTICHOSTS`` - Supported values for the ``region`` argument are: + ``lon-p``, ``lon-b``, ``sat-p``, ``lax-p``, ``sjc-c``, ``tor-p``, ``syd-y``, + ``cn-1`` Default value is ``sat-p``. + +List which shows how old classes map to a new ``region`` argument value: + +* ``ELASTICHOSTS_UK1`` -> ``lon-p`` +* ``ELASTICHOSTS_UK1`` -> ``lon-b`` +* ``ELASTICHOSTS_US1`` -> ``sat-p`` +* ``ELASTICHOSTS_US2`` -> ``lax-p`` +* ``ELASTICHOSTS_US3`` -> ``sjc-c`` +* ``ELASTICHOSTS_CA1`` -> ``tor-p`` +* ``ELASTICHOSTS_AU1`` -> ``syd-y`` +* ``ELASTICHOSTS_CN1`` -> ``cn-1`` + +Old code: + +.. sourcecode:: python + + from libcloud.compute.types import Provider + from libcloud.compute.providers import get_driver + + cls1 = get_driver(Provider.ELASTICHOSTS_UK1) + cls2 = get_driver(Provider.ELASTICHOSTS_US2) + + driver1 = cls('username', 'api_key') + driver2 = cls('username', 'api_key') + +New code: + +.. sourcecode:: python + + from libcloud.compute.types import Provider + from libcloud.compute.providers import get_driver + + cls = get_driver(Provider.ELASTICHOSTS) + + driver1 = cls('username', 'api_key', region='lon-p') + driver2 = cls('username', 'api_key', region='lax-p') + Unification of extension arguments for security group handling in the EC2 driver ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
