[openstack-dev] [All][Keystone] Deprecation of the v2 API
Anne Gentle
anne at openstack.org
Wed Mar 26 01:23:41 UTC 2014
On Tue, Mar 25, 2014 at 5:50 PM, Russell Bryant <rbryant at redhat.com> wrote:
> We discussed the deprecation of the v2 keystone API in the cross-project
> meeting today [1]. This thread is to recap and bring that discussion to
> some consensus.
>> The issue is that Keystone has marked the v2 API as deprecated in Icehouse:
>> https://blueprints.launchpad.net/keystone/+spec/deprecate-v2-api
>> If you use the API, deployments will get this in their logs:
>> WARNING keystone.openstack.common.versionutils [-] Deprecated: v2 API is
> deprecated as of Icehouse in favor of v3 API and may be removed in K.
>> The deprecation status is reflected in the API for end users, as well.
> For example, from the CLI:
>> $ keystone discover
> Keystone found at http://172.16.12.38:5000/v2.0
> - supports version v2.0 (deprecated) here
> http://172.16.12.38:5000/v2.0/
>> My proposal is that this deprecation be reverted. Here's why:
>> First, it seems there isn't a common use of "deprecated". To me,
> marking something deprecated means that the deprecated feature:
>> - has been completely replaced by something else
>> - end users / deployers should take action to migrate to the
> new thing immediately.
>> - The project has provided a documented migration path
>> - the old thing will be removed at a specific date/release
>> The problem with the above is that most OpenStack projects do not
> support the v3 API yet.
>> From talking to Dolph in the meeting, it sounds like the intention is:
>> - fully support v2, just don't add features
>> - signal to other projects that they should be migrating to v3
>> Given that intention, I believe the proper thing to do is to actually
> leave the API marked as fully supported / stable. Keystone should be
> working with other OpenStack projects to migrate them to v3. Once that
> is complete, deprecation can be re-visited.
>
Sounds great, thanks for the discussion.
Anne
>> In summary, until we have completed v3 support within OpenStack itself,
> it's premature to mark the API deprecated since that's a signal to end
> users and deployers that says action is required.
>> Thoughts?
>> [1]
>> http://eavesdrop.openstack.org/meetings/project/2014/project.2014年03月25日-21.01.log.html#l-103
>> --
> Russell Bryant
>> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20140325/45c26e7c/attachment.html>
More information about the OpenStack-dev
mailing list