[openstack-dev] [nova][api] New micro-version needed for api bug fix or not?
Xu, Hejie
hejie.xu at intel.com
Sun May 31 13:16:30 UTC 2015
I also learn that from Sean!
-----Original Message-----
From: Jay Pipes [mailto:jaypipes at gmail.com]
Sent: Saturday, May 30, 2015 2:58 AM
To: openstack-dev at lists.openstack.org
Subject: Re: [openstack-dev] [nova][api] New micro-version needed for api bug fix or not?
On 05/29/2015 05:04 AM, John Garbutt wrote:
> On 29 May 2015 at 09:00, Sahid Orentino Ferdjaoui
> <sahid.ferdjaoui at redhat.com> wrote:
>> On Fri, May 29, 2015 at 08:47:01AM +0200, Jens Rosenboom wrote:
>>> As the discussion in https://review.openstack.org/179569 still
>>> continues about whether this is "just" a bug fix, or an API change
>>> that will need a new micro version, maybe it makes sense to take
>>> this issue over here to the ML.
>>
>> Changing version of the API probably makes sense also for bug if it
>> changes the behavior of a command/option to something backward
>> incompatible. I do not believe it is the case for your change.
>>
>>> My personal opinion is undecided, I can see either option as being
>>> valid, but maybe after having this open bug for four weeks now we
>>> can come to some conclusion either way.
>
> Apologies for this, we are still trying to evolve the rules for when
> to bump the API micro versions, there will be some pain while we work
> that out :(
>
>
> From the summit discussion, I think got three things roughly agreed
> (although we have not yet got them written up into a devref document,
> to make the formal agreement, and we need to do that ASAP):
>
> 1)
> We agreed changing a 500 error to an existing error (or making it
> succeed in the usual way) is a change that doesn't need a version
> bump, its a bug fix.
>
> 2)
> We also agreed that all micro version bumps need a spec, to help avoid
> is adding more "bad" things to the API as we try and move forward.
> This is heavy weight. In time, we might find certain "good" patterns
> where we want to relax that restriction, but we haven't done enough
> changes to agree on those patterns yet. This will mean we are moving a
> bit slower at first, but it feels like the right trade off against
> releasing (i.e. something that lands in any commit on master) an API
> with a massive bug we have to support for a long time.
>
> 3)
> Discuss other cases as they came up, and evolve the plans based on the
> examples that come up, with a focus on bumping the version being
> (almost) free, and useful for clients to work out what has changed.
>
> Is that how everyone else remembers that discussion?
Yes.
> Now when it comes to your change. It is a bug in the default policy.
> Sadly this policy is also quite hard wired to admin vs non-admin. We
> still need work to make policy more discoverable, so I don't think we
> need to make this any more discoverable as such.
>
> Having said all that, we probably need to look at this case more
> carefully, after your patch has merged, and work out how this should
> work now we assuming strong validation, and granular policy, etc.
Actually, after reading the IRC conversation between Dims and Sean, I believe Sean is right to want a microversion bump for this patch. If two clouds are deployed, one with this patch and another without, a client issuing commands to both will have no idea whether the ip6 filter will be considered or not. Having a microversion increment in the patch would allow clients to request behaviour they want (the ip6 filter).
Best,
-jay
> But maybe there is something massive here?
>
>
> Thanks,
> John
>
> ______________________________________________________________________
> ____ OpenStack Development Mailing List (not for usage questions)
> Unsubscribe:
> OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
More information about the OpenStack-dev
mailing list