On 28 October 2013 23:40, Christopher Yeoh cbky...@gmail.com wrote:
On Tue, Oct 29, 2013 at 7:22 AM, David Kranz dkr...@redhat.com wrote:
As I looked at the havana release notes that talk about the v3 api, and as
I was reviewing
port test_images and test_server_actions into v3 part2
https://review.openstack.org/#/c/39609/,
I saw some less-than-obvious differences. For example, the images/get it
seems now goes directly to glance which
results in the returned state being 'active' instead of 'ACTIVE' as it was
in v2. Another test was changed to expect the state to be
'queued' when it used to be 'SAVING'. There are also all the changes
regarding CamelCase of dict keywords.
I saw there was work on documenting the v3 api but doesn't there also need
to be some kind of release note that documents the incompatible changes that
users need to account for in their client code when they start pointing it
at a v3 server? Such a document would also make it much easier to review the
v3 api tests in tempest. Does such information exist already?
Unfortunately, no there isn't really - nothing that is specific to
individual APIs. I've mainly been focussing on getting a V3 specification
documentation up first (which I think is more important), but I do agree
that a transition document would be very useful as well.
This is a broad description of what was done:
https://etherpad.openstack.org/p/NovaV3APIHavana
which lists the types of changes which were made - eg CamelCase changes,
removal of proxying of services like glance through Nova etc. But I agree we
could do with something much better so its something we will do, I just
can't make any guarantees of when it will be available yet.
+1 it would be a good doc to have ready by the end of Icehouse.
Was it also clear enough in the docs that the v3 API is not really
ready to use until Icehouse? There may be non-backwards compatible
changes made to the API while we polish it, I assume.
John
___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
