<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif; ">
<div>
<div>Hi Dolph,</div>
</div>
<div>Thanks a lot for taking time to answer my questions. Your explanation makes things a lot clearer</div>
<div>I do have some followup questions though.</div>
<div>1.) Does the 'keystone' cli support the identity v3 api features? (I am trying to use domain and groups but don't see any mention in the help section of keystone cli)</div>
<div>2.) If it is not yet supported by any client then when do we expect to have that available?</div>
<div><br>
</div>
<div>Thanks,</div>
<div><br>
</div>
<div>-Farhan.</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>Dolph Mathews <<a href="mailto:dolph.mathews@gmail.com">dolph.mathews@gmail.com</a>><br>
<span style="font-weight:bold">Date: </span>Thursday, June 13, 2013 2:11 PM<br>
<span style="font-weight:bold">To: </span>Farhan Patwa <<a href="mailto:Farhan.Patwa@utsa.edu">Farhan.Patwa@utsa.edu</a>><br>
<span style="font-weight:bold">Cc: </span>OpenStack Maillist <<a href="mailto:openstack@lists.launchpad.net">openstack@lists.launchpad.net</a>><br>
<span style="font-weight:bold">Subject: </span>Re: [Openstack] OpenStack API versions and release content<br>
</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr"><br>
<div class="gmail_extra">
<div class="gmail_quote">On Tue, Jun 11, 2013 at 4:46 PM, Farhan Patwa <span dir="ltr">
<<a href="mailto:Farhan.Patwa@utsa.edu" target="_blank">Farhan.Patwa@utsa.edu</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div>Hi all,</div>
<div>I am just trying to understand the motivation behind creations API versions and how that ties in to a release content.</div>
<div>As per listed documentation (<a href="http://docs.openstack.org/api/openstack-compute/2/content/Versions-d1e1193.html" target="_blank">http://docs.openstack.org/api/openstack-compute/2/content/Versions-d1e1193.html</a>)</div>
<div>"New Features and functionality that break API-compatibility necessitate a new version. When new API version are released older versions are marked as deprecated."</div>
<div><br>
</div>
<div>My questions are:</div>
<div>1.) Is the assumption here that operators may update the release but opt to stay with an older API version to get bug fixes etc.?</div>
</div>
</blockquote>
<div><br>
</div>
<div style="">See #2 below.</div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div>2.) Do new versions have to be deployed with a new release? Keystone has V3 version, but I don't see it being available for use in devstack or Grizzly release (based on my assumption that the command 'keystone discover' will display supported API versions)</div>
</div>
</blockquote>
<div><br>
</div>
<div style="">Not necessarily. Keystone grizzly/2013.1 ships with a revised paste configuration which deploys the new Identity API v3 via pipeline:api_v3 [1]. You don't need to deploy this new pipeline at all, and a folsom paste configuration will deploy an
Identity API v2 implementation just as it did in folsom. The output of "keystone discover" operates based on how the service catalog is populated, which doesn't necessarily reflect the configured pipeline or what's provided by the implementation.</div>
<div style=""><br>
</div>
<div style="">[1]: <a href="https://github.com/openstack/keystone/blob/64738924b87e6fb31d999e25da23f889a2658940/etc/keystone-paste.ini#L78">https://github.com/openstack/keystone/blob/64738924b87e6fb31d999e25da23f889a2658940/etc/keystone-paste.ini#L78</a></div>
<div> </div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div>3.) Do versions have their own release schedule (so Keystone V3 is part of Grizzly code but the implementation is not yet complete or supported??)</div>
</div>
</blockquote>
<div><br>
</div>
<div style="">There's no such thing as "Keystone v3," although that's a common misnomer. The Identity API (v2.0 -> v3.0 -> v3.1) is versioned independently from it's implementation, Keystone (... essex/2012.1 -> folsom/2012.2 -> grizzly/2013.1 -> etc). Several
releases of keystone could be made without incrementing the API version. A release of keystone may contain an experimental/unstable/partial and unrecommended/undocumented implementation of a newer API. A release of keystone may even skip an API version if
there was reason to do so.<br>
</div>
<div style=""><br>
</div>
<div style="">So, for example:</div>
<div style=""><br>
</div>
<div style="">- diablo supports Identity API v2.0 and was extensible to support a non-OpenStack Identity API (v1.1)</div>
<div style="">- essex supports Identity API v2.0</div>
<div style="">- folsom supports Identity API v2.0</div>
<div style="">- grizzly supports Identity API v2.0 and Identity API v3.0</div>
<div style="">- havana will support Identity API v2.0 and Identity API v3.1</div>
- icehouse will support Identity API v2.0 and at least Identity API v3.1 (if not v3.2)</div>
<div class="gmail_quote">- J*release is not guaranteed to support Identity API v2.0 and will support at least Identity API v3.1 (if not v3.3)</div>
<div class="gmail_quote"><br>
</div>
<div class="gmail_quote" style="">(where minor version bumps, e.g. v3.0 -> v3.1 are backwards compatible)<br>
</div>
<div class="gmail_quote" style=""><br>
</div>
<div class="gmail_quote" style="">In reality, if we ship a recommended API implementation, that API version is effectively feature frozen. So, while we could have continued to develop Identity API v3.0 past 2013.1, we documented it in the default configuration
(keystone.conf.sample, devstack, etc) and shipped it with grizzly and are now working towards introducing backwards-compatible features under a minor version bump to the API that will ship with havana.</div>
<div class="gmail_quote">
<div> </div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div><br>
</div>
<div>I would really appreciate if someone can shed light on this.</div>
<div><br>
</div>
<div>Thanks for your time,</div>
<div><br>
</div>
<div>-Farhan Patwa.</div>
</div>
<br>
_______________________________________________<br>
Mailing list: <a href="https://launchpad.net/~openstack" target="_blank">https://launchpad.net/~openstack</a><br>
Post to : <a href="mailto:openstack@lists.launchpad.net">openstack@lists.launchpad.net</a><br>
Unsubscribe : <a href="https://launchpad.net/~openstack" target="_blank">https://launchpad.net/~openstack</a><br>
More help : <a href="https://help.launchpad.net/ListHelp" target="_blank">https://help.launchpad.net/ListHelp</a><br>
<br>
</blockquote>
</div>
<br>
</div>
</div>
</div>
</div>
</span>
</body>
</html>