00:01:27 #startmeeting nova-api 00:01:28 Meeting started Fri Jun 6 00:01:27 2014 UTC and is due to finish in 60 minutes. The chair is cyeoh. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:01:29 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 00:01:32 The meeting name has been set to 'nova_api' 00:01:38 Hi - who do we have here today? 00:01:44 hi 00:02:00 hey 00:02:10 hi 00:02:23 hi 00:02:39 ok let's get started 00:02:43 #topic v2.1 on v3 00:03:14 so I brought up v2.1 on v3, microversions and the policy checks in the api nova-specs in the nova meeting today 00:03:27 so hopefully they will get more eyeballs on them over the next few days 00:03:45 cyeoh, thanks 00:04:02 much of the microversion discussion is now to be done at the mid cycle, though we can proceed without v2.1 on v3 without it 00:04:43 hopefully we'll get the v2.1 on v3 stuff spec approved soon so we can start merging 00:05:02 did anyone have anything they want to talk about the v2.1 on v3? 00:05:27 i have one question 00:05:37 since I'm rejoining this after so long 00:06:01 so, the thing is v2.1 on top of v3 adding micro versioning for now on? 00:06:01 maurosr: sure, go ahead! 00:06:25 so the first stage is v2.1 on top of v3 without microversioning 00:06:48 eg a set of "translation" like layers on top of v3 which makes it respond like v2, but with strong input validation 00:06:58 cyeoh: nice plan :-) 00:07:12 right, cause I made a comment on rev 6 of the spec, I was kind of thinking that, since we need to support v2 (with translation layer), why not start with v2, then microversioning, and coverge it to v3 status? 00:07:20 the next step is microversions, so as we slowly roll out v3 type functionality, or say the tasks api, we bump the microversion (this a client request header) 00:07:35 maybe it's silly question, but I'm trying to know the ground here hehe 00:07:55 yep, so we slowly expose more of the v3 functionality (or other new features) through microversions 00:08:22 the goal is throw away the old v2 api code, so we leave that alone as much as possible. That way we get the v3 api framework (plugins, input validation etc) 00:08:23 yeah, got that, 00:08:30 right 00:08:55 just thought that would made easier the effort on support old v2 calls 00:09:26 the most important goal for this cycle is to get v2.1 functionality equivalent to v2 00:09:39 alright, got it 00:09:52 Cyeoh: 1 quick question- are we going to expose the V3 URL/request changes also ? i think those should be then through Major version right? 00:09:55 yea unfortunately starting with the old v2 code is a much riskier proposition because we may accidentally make backwards incompatible changes to v2 00:10:29 but the backwards would be solved by microversioning 00:10:38 GMann: I think we'll probably leave it for now because it makes it easier to leave the tempest regression testing running. Long term, yes it would be via microversions 00:10:48 and sorry, I wasn't involved before and appear here throwing ideas 00:11:16 maurosr: the risk is that because we're changing the v2 api code (and there are lots of internal cleanups) we would accidentally make behavioural changes to the old v2 code 00:11:23 and the regression tests would not pick it up 00:11:25 cyeoh: ok Thanks. 00:11:48 fine, you have a good point 00:12:01 by "freezing" the old v2 api code the risk is a lot lower we can test them side-by-side 00:12:24 in icehouse we ended up making a few backwards incompatible changes accidentally :-( 00:12:50 cyeoh: will you take your time for v2.1 specs today? I'd like to work it together for pushing it earlier. 00:13:41 oomichi: please feel free to an update to the v2.1 spec today if you'd like 00:13:54 cyeoh: thanks, will do it:) 00:14:13 oomichi: thx! 00:14:21 #topic microversions 00:14:42 as I mentioned before much of this discussion has been delayed to the mid-cycle meetup 00:14:58 is anyone here able to attend the mid cycle in person (I'll be attending remotely) 00:16:08 ok I guess we can discuss that later. I'll update the spec in the next few days based on the review feedback (and I need to still do more reading up on how other REST apis do microversions) 00:16:20 but everyone should feel free to update the spec if they're interested too 00:16:48 anything that anyone wants to discuss about microversions? 00:16:57 yes 00:17:09 oomichi: please go ahead 00:17:24 Do additional API parameters break backward compatibilities? 00:17:41 that is a concern about microversion, I feel. 00:17:52 so I think at least for openstack REST APIs people say no 00:18:07 thats what our wiki page says about acceptable changes 00:18:08 imo in the response no, in the request only if they become mandatory 00:18:33 ah, thanks. I agree:) 00:18:36 oh yes that is true (though I was thinking about output rather than input) 00:18:43 *I guess required is the right word hehe 00:18:59 under microversions we'll still be bumping either the global version or minor version though 00:19:14 (depending on which microversion model we take) 00:19:17 agreed 00:19:46 anything else on microversions? 00:19:47 yea, lets discuss it on nova-specs:) 00:20:00 oomichi: sounds good 00:20:23 #topic tasks api 00:21:05 so alaski couldn't make the meeting today, but he asked if we could have another look at his spec for the tasks api 00:21:19 #link https://review.openstack.org/#/c/86938/ 00:22:06 and more specifically around whether a server create should return a task which contains server information, or server information which returns task information 00:22:23 as we need to nail down exactly what the output looks like 00:22:35 so if you can, please go have a look and comment on the spec 00:23:09 yes, will try it also later. 00:23:21 one question 00:23:41 cyeoh: will tasks api also appear on microversion? 00:24:06 yea I imagine it'll be the first big microversion test case 00:24:28 cyeoh: ok, big microversion:-) 00:24:33 we might roll in a really trivial microversion change first just to make sure things are working properly 00:24:47 yep! 00:25:15 I got it, thanks. will see it on this considering. 00:25:33 cool :-) 00:26:08 so I think the rest of the stuff on the agenda is old stuff from previous meetings and a bit out of date. 00:26:14 #topic open discussion 00:26:25 but bring up anything you like now.... 00:27:47 is there anything anyone wants to talk about? Or do we get a short meeting :-) 00:29:14 ok we all get to leave early. thanks everyone! 00:29:20 thanks! 00:29:24 tks, bye 00:29:34 bye 00:29:39 #endmeeting