15:00:28 #startmeeting Glance 15:00:29 Meeting started Thu Feb 19 15:00:28 2015 UTC and is due to finish in 60 minutes. The chair is nikhil_k. Information about MeetBot at http://wiki.debian.org/MeetBot. 15:00:30 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 15:00:32 o/ 15:00:33 The meeting name has been set to 'glance' 15:00:37 yup 15:00:38 o/ 15:00:39 o/ 15:00:39 o/ 15:00:39 o/ 15:00:39 https://etherpad.openstack.org/p/glance-team-meeting-agenda 15:00:49 o/ 15:01:22 Let's get started 15:01:31 #topic Glance review guidelines 15:01:39 hemanthm: mfedosin ? 15:01:42 okay 15:01:53 before I begin I have some good news 15:01:55 nikhil_k, o/ 15:02:09 Now we have a dedicated technical writer for Glance 15:02:21 woo! 15:02:22 er name is Lena and she has big experience in writing documentation - over 7 years. 15:02:29 \o/ 15:02:30 \\o \o/ o// o/7 15:02:45 Unfortunately she's on vacation this week, but I hope next time she can join us and introduce herself. 15:02:57 that sounds great 15:03:06 Nice, good news indeed 15:03:12 yeah, she's good 15:03:17 mfedosin: that is really good news, we need someone to get the docs straightened out 15:03:30 o/ 15:03:43 so, about review guide... 15:03:49 o/ 15:04:04 I want to show you draft of the review guidelines. It still needs some work, but you can read it and leave your comments. 15:04:12 https://docs.google.com/document/d/1Iia0BjQoXvry9XSbf30DRwQt--ODglw-ZTT_5RJabsI/edit?usp=sharing 15:05:01 I think Hemanth as a author can say a couple of words about it 15:05:39 I have several questions: 15:05:46 Do we need examples there? And what kind of... 15:05:49 o/ 15:05:55 1. example of good and bad code 15:06:05 2. successful corrections 15:06:10 3. bad reviews 15:06:23 And do we need another paragraphs there? 15:06:34 If we want it to be educational, I'd say lets leave examples there 15:06:55 Since this is the first draft. 1 -> good to have but not necessary 15:07:10 Yeah I think examples will help more than hurt 15:07:17 at least for some glance specific practices like wrapping and reraising exceptions 15:07:20 can you please elaborate on 2 ? 15:07:24 more examples are good 15:07:52 Yeah 2 is a bit vague 15:08:12 nikhil_k, links for good reviews 15:08:27 and 3 links for bad reviews 15:08:30 ah 15:08:37 I don't think we want 3 15:08:39 status:merged should be such a link 15:08:42 hehe 15:08:46 i think some troubleshooting tips/scenarios will be good if it helps in the context 15:08:54 ativelkov, ;) 15:09:13 we can have something that says what are nitpicks , corner cases, some bikeshedding examples, etc 15:09:14 lakshmiS, good idea but that can do in the dev guide maybe? mfedosin is going to talk about it next 15:09:20 *can go 15:09:55 mfedosin, hemanthm: Is there a reason to have the non-glance-specific stuff there to keep in sync rather than improving the OS wiki regarding those? 15:09:59 hemanthm, as long as it's there in some doc, that will be helpful 15:10:06 but we *DONOT* want to point out someone publicaly and condemn them 15:10:13 hemanthm, yes, so I think we need 1, and reject 2 and 3 15:11:59 jokke_, yeah we could always point to appropriate wikis, but the idea was to share a few commonly found patterns and then link to the wikis for more info 15:12:24 New reviewers are not going to like that and our objective is, to be inclusive as far as possible 15:12:36 jokke_, Hemanth is right. There is a small description of this guide and what is is for... 15:13:11 is this planned to be placed on the wiki at some point? 15:13:24 kragniz, yes, that's the idea 15:13:40 cool 15:14:34 and as I mentioned all your thoughts and suggestions are appreciated :) 15:14:35 The other thing we might want to do is discuss certain special cases 15:14:45 I would prefer the approach that Hacking doc has as in just header pointing to the OS general guidelines, and telling to read them first, then reading them again and then coming back to the glance specific stuff (keeping the later part as small as possible) 15:15:06 So I was reviewing one of sabari's changes in glance_store and learned that for driver-specific changes, nova asks the driver name be first (which contradicts with the general style guide) 15:15:33 do we want to do the same, etc 15:15:49 (that's the value add I see in doing this separately first) 15:16:25 sigmavirus24, +1, could you please add any special cases you are aware of 15:16:46 sigmavirus24: could you explain this "nova asks the driver name be first"? Be first where, how? 15:16:50 hemanthm: well I think they're things we should decide as a community which is why I brought that up 15:17:03 jokke_: so in the subject it would be "VMware: Do x y z and update foo bar bogus" 15:17:11 == sigmavirus24 15:17:38 That breaks the general style rule of "Imperative subjects" i.e. "Change VMWare driver to do x y z and update foo bar bugs" 15:17:43 Our commits are often not par with such standards but we've improving for sure 15:18:07 On the one hand: The former gives the reader an immediate understanding that this is VMWare specific, on the other it breaks with the generic style guide 15:18:12 iiuc, that is a general git rule 15:18:48 sigmavirus24: I think openstack breadth asks for breaking that rule 15:18:49 sigmavirus24: well I think that's the problem ... it gives impression something being VMWare specific, which it might not be 15:19:31 jokke_: that would be a corner case when you change the interface code 15:19:46 I think we need to move on 15:19:51 yeah 15:20:01 Let's discuss this on the docs/comments/email etc 15:20:01 * sigmavirus24 didn't mean for this to be a full discussion at this point in time 15:20:05 email is best 15:20:06 :) 15:20:10 #topic Glance developer documentation 15:20:14 nikhil_k: looking how much we have refactoring around oslo etc. I think it has been more rule than exception for example on our vmware driver lately :P 15:20:33 jokke_: ah ok 15:20:43 yep 15:20:49 mfedosin: any specific inputs on this topic? 15:20:51 https://docs.google.com/a/mirantis.com/document/d/10OVbGkVTYOIF9_SnXHWlupiQBaVGIBtbroP0jewgPsU/edit?usp=sharing 15:20:59 There is not so much currently, but you already can get a picture what it'll be. 15:21:05 mfedosin: need access 15:21:11 mfedosin: it wants access 15:21:19 mfedosin: can you please move that to google domain? 15:21:25 it's on mirantis one, atm 15:21:43 done 15:21:51 sorry :) 15:21:57 np 15:22:18 We started it with Lena last week and there will be 4 or 5 parts. 15:22:21 #link https://docs.google.com/document/d/10OVbGkVTYOIF9_SnXHWlupiQBaVGIBtbroP0jewgPsU/edit 15:22:54 First one about Architecture like http://docs.openstack.org/developer/nova/devref/architecture.html but much better :) 15:23:16 mfedosin: looks pretty nice! 15:23:22 * jokke_ likes the first impression ... thanks1 15:23:27 Second is optional and I have some concerns about its including in the documentation. It's about inner structure of glance utils like scrubber, pruner and replicator. I suppose not so many people need this kind of documentation and if they need, they can easily find out for themselves. 15:23:50 Third is about structure of domain and its layer. Plus there will be Repo API and description of Factory, Gateway and Image class 15:24:11 *layers 15:24:19 mfedosin: this sounds awesome 15:24:19 Forth for what domain model is. Proxy classes and Helpers 15:24:34 I really like the high level view 15:24:48 And the last one describes DB API and organization of the tables. 15:25:22 mfedosin: Looks really good. 15:25:32 This is really great! 15:25:32 thanks, it will be better 15:25:42 We may want to avoid showing DB schema like this (created manually) 15:26:07 this is going to be part of the glance documentation? 15:26:30 If we can get some doc strings on the schema specification in the code, that would be better 15:26:50 While this is really useful, documentation like this tends to go out of sync very quickly if we don't maintain it. That's definitely a cost involved with it 15:26:52 yes, I see 15:27:25 hemanthm, and that's why we have Lena as a technical writer 15:27:33 yeah, also the pipeline makes it difficult to determine the correlation of the doc with the deployment 15:27:46 while there is cost involved I really like that ... this is like first human readable version of what's going on there I've seen ;) 15:28:16 You can look and comment as well as the review guide. Everyone is welcome. 15:28:26 mfedosin++ Lena++ 15:28:52 schema could be generated by raw output from describing it. 15:29:31 yes, but I want it to be pretty looked picture 15:29:59 jokke_: true but human readable does not guarantee the authenticity and that can be bad sometimes 15:30:03 but I agree - maintain all the migrations is annoying 15:30:20 for example the image status transitions are not complete here http://docs.openstack.org/developer/glance/statuses.html 15:30:30 :( 15:31:00 And also I want to know about the timing. Until what date should it be completed? 15:31:11 mfedosin: yes, good point 15:31:26 mfedosin: having it for the kilo release would probably be great 15:31:28 Do we want it in time for the summit so we can show it off? 15:31:41 mfedosin: I don't think we have a _completion_ date however, good to have a small first version (minimal style) 15:31:43 or what kragniz said ;) 15:31:46 13, March? 15:31:55 sure 15:32:14 should we set a k-1 milestone for it before that to solicit feedback on a near-final draft? 15:32:17 sigmavirus24: shipping it with kilo would be kindest to ops :P 15:32:36 k3 you mean? 15:32:37 kragniz: wait, you mean ops aren't just imaginary things? They're real humans? *mindblown* =P 15:32:37 sigmavirus24: k3 you mean? 15:32:54 kragniz: well k-1 would be the milestone for the document, doesn't need to coincide with k-3 15:32:55 it can 15:33:10 I don't think we can timeslide back 15:33:14 sigmavirus24: k1 has been and gone :P 15:33:24 well we're releasing the document for kilo 15:33:32 yes, so k3 15:33:34 the document's development didn't start with the rest of kilo 15:33:41 btw, what will be after Z? 15:33:42 so document-relative k-1 15:33:45 those are informal milestones so do not matter officially 15:33:46 A again? 15:33:54 mfedosin: AA ;) 15:33:59 then AB, then AC =P 15:34:00 then we have to wait 13 years 15:34:05 * sigmavirus24 doesn't actually know 15:34:15 greek characters 15:34:20 we need to move on 15:34:25 nikhil_k: by then certainly everyone will support unicode ;) 15:34:29 nikhil_k, :D 15:34:33 #topic stable/juno requirements sync with global requirements 15:34:47 ativelkov: ? 15:34:51 yup 15:34:57 #link https://review.openstack.org/#/c/154728/ 15:35:25 ah, great 15:35:26 that's capping the requirements (finally) 15:35:40 just wanted to ask what is the correct practice here 15:36:05 ativelkov: bot proposes, we verify that it does not break the hell loose and merge ;) 15:36:25 is that the same for stable branches? 15:36:28 also, we are midful about the release date and freeze time 15:36:35 mindful* 15:37:12 ativelkov: yes mostly because unexpected releases have been breaking things (see: half of oslo and eventlet for examples) 15:37:50 ativelkov: bot proposes to the stable/* just stable team +2+2+A 15:37:55 ativelkov: there was some discussion about not having to maintain 3 branches simultaneously. You might want to be on the lookout there. Try asking in cross project meetings on the upto data info. 15:38:11 got it, thanks 15:38:28 there's also a discussion on the ML about how we maintain stable/* requirements lists in openstack/requirements 15:38:38 nikhil_k: I think the unfortunate reality what has been promised to explore is 4 releases when Kilo comes out :( 15:38:40 (you might notice some of these deps are equivalent to pins) 15:39:07 jokke_: wow, that's not fun! 15:39:10 jokke_: the more releases, the more fun! 15:39:24 can we move one? 15:39:28 nikhil_k: it's transition, but still 15:39:34 I think so 15:39:38 yup 15:39:38 thanks 15:39:39 #topic Abandoning stale PS from review 15:39:45 jokke_: was that you? 15:39:49 yeah 15:40:01 http://comments.gmane.org/gmane.comp.cloud.openstack.devel/46352 15:40:06 https://etherpad.openstack.org/p/glance-cleanout-of-inactive-PS 15:40:43 so Nova is doing this automated (IIUC) after 4 weeks, Swift is sending chase e-mail out after 4 weeks and abandoning manually if no activity in 2 weeks from that 15:41:35 The take from the mailing list and X-project meeting at Tue was that it's reasonable and at least for now there won't be OS wide governing for this 15:41:51 jokke_: I thought nova stopped doing the automated abandon? 15:42:22 kragniz: at least what I understood from sdague's comment at tue it's scripted 15:42:42 kragniz: OS stopped the automatic 2week abandon which was on all 15:42:54 okay 15:42:56 * sigmavirus24 wonders if there's a way to automate a message to the ML asking for sponsors for older patch sets before abandoning 15:43:14 please no, that would create so much spam 15:43:19 sigmavirus24: the question is more can you do that without annoying everyone 15:43:28 sigmavirus24: I'd certainly not spam mailing list with any automation like that 15:43:37 kragniz: it should be obvious that I care not about annoying people ;) 15:43:49 heh 15:44:03 I personally think the older reviews are not causing any trouble 15:44:04 jokke_: worth creating a poll on the ML discussion? 15:44:36 * sigmavirus24 realizes that it's probably best just to set up a collection of dashboards for people to use 15:44:51 also the main concern on the mailing list feedback in short was that someone might hurt their feelings if we drop their change after they have not responded to us for weeks ... which was at least on X-proj meeting pretty much discarded 15:45:10 sigmavirus24: (plug for http://goo.gl/eS05pD) 15:45:14 heh, I think gerrit can support such a filter (but not sure if one already exists/can be enabled) 15:45:47 again using automated filters removes all flexibility and smartness ... makes the situation just worse 15:46:08 If I remember correctly, the concern was also about loosing real user-stories if we abandon something 15:46:20 if someone wakes up at the point when the change gets abandoned there is simple way to restore it without hassle 15:46:45 yes, that's the case. However, if we can omit WIP patch sets from being abandoned then it would solve it, right? 15:47:00 and that can be mentioned in the good practice guideline 15:47:13 We may suggest the reviewers to create a launchpad bug or BP (if relevant) before abandoning the changes, so noce-to-have features remain in backlog 15:47:18 jokke_: yes, but it's a harder for someone else to find it later if it's abandoned 15:47:40 ok, we need to move on 15:47:57 Let's continue on the ML for now and get back on this next week if necessary 15:48:15 #topic Catalog Index service reviews 15:48:25 https://etherpad.openstack.org/p/catalog-index-service 15:48:28 On the follow page is a little diagram showing the patches related to index service: https://etherpad.openstack.org/p/catalog-index-service 15:48:42 You might need to zoom out a bit for the diagram to render correctly 15:48:57 One is really just an update on metadefs functionality (adding notifications), but is pretty much ready: https://review.openstack.org/#/c/148546/ 15:49:06 Others are functionally very close to completion and serious test writing is starting up. 15:49:13 https://review.openstack.org/#/c/148546/ 15:49:18 Would be much better to get reviews now so comments can be addressed before the mad end of cycle zuul rush where it takes multipe days to just check a patch. 15:49:36 cool, so we need reviews 15:49:56 * sigmavirus24 was working on that yesterday I think 15:50:02 #help review catalog index service patches 15:50:31 Thanks! 15:50:31 TravT_: do we have more updates or should we move on? 15:50:40 #topic glanceclient sorting 15:50:55 Please help mfedosin review https://review.openstack.org/#/c/120777/ 15:51:09 That was my addition and that's pretty much it for now. 15:51:36 currently we don't have support for sorting in glance client 15:51:55 mfedosin: when did that break? 15:51:55 this patch implement it 15:52:16 mfedosin: or is our sorting done on the API server end? 15:52:24 in v2 there is no sorting 15:52:41 in client 15:53:09 anyways, we can discuss this on the review itself 15:53:16 #topic Reviews for zero downtime config reload 15:53:36 thanks :) I will be appreciate 15:53:37 I think we need to get some feedback to these folks 15:54:05 https://review.openstack.org/#/c/127238/ 15:54:13 https://review.openstack.org/122181 15:54:23 #topic Open discussion 15:55:01 we need reviews on the last couple of glanceclient patches for the next release 15:55:27 kragniz: do you have links handy so that people can see in the meeting logs? 15:55:29 #link https://launchpad.net/python-glanceclient/+milestone/v0.16.0 15:55:33 cool 15:55:34 nikhil_k: quick update request, what's the status on our client and store releases? 15:55:36 good enough 15:55:46 folks, there is my spec about new sorting syntax https://review.openstack.org/#/c/155841/ can you check it out? 15:55:58 for store we were waiting on stuart's patch for ativelkov 's copy-from fix 15:56:00 also 15:56:05 #link https://review.openstack.org/#/c/157372/ 15:56:17 but we can release today if that's not ready 15:56:19 nikhil_k: stuart's not going to have that ready in time 15:56:24 nikhil_k, reminder: maintainer for glance_store 15:56:26 okay 15:56:34 oh yes 15:56:38 any thoughts on this one would be appreciated: https://review.openstack.org/#/c/154229/ 15:56:47 is anyone willing to volunteer as a maintainer for glance_store repo 15:56:57 A question to sigmavirus24 and rosmaita: are we done with the semver discussion? :) 15:57:02 that way we can have multiple point of contacts for the release process 15:57:19 sigmavirus24: would that be mostly release management? 15:57:22 nikhil_k, I'd be interested 15:57:25 hemanthm, you were interested, right? 15:57:30 okay, thanks 15:57:33 anyone else? 15:57:39 ativelkov: if the plan is to support something in a broader scheme after adding semver (to at least get artifacts rolling) that's fine 15:57:41 nikhil_k: I think I have my hands full with current promises ;) 15:57:51 nikhil_k: I can do release stuff 15:57:56 sigmavirus24: exactly 15:58:06 Otherwise I still object to the fact that we're limiting artifacts versioning to such an extremely narrow group of potential users (since semver has no users at the moment, all users are potential) 15:58:09 ativelkov: it's upto sigmavirus24 now. rosmaita and I are on agreement 15:58:22 s/semver/artifacts/ 15:58:27 jokke_: ok, thanks! 15:58:30 kragniz: noted 15:58:48 #action add kragniz and hemanthm for glance_store release management 15:58:54 nikhil_k: I can help if necessary but it sounds like hemanthm and kragniz are good 15:59:19 nikhil_k: could you please comment on https://review.openstack.org/#/c/151466/ ? It has got 2 +2 but no +A, and it is blocking us 15:59:48 ativelkov: probably people are waiting for the spec to be approved first 15:59:53 we're out of time, so move to #openstack-glance? 15:59:55 ok, time! 15:59:59 Thanks all 16:00:02 ativelkov: yes, I was waiting on the discussion. Thanks for the reminder! 16:00:14 Thanks all.. 16:00:16 #endmeeting