<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</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>Subject was: Re: [openstack-dev] [tc] [all] [glance] On operating a high throughput or otherwise team</div>
<div><br>
</div>
<div>Un-hijacking the thread. Here are some answers to John's questions, hope they are helpful.</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div>
<div>On 5/16/16, 9:06 PM, "John Griffith" <<a href="mailto:john.griffith8@gmail.com">john.griffith8@gmail.com</a>> wrote:</div>
</div>
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div>
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_quote">
<div><span style="font-family: monospace, monospace;">Hey,</span></div>
</div>
<div class="gmail_default" style="font-family:monospace,monospace"><br>
</div>
<div class="gmail_default" style="font-family:monospace,monospace">Maybe not related, but maybe it is. After spending the past couple of hours trying to help a customer with a Glance issue I'm a bit... well annoyed with Glance. I'd like to chime in on this
thread. I'm honesty not entirely sure what the goal of the thread is, but honestly there's something rather important to me that I don't really seem to see being called out.</div>
<div class="gmail_default" style="font-family:monospace,monospace"><br>
</div>
<div class="gmail_default" style="font-family:monospace,monospace">Is there any way we could stop breaking the API and it's behaviors? Is there any way we can fix some of the issues with respect to how things work when folks configure multiple Glance repos?</div>
<div class="gmail_default" style="font-family:monospace,monospace"><br>
</div>
<div class="gmail_default" style="font-family:monospace,monospace">Couple of examples:</div>
<div class="gmail_default" style="font-family:monospace,monospace">1. switching from "is_public=true" to "visibility=public"</div>
</div>
</div>
</div>
</blockquote>
</span>
<div><br>
</div>
<div>This was a major version change in the Images API. The 'is_public' boolean is in the original Images v1 API, 'visibility' was introduced with the Images v2 API in the Folsom release. You just need an awareness of which version of the API you're talking
to.</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div>
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_default" style="font-family:monospace,monospace"> </div>
</div>
<blockquote style="margin:0 0 0 40px;border:none;padding:0px">
<div class="gmail_extra">
<div class="gmail_default" style="font-family:monospace,monospace">Ok, cool, I'm sure there's great reasons, but it really sucks when folks update their client and now none of their automation works any longer</div>
</div>
</blockquote>
</div>
</div>
</blockquote>
</span>
<div><br>
</div>
<div>The Images v1 API went from CURRENT to SUPPORTED in the Kilo release (April 30, 2015). The python-glanceclient began using v2 as the default with Change-Id: I09c9e409d149e2d797785591183e06c13229b7f7 on June 21, 2015 (and hence would have been in release
0.17.2 on July 16, 2015). So these changes have been in the works for a while.</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_default" style="font-family:monospace,monospace">2. making virtual_size R/O</div>
<div class="gmail_default" style="font-family:monospace,monospace"> </div>
</div>
<blockquote style="margin:0 0 0 40px;border:none;padding:0px">
<div class="gmail_extra">
<div class="gmail_default" style="font-family:monospace,monospace">So for some time this was a property that folks could use to set the size of an image needed for things like volume creation, cloning etc. At some point though it was decided "this should be
read only", ok... well again all sorts of code is now broken, including code in Cinder. It also seems there's no way to set it, so it's always there and just Null. It looked like I would be able to set it during image-create maybe... but then I hit number
3.</div>
</div>
</blockquote>
</div>
</blockquote>
</span>
<div><br>
</div>
<div>The virtual_size was added to the Images v2 API with Change-Id: Ie4f58ee2e4da3a6c1229840295c7f62023a95b70 on February 11, 2014. The commit message indicates: "This patch adds the knowledge of a virtual_size field to Glance's API v2. The virtual_size field
should respect the same rules applied to the size field in terms of readability, access control and propagation." The 'size' field has never been end-user modifiable, hence the virtual_size is read-only as well.</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_default" style="font-family:monospace,monospace">3. broken parsing for size and virtual_size</div>
<div class="gmail_default" style="font-family:monospace,monospace"><br>
</div>
</div>
<blockquote style="margin:0 0 0 40px;border:none;padding:0px">
<div class="gmail_extra">
<div class="gmail_default" style="font-family:monospace,monospace">I just started looking at this one and I'm not sure what happened here yet, but it seems that these inputs aren't being parsed any more and are now raising an exception due to trying to stuff
a string into an int field in the json schema.</div>
</div>
</blockquote>
</div>
</blockquote>
</span>
<div><br>
</div>
<div>Please file a bug with some details when you know more about this one. It sounds like a client issue, but you can put details in the bug report.</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div dir="ltr"><font face="monospace,monospace">
<div>So I think if the project wants to move faster that's great, but please is theres any chance to value backwards compatibility just a bit more? I'm sure I'm going to get flamed for this email, and the likely response will be "you're doing it wrong".
I guess if I'm the only one that has these sorts of issues then alright, I deserve the flames, and maybe somebody will enlighten me on the proper ways of using Glance so I can be happier and more in tune with my Universe.</div>
</font></div>
</blockquote>
</span>
<div><br>
</div>
<div>Well, since you asked for enlightenment ... it *is* helpful to make sure that you know which version of the Images API you're using. The Glance community values backwards compatibility, but not across major releases.</div>
<div><br>
</div>
<div>As I imagine you're aware, Glance is tagged "release: cycle-with-milestones", so you can read about any changes in the release notes. Or if you want a quick overview of what major features were added to Glance for each release, there was an excellent
presentation at the Tokyo summit about the evolution of the Glance APIs:</div>
<div>https://www.openstack.org/summit/tokyo-2015/videos/presentation/the-evolution-of-glance-api-on-the-way-from-v1-to-v3</div>
<div>slides only: http://www.slideshare.net/racker_br/the-evolution-of-glance-api-on-the-way-from-v1-to-v3</div>
<div><br>
</div>
<div>Before people begin freaking out at the mention of the Images v3 API, please note that the presentation above described the state of Glance as of October 2015. The Glance documentation has a statement about the two Images APIs and the current plans for
The Future that was updated shortly after the Austin summit: </div>
<div>http://docs.openstack.org/developer/glance/glanceapi.html#glance-and-the-images-apis-past-present-and-future</div>
<div>(Spoiler alert: no plans for Images v3 API at this point.)</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<blockquote id="MAC_OUTLOOK_ATTRIBUTION_BLOCKQUOTE" style="BORDER-LEFT: #b5c4df 5 solid; PADDING:0 0 0 5; MARGIN:0 0 0 5;">
<div dir="ltr">
<div><span style="font-family: monospace, monospace;">Thanks,</span></div>
<div><font face="monospace,monospace">
<div class="gmail_default" style="display:inline">John</div>
</font></div>
</div>
</blockquote>
</span>
<div><br>
</div>
<div>Hope that was helpful,</div>
<div>brian</div>
<div><br>
</div>
</body>
</html>