18:01:28 #startmeeting 2015-12-2 discussion 18:01:28 Meeting started Wed Dec 2 18:01:28 2015 UTC. The chair is vbatts. Information about MeetBot at http://wiki.debian.org/MeetBot. 18:01:28 Useful Commands: #action #agreed #help #info #idea #link #topic. 18:01:28 The meeting name has been set to '2015_12_2_discussion' 18:02:06 crosbymichael: lk4d4: dqminh: philips: tianon: Joining? 18:02:30 I’m at the airport so going to try to keep talking to a minimum 18:02:39 duglin: okay, no worries 18:03:43 #topic state location 18:04:02 https://groups.google.com/a/opencontainers.org/forum/#!topic/dev/q6TYqVZOcX8 18:04:16 #info List thread: https://groups.google.com/a/opencontainers.org/forum/#!topic/dev/q6TYqVZOcX8 18:05:30 #info Command line API thread: https://groups.google.com/a/opencontainers.org/forum/#!topic/dev/BIxya5eSNLo 18:07:29 IMO it all comes down to what level of interop we’re supposed to define - if none then our value decreases 18:10:17 jlb13 and vbatts suggesting a command-line API (or whatever, could be REST) spec associated with a lifecycle spec 18:10:56 vbatts prefers REST to a command-line API spec 18:11:10 we could do a rest api but then are we really signing up to define an entire http server? 18:11:22 julz concerned about performance over REST 18:11:33 I'm not sure how terminal-binding would work over REST 18:11:40 I think sh <-> http mapping is pretty straightforward 18:12:22 lk4d4: yeah, agree 18:12:40 if we don’t do a REST APIs and we don’t do a cmd, what other option is there? All I can think of is the filesystem like we do today 18:13:03 so, I think "actions" discussion is more valuable for spec :) 18:13:13 mrunalp: provide the minimal command-line API for testing, and then you're free to provide other APIs as you see fit 18:13:19 lk4d4: sure but how are those actions exposed? 18:13:54 #chairs mrunalp wking RobDolinMS 18:13:58 #chair mrunalp wking RobDolinMS 18:13:58 Current chairs: RobDolinMS mrunalp vbatts wking 18:14:00 duglin: whatever way you desire I think, but if you want to be replaceable with runc - you have no choice :) 18:14:12 duglin: Yeah, it is abstract but testing needs more concrete inputs 18:14:21 mrunalp: maybe base command-line API work on duglin's actions: https://github.com/opencontainers/specs/pull/225 18:14:43 abstract spec with a compliant implementation example 18:15:02 mikebrow: That is runc in a way but others just have to copy it 18:15:29 not sure I understand what “minimal cmd-line API for testing” really is because it sure sounds like we’re defining a cmd line just trying to avoid calling it that. 18:15:54 duglin: I agree :) 18:16:01 it's cli or not 18:16:05 yup 18:16:10 ^ yup 18:16:14 duglin: "minimal" just means, "your runtime can add additional stuff if you want, but you must support at least this command-line API" 18:16:25 your additional stuff doesn't need to be CLI 18:16:34 yes, maybe with some sort of way of saying it's a vendor option? 18:16:39 perhaps we should list the options here: 1) filesystem, 2) rest 3) cmd line 4) nothing and just define abstract action. Anything else? 18:17:00 duglin: I think this discussion is more general, not just about /run/opencontainer/containers 18:17:00 although 1 may still need 2 or 3 18:17:20 1 is just for sharing state, not necessarily actions 18:17:25 yeah 18:17:51 so for actions, rest vs cmd line, is there anything else? 18:18:39 gRpc, whatever :) 18:18:42 a lot of options 18:18:57 but ones we want to consider 18:19:09 but I think actions is just keyword + config, which can be mapped to any scheme 18:19:50 I like cmdline better 18:19:57 lk4d4: you are suggesting something like for e.g. action 18:20:00 ? 18:20:08 A simple cmdline like runc isn't bad 18:20:14 yes 18:20:32 I think just nature of spec is supposing local execution rather than "remote" 18:20:49 so, cli more natural :) 18:21:01 so back to state, do we want to have a “query” type of action? 18:21:01 lk4d4: Agree 18:21:11 REST could be added on top if one wants 18:21:13 lk4d4: xactly, yeah 18:21:16 and then leave state management up to the impl? 18:21:18 yep, sure 18:21:19 if there will be cases for it 18:21:31 I think yeah, but I'd prefer just query, not list, personally 18:21:32 #link https://gist.github.com/wking/1d69118ba8b750f85bfc 18:21:40 I think getting in to listing is probably higher level, personally 18:21:40 "query" and "push"? 18:21:50 ^ my WIP based on julz initial work for the command line API 18:22:17 i agree duglin, i was thinking mgmt would be an upper layer concern 18:22:23 mrunal: We should have a CL runtime state 18:22:47 doug: Is this a query action that returns data or where to go find it? 18:23:04 I think returining the data in defined json form would be good 18:23:13 definitely 18:23:20 yea, location of data isn’t ideal to me - just return the data 18:23:54 of course we may need to deal with notifications at some point but I think that can be thought of after we define query 18:24:22 kk query option 18:24:45 I’m still hearing conflicting statements on the phone. 18:25:05 we don’t need to talk about priv. if “query” returns state 18:25:14 Jesse: There's a higher-level question here: how much of multiple instance state management will the CLI be responsible for? 18:25:58 jesse: strongly agree with that, runc should be 1:1 with a container, to me 18:26:11 if it blocks then it seems we must support a 2nd instance of the exe being able to share state with the 1st. 18:26:17 yeah, I'm in favor of not handling state management in OCI 18:26:29 higher level can always plug it in via hooks 18:26:43 wking: what is management? 18:26:45 I’d prefer to leave this as an impl detail - as long as “some exe” can return state of a container I asked for then that’s enough. 18:26:58 duglin: that was my thoughts too 18:27:16 but I do think “query” needs to return “list of containers” because if 3rd party tool comes in late then it needs ot know what’s already running. 18:27:25 lk4d4: duglin points out that a 'func state --id ' command would have to get information from another func process 18:27:31 Agree, 1:1 minimum requirement 18:27:33 so for tools like cadvisor, how will it discover applications in the system if we pun this to upper layer ? 18:27:35 duglin: lk4d4: Yeah agree on that 18:27:51 passing that information between func processes is "state management" (or whatever, happy to use other terminology" 18:28:48 dqminh: imo that's a problem for a higher level spec/tool 18:28:56 jlb13: runtime implementation is much simpler if we punt state management to a higher layer 18:29:07 leaving to the higher level leaves me wondering how we find out what’s running? If we say “ask the higher level” then the point of interop will be at that level not OCI 18:29:24 duglin: docker starts runc wiht --id and stores it in a list 18:29:24 duglin: yeah, or put your own hooks in to keep track 18:29:36 punt at the spec level but we can still implement a simple management example in runc 18:29:37 It can then use that id to interact with that container 18:29:39 ? 18:29:40 wking: I don't think it will be easy 18:29:54 what if you reconnecting to existing runc processes? 18:29:58 right, docker/cloudfoundry/kube etc. can all support a list command and just pass it to cadvisor, I don' 18:30:05 t think it's a huge deal if that isn't specified 18:30:19 but wherever it's specified shouldn't be oci, to me 18:30:22 yeah, list is okay 18:30:26 yeah, that's how we do it with docker - docker manages its container instances, which are created/started/stopped by runz 18:30:27 lk4d4: I posted the content for emulating /runc/ in https://groups.google.com/a/opencontainers.org/d/msg/dev/q6TYqVZOcX8/GQs0zkRHBwAJ 18:30:34 so tying https://github.com/opencontainers/specs/blob/master/ROADMAP.md#define-standard-container-actions and https://github.com/opencontainers/specs/blob/master/ROADMAP.md#full-lifecycle-hooks together? 18:30:36 * emulating /run/opencontainer 18:30:42 like oci state $(oci list) 18:30:50 'cos at the end of the day, all of those high level tools will have to have a way to list anyway, and I doubt any of them want to delegate that down 18:31:04 right. 18:31:47 my personal opinion is that list crucial if we have no standard state storage 18:32:02 not sure how do to “list containers” with hooks 18:32:44 there is no way 18:32:50 a registry hook 18:33:04 wking: but how do we get interop on “list” ? 18:33:08 what if my "registry" app crashed badly? 18:33:13 if each hook stores it differently 18:33:20 only tool can be source of truth 18:33:28 registry could be a file 18:33:44 duglin: why do you need interop on list? 18:33:45 hehe 18:34:00 #topic Updates on Roadmap 18:34:02 yeah, files exactly what we want to avoid with dropping standard way of storing 18:34:03 so some 3rd party tool can know what to monitor 18:34:24 duglin: you can tell the 3rd party tools what to monitor (so push to them, instead of having them poll) 18:34:27 eggzactly 18:34:38 mrunal: Lifecycle PR is close to being ready to merge 18:34:50 mrunal: OCI Tools coming along nicely 18:34:51 right, so the interop point becomes with the higher level not OCI 18:35:01 #link https://github.com/opencontainers/specs/pull/231 18:35:10 if all interactions end up going thru the higher tool why do I need interop on OCI’s cmd line 18:35:30 "keeping a list of containers" is not "all interactions" ;) 18:35:38 I think interop almost has to be higher level, like what if I want to cadvisor only files owned by a certain user? are we going to get in to filtering and other things? 18:35:44 mrunal: we have some agreement, who will work on this? 18:35:47 files->containers 18:35:51 I agree with Doug here 18:35:51 Doug: I'll work with Trevor 18:35:55 Jesse: I'm in to help too 18:36:00 #action duglin work on command-line API 18:36:02 oci tool always will have containers list 18:36:06 #action wking work on command-line API 18:36:19 and it will be definitely more precise than any other list 18:36:21 #action jlb13 work on command-line API 18:36:21 I think the idea was just to have a few helper examples of higher level management implementations to make oci useful without one of the higher level tools 18:36:37 samples 18:36:53 Vincent: What's the point of adding multiple owners? 18:36:57 if you want an OCI wrapper that gives you a list of containers that seems very easy to build on top of a defined standardised command line 18:37:06 without the command line having to pick up the ability to manage that state 18:37:24 no need even for hooks, just wrap the binary you call 18:38:33 Vincent: Ideal to have one owner and additional participants 18:38:41 Vishnu: I"m just back from travel 18:39:20 #endmeeting