[openstack-dev] [nova] API priorities in Newton

Matthew Treinish mtreinish at kortar.org
Wed Mar 30 19:47:09 UTC 2016

On Wed, Mar 30, 2016 at 03:26:13PM -0400, Sean Dague wrote:
> During the Nova API meeting we had some conversations about priorities,
> but this feels like the thing where a mailing list conversation is more
> inclusive to get agreement on things. I think we need to remain focused
> on what API related work will have the highest impact on our users.
> (some brain storming was here -
> https://etherpad.openstack.org/p/newton-nova-api-ideas). Here is a
> completely straw man proposal on priorities for the Newton cycle.
> * Top Priority Items *
> 1. API Reference docs in RST which include microversions (drivers: me,
> auggy, annegentle) -
> https://blueprints.launchpad.net/nova/+spec/api-ref-in-rst
> 2. Discoverable Policy (drivers: laski, claudio) -
> https://review.openstack.org/#/c/289405/
> 3. ?? (TBD)
> I think realistically 3 priority items is about what we can sustain, and
> I'd like to keep it there. Item #3 has a couple of options.
> * Lower Priority Background Work *
> - POC of Gabbi for additional API validation
> - Microversion Testing in Tempest (underway)

FWIW, the  framework for using microversions in tempest is done (and is part of
tempest.lib too) and the BP for that has been marked as implemented:


All that's needed now is to actually start to leverage it by adding tests with
microversions. IIRC there is only 1 right now, just a pro forma test for v2.2.
The docs for using it are here:


> - Some of the API WG recommendations
> * Things we shouldn't do this cycle *
> - Tasks API - not because it's not a good idea, but because I think
> until we get ~ 3 core team members agreed that it's their number #1 item
> for the cycle, it's just not going to get enough energy to go somewhere
> useful. There are some other things on deck that we just need to clear
> first.
> - API wg changes for error codes - we should fix that eventually, but
> that should come as a single microversion to minimize churn. That's
> coordination we don't really have the bandwidth for this cycle.
> * Things we need to decide this cycle *
> - When are we deleting the legacy v2 code base in tree?

I can get behind doing this. I think we've been running the 2.1 base compat
as the default for long enough that there aren't gonna be any surprises if
we drop the old v2 code in Newton.

> * Final priority item *
> For the #3 priority item one of the things that came up today was the
> structured errors spec by the API working group. That would be really
> nice... but in some ways really does need the entire new API reference
> docs in place. And maybe is better in O.
> One other issue that we've been blocking on for a while has been
> Capabilities discovery. Some API proposed adds like live resize have
> been conceptually blocked behind this one. Once upon a time there was a
> theory that JSON Home was a thing, and would slice our bread and julien
> our fries, and solve all this. But it's a big thing to get right, and
> JSON Home has an unclear future. And, we could server our users pretty
> well with a much simpler take on capabilities. For instance
>  GET /servers/{id}/capabilities
> {
>     "capabilities" : {
>         "resize": True,
>         "live-resize": True,
>         "live-migrate": False
>         ...
>      }
> }
> Effectively an actions map for servers. Lots of details would have to be
> sorted out on this one, clearly needs a spec, however I think that this
> would help unstick some other things people would like in Nova, without
> making our interop story terrible. This would need a driver for this effort.
> Every thing here is up for discussion. This is a summary of some of what
> was in the meeting, plus some of my own thoughts. Please chime in on any
> of this. It would be good to be of general agreement pre summit, so we
> could focus conversation there more on the hows for getting things done.
> 	-Sean
> -- 
> Sean Dague
> http://dague.net
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160330/085322b4/attachment.pgp>

More information about the OpenStack-dev mailing list