<div dir="ltr"><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Mar 25, 2014 at 11:41 PM, Clint Byrum <span dir="ltr"><<a href="mailto:clint@fewbar.com" target="_blank">clint@fewbar.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Excerpts from Dolph Mathews's message of 2014-03-25 19:01:17 -0700:<br>
<div><div class="h5">> On Tue, Mar 25, 2014 at 5:50 PM, Russell Bryant <<a href="mailto:rbryant@redhat.com">rbryant@redhat.com</a>> wrote:<br>
><br>
> > We discussed the deprecation of the v2 keystone API in the cross-project<br>
> > meeting today [1].  This thread is to recap and bring that discussion to<br>
> > some consensus.<br>
> ><br>
> > The issue is that Keystone has marked the v2 API as deprecated in Icehouse:<br>
> ><br>
> >     <a href="https://blueprints.launchpad.net/keystone/+spec/deprecate-v2-api" target="_blank">https://blueprints.launchpad.net/keystone/+spec/deprecate-v2-api</a><br>
> ><br>
> > If you use the API, deployments will get this in their logs:<br>
> ><br>
> > WARNING keystone.openstack.common.versionutils [-] Deprecated: v2 API is<br>
> > deprecated as of Icehouse in favor of v3 API and may be removed in K.<br>
> ><br>
> > The deprecation status is reflected in the API for end users, as well.<br>
> > For example, from the CLI:<br>
> ><br>
> >   $ keystone discover<br>
> >   Keystone found at <a href="http://172.16.12.38:5000/v2.0" target="_blank">http://172.16.12.38:5000/v2.0</a><br>
> >     - supports version v2.0 (deprecated) here<br>
> > <a href="http://172.16.12.38:5000/v2.0/" target="_blank">http://172.16.12.38:5000/v2.0/</a><br>
> ><br>
> > My proposal is that this deprecation be reverted.  Here's why:<br>
> ><br>
> > First, it seems there isn't a common use of "deprecated".  To me,<br>
> > marking something deprecated means that the deprecated feature:<br>
> ><br>
> >  - has been completely replaced by something else<br>
> ><br>
><br>
> >  - end users / deployers should take action to migrate to the<br>
> >    new thing immediately.<br>
> ><br>
><br>
> >  - The project has provided a documented migration path<br>
><br>
> >  - the old thing will be removed at a specific date/release<br>
> ><br>
><br>
> Agree on all points. Unfortunately, we have yet to succeed on the<br>
> documentation front:<br>
><br>
><br>
> <a href="https://blueprints.launchpad.net/keystone/+spec/document-v2-to-v3-transition" target="_blank">https://blueprints.launchpad.net/keystone/+spec/document-v2-to-v3-transition</a><br>
><br>
> ><br>
> > The problem with the above is that most OpenStack projects do not<br>
> > support the v3 API yet.<br>
> ><br>
> > From talking to Dolph in the meeting, it sounds like the intention is:<br>
> ><br>
> >  - fully support v2, just don't add features<br>
> ><br>
> >  - signal to other projects that they should be migrating to v3<br>
> ><br>
><br>
> Above all else, this was our primary goal: to raise awareness about our<br>
> path forward, and to identify the non-obvious stakeholders that we needed<br>
> to work with in order to drop support for v2. With today's discussion as<br>
> evidence, I think we've succeeded in that regard :)<br>
><br>
> ><br>
> > Given that intention, I believe the proper thing to do is to actually<br>
> > leave the API marked as fully supported / stable.  Keystone should be<br>
> > working with other OpenStack projects to migrate them to v3.  Once that<br>
> > is complete, deprecation can be re-visited.<br>
> ><br>
><br>
> Happy to!<br>
><br>
> Revert deprecation of the v2 API: <a href="https://review.openstack.org/#/c/82963/" target="_blank">https://review.openstack.org/#/c/82963/</a><br>
><br>
> Although I'd prefer to apply this patch directly to milestone-proposed, so<br>
> we can continue into Juno with the deprecation in master.<br>
><br>
<br>
</div></div>As somebody maintaining a few master-chasing CD clouds, I'd like to ask<br>
you to please stop the squawking about deprecation until it has a definite<br>
replacement and most if not all OpenStack core projects are using it.<br>
<br>
1 out of every 2 API calls on these clouds produces one of these errors<br>
in Keystone. That is just pointless. :-P<br></blockquote><div><br></div><div><div class="gmail_default" style="font-size:small">This is a good point. The other thing we discussed was whether it is appropriate to announce "deprecation" in this way. I'm not sure that logging *inside* the service is useful, but we don't yet have a way to announce to the client that the call invoked is deprecated. We talked about having a cross-project session at the summit, and collaborating with the SDK team, to brainstorm solutions to that problem.</div>
<div class="gmail_default" style="font-size:small"><br>Doug</div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div></div>