[openstack-dev] [neutron][api] Neutron micro-versioning update

Salvatore Orlando sorlando at nicira.com
Wed Jun 17 22:23:26 UTC 2015

As you are probably aware an api-wg guideline for microversioning is under
review [1]
Needless to say, neutron developers interested in this work should have a
look at [1] - if nothing else because we need to ensure we are aligned -
and influence the guideline were appropriate.

Experimental APIs are one item where Neutron is not already aligned with
the proposed guideline - and with the project already implementing
While it is known that nova chose to adopt experimental APIs only as a
temporary mechanism [2], the idea of experimental APIs got pretty much
slammed down unanimously in an Ironic meeting (in [3] it sounds like the
word 'experimental' really tickles the Ironic development team).
Therefore, Neutron needs to rethink the proposed API evolution strategy
without experimental APIs. Every new API introduced will be versioned.
While versioning still allows us to evolve the API as we wish, the drawback
is that we'll have to expect several backward incompatible changes while
new APIs stabilise after being introduced.

On the practical stuff matter, I am going to add soon a list of todo items
to spec [4] (which we'll probably amend anyway to reflect outcome the
discussion on [1]). If you're interested in cooperating in this effort,
please pick one item. If we achieve a decent number of "volunteers" we'll
try and set up a weekly meeting.

One aspect where general feedback would be welcome is whether the
microversioning work should be based on master or piggyback on the pecan
switch effort - therefore implementing versioning directly in the new
framework. The pecan switch is being implemented in a feature branch [5]

Thanks for your attention,

[1] https://review.openstack.org/#/c/187112/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150618/04f99251/attachment.html>

More information about the OpenStack-dev mailing list