Open Stack

On 28 October 2013 23:40, Christopher Yeoh <cbkyeoh at gmail.com> wrote:
> On Tue, Oct 29, 2013 at 7:22 AM, David Kranz <dkranz at 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