{"action":"created","comment":{"url":"https://api.github.com/repos/opencontainers/specs/pulls/comments/35930309","id":35930309,"diff_hunk":"@@ -12,19 +12,19 @@ A standard container bundle is made of the following 3 parts:\n \n # Directory layout\n \n-A Standard Container bundle is a directory containing all the content needed to load and run a container. This includes its configuration file (`config.json`) and content directories. The main property of this directory layout is that it can be moved as a unit to another machine and run the same container.\n+A Standard Container bundle is a directory containing all the content needed to load and run a container.\n+This includes two configuration files `config.json` and `runtime.json`, and a rootfs directory.\n+The `config.json` file contains settings that are host independent and application specific such as security permissions, environment variables and arguments.\n+The `runtime.json` file contains settings that are host specific such as memory limits, local device access and mount points.\n+The goal is that the bundle can be moved as a unit to another machine and run the same container if runtime.json is removed or reconfigured.","path":"bundle.md","position":9,"original_position":9,"commit_id":"49ce63d2e2f4c0545d1b54b1e840dbc3ac68dd4b","original_commit_id":"49ce63d2e2f4c0545d1b54b1e840dbc3ac68dd4b","user":{"login":"wking","id":209920,"avatar_url":"https://avatars.githubusercontent.com/u/209920?v=3","gravatar_id":"","url":"https://api.github.com/users/wking","html_url":"https://github.com/wking","followers_url":"https://api.github.com/users/wking/followers","following_url":"https://api.github.com/users/wking/following{/other_user}","gists_url":"https://api.github.com/users/wking/gists{/gist_id}","starred_url":"https://api.github.com/users/wking/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wking/subscriptions","organizations_url":"https://api.github.com/users/wking/orgs","repos_url":"https://api.github.com/users/wking/repos","events_url":"https://api.github.com/users/wking/events{/privacy}","received_events_url":"https://api.github.com/users/wking/received_events","type":"User","site_admin":false},"body":"You're missing backticks around `runtime.json` here.  And I'm having trouble parsing this sentence as a whole, but I'm not sure how to rephrase it to make it read more clearly.","created_at":"2015-07-30T22:48:34Z","updated_at":"2015-07-30T22:48:34Z","html_url":"https://github.com/opencontainers/specs/pull/88#discussion_r35930309","pull_request_url":"https://api.github.com/repos/opencontainers/specs/pulls/88","_links":{"self":{"href":"https://api.github.com/repos/opencontainers/specs/pulls/comments/35930309"},"html":{"href":"https://github.com/opencontainers/specs/pull/88#discussion_r35930309"},"pull_request":{"href":"https://api.github.com/repos/opencontainers/specs/pulls/88"}}},"pull_request":{"url":"https://api.github.com/repos/opencontainers/specs/pulls/88","id":41273772,"html_url":"https://github.com/opencontainers/specs/pull/88","diff_url":"https://github.com/opencontainers/specs/pull/88.diff","patch_url":"https://github.com/opencontainers/specs/pull/88.patch","issue_url":"https://api.github.com/repos/opencontainers/specs/issues/88","number":88,"state":"open","locked":false,"title":"WIP specs: introduce the concept of a runtime.json","user":{"login":"philips","id":33544,"avatar_url":"https://avatars.githubusercontent.com/u/33544?v=3","gravatar_id":"","url":"https://api.github.com/users/philips","html_url":"https://github.com/philips","followers_url":"https://api.github.com/users/philips/followers","following_url":"https://api.github.com/users/philips/following{/other_user}","gists_url":"https://api.github.com/users/philips/gists{/gist_id}","starred_url":"https://api.github.com/users/philips/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/philips/subscriptions","organizations_url":"https://api.github.com/users/philips/orgs","repos_url":"https://api.github.com/users/philips/repos","events_url":"https://api.github.com/users/philips/events{/privacy}","received_events_url":"https://api.github.com/users/philips/received_events","type":"User","site_admin":false},"body":"Based on our discussion in-person yesterday it seems necessary to\r\nseparate the concept of runtime configuration from application\r\nconfiguration. There are a few motivators:\r\n\r\n- To support runtime updates of things like cgroups, rlimits, etc we\r\n  should separate things that are inherently runtime specific from\r\n  things that are static to the application running in the container.\r\n\r\n- To support the goal of being able to move a bundle between hosts we\r\n  should make it clear what parts of the spec are and are not portable\r\n  between hosts so that upon landing on a new host the non-portable\r\n  options may be rewritten or removed.\r\n\r\n- In order to attach a cryptographic identity to a bundle we must not\r\n  include details in the bundle that are host specific.\r\n\r\nThis is a WIP to generate discussion.","created_at":"2015-07-30T19:43:26Z","updated_at":"2015-07-30T22:48:34Z","closed_at":null,"merged_at":null,"merge_commit_sha":"0372975d93cf494b7213feaadb06557172782bda","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/opencontainers/specs/pulls/88/commits","review_comments_url":"https://api.github.com/repos/opencontainers/specs/pulls/88/comments","review_comment_url":"https://api.github.com/repos/opencontainers/specs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/opencontainers/specs/issues/88/comments","statuses_url":"https://api.github.com/repos/opencontainers/specs/statuses/49ce63d2e2f4c0545d1b54b1e840dbc3ac68dd4b","head":{"label":"philips:runtime-vs-app-config","ref":"runtime-vs-app-config","sha":"49ce63d2e2f4c0545d1b54b1e840dbc3ac68dd4b","user":{"login":"philips","id":33544,"avatar_url":"https://avatars.githubusercontent.com/u/33544?v=3","gravatar_id":"","url":"https://api.github.com/users/philips","html_url":"https://github.com/philips","followers_url":"https://api.github.com/users/philips/followers","following_url":"https://api.github.com/users/philips/following{/other_user}","gists_url":"https://api.github.com/users/philips/gists{/gist_id}","starred_url":"https://api.github.com/users/philips/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/philips/subscriptions","organizations_url":"https://api.github.com/users/philips/orgs","repos_url":"https://api.github.com/users/philips/repos","events_url":"https://api.github.com/users/philips/events{/privacy}","received_events_url":"https://api.github.com/users/philips/received_events","type":"User","site_admin":false},"repo":{"id":39853623,"name":"specs","full_name":"philips/specs","owner":{"login":"philips","id":33544,"avatar_url":"https://avatars.githubusercontent.com/u/33544?v=3","gravatar_id":"","url":"https://api.github.com/users/philips","html_url":"https://github.com/philips","followers_url":"https://api.github.com/users/philips/followers","following_url":"https://api.github.com/users/philips/following{/other_user}","gists_url":"https://api.github.com/users/philips/gists{/gist_id}","starred_url":"https://api.github.com/users/philips/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/philips/subscriptions","organizations_url":"https://api.github.com/users/philips/orgs","repos_url":"https://api.github.com/users/philips/repos","events_url":"https://api.github.com/users/philips/events{/privacy}","received_events_url":"https://api.github.com/users/philips/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/philips/specs","description":"Open Container Specifications","fork":true,"url":"https://api.github.com/repos/philips/specs","forks_url":"https://api.github.com/repos/philips/specs/forks","keys_url":"https://api.github.com/repos/philips/specs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/philips/specs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/philips/specs/teams","hooks_url":"https://api.github.com/repos/philips/specs/hooks","issue_events_url":"https://api.github.com/repos/philips/specs/issues/events{/number}","events_url":"https://api.github.com/repos/philips/specs/events","assignees_url":"https://api.github.com/repos/philips/specs/assignees{/user}","branches_url":"https://api.github.com/repos/philips/specs/branches{/branch}","tags_url":"https://api.github.com/repos/philips/specs/tags","blobs_url":"https://api.github.com/repos/philips/specs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/philips/specs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/philips/specs/git/refs{/sha}","trees_url":"https://api.github.com/repos/philips/specs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/philips/specs/statuses/{sha}","languages_url":"https://api.github.com/repos/philips/specs/languages","stargazers_url":"https://api.github.com/repos/philips/specs/stargazers","contributors_url":"https://api.github.com/repos/philips/specs/contributors","subscribers_url":"https://api.github.com/repos/philips/specs/subscribers","subscription_url":"https://api.github.com/repos/philips/specs/subscription","commits_url":"https://api.github.com/repos/philips/specs/commits{/sha}","git_commits_url":"https://api.github.com/repos/philips/specs/git/commits{/sha}","comments_url":"https://api.github.com/repos/philips/specs/comments{/number}","issue_comment_url":"https://api.github.com/repos/philips/specs/issues/comments{/number}","contents_url":"https://api.github.com/repos/philips/specs/contents/{+path}","compare_url":"https://api.github.com/repos/philips/specs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/philips/specs/merges","archive_url":"https://api.github.com/repos/philips/specs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/philips/specs/downloads","issues_url":"https://api.github.com/repos/philips/specs/issues{/number}","pulls_url":"https://api.github.com/repos/philips/specs/pulls{/number}","milestones_url":"https://api.github.com/repos/philips/specs/milestones{/number}","notifications_url":"https://api.github.com/repos/philips/specs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/philips/specs/labels{/name}","releases_url":"https://api.github.com/repos/philips/specs/releases{/id}","created_at":"2015-07-28T19:27:22Z","updated_at":"2015-07-28T19:27:22Z","pushed_at":"2015-07-30T19:42:50Z","git_url":"git://github.com/philips/specs.git","ssh_url":"git@github.com:philips/specs.git","clone_url":"https://github.com/philips/specs.git","svn_url":"https://github.com/philips/specs","homepage":"http://www.opencontainers.org","size":165,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"opencontainers:master","ref":"master","sha":"d619f2fccb13385e5c6bfcbf3ac1a3dcd36f314b","user":{"login":"opencontainers","id":12563465,"avatar_url":"https://avatars.githubusercontent.com/u/12563465?v=3","gravatar_id":"","url":"https://api.github.com/users/opencontainers","html_url":"https://github.com/opencontainers","followers_url":"https://api.github.com/users/opencontainers/followers","following_url":"https://api.github.com/users/opencontainers/following{/other_user}","gists_url":"https://api.github.com/users/opencontainers/gists{/gist_id}","starred_url":"https://api.github.com/users/opencontainers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opencontainers/subscriptions","organizations_url":"https://api.github.com/users/opencontainers/orgs","repos_url":"https://api.github.com/users/opencontainers/repos","events_url":"https://api.github.com/users/opencontainers/events{/privacy}","received_events_url":"https://api.github.com/users/opencontainers/received_events","type":"Organization","site_admin":false},"repo":{"id":36960293,"name":"specs","full_name":"opencontainers/specs","owner":{"login":"opencontainers","id":12563465,"avatar_url":"https://avatars.githubusercontent.com/u/12563465?v=3","gravatar_id":"","url":"https://api.github.com/users/opencontainers","html_url":"https://github.com/opencontainers","followers_url":"https://api.github.com/users/opencontainers/followers","following_url":"https://api.github.com/users/opencontainers/following{/other_user}","gists_url":"https://api.github.com/users/opencontainers/gists{/gist_id}","starred_url":"https://api.github.com/users/opencontainers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opencontainers/subscriptions","organizations_url":"https://api.github.com/users/opencontainers/orgs","repos_url":"https://api.github.com/users/opencontainers/repos","events_url":"https://api.github.com/users/opencontainers/events{/privacy}","received_events_url":"https://api.github.com/users/opencontainers/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/opencontainers/specs","description":"Open Container Specifications","fork":false,"url":"https://api.github.com/repos/opencontainers/specs","forks_url":"https://api.github.com/repos/opencontainers/specs/forks","keys_url":"https://api.github.com/repos/opencontainers/specs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/opencontainers/specs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/opencontainers/specs/teams","hooks_url":"https://api.github.com/repos/opencontainers/specs/hooks","issue_events_url":"https://api.github.com/repos/opencontainers/specs/issues/events{/number}","events_url":"https://api.github.com/repos/opencontainers/specs/events","assignees_url":"https://api.github.com/repos/opencontainers/specs/assignees{/user}","branches_url":"https://api.github.com/repos/opencontainers/specs/branches{/branch}","tags_url":"https://api.github.com/repos/opencontainers/specs/tags","blobs_url":"https://api.github.com/repos/opencontainers/specs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/opencontainers/specs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/opencontainers/specs/git/refs{/sha}","trees_url":"https://api.github.com/repos/opencontainers/specs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/opencontainers/specs/statuses/{sha}","languages_url":"https://api.github.com/repos/opencontainers/specs/languages","stargazers_url":"https://api.github.com/repos/opencontainers/specs/stargazers","contributors_url":"https://api.github.com/repos/opencontainers/specs/contributors","subscribers_url":"https://api.github.com/repos/opencontainers/specs/subscribers","subscription_url":"https://api.github.com/repos/opencontainers/specs/subscription","commits_url":"https://api.github.com/repos/opencontainers/specs/commits{/sha}","git_commits_url":"https://api.github.com/repos/opencontainers/specs/git/commits{/sha}","comments_url":"https://api.github.com/repos/opencontainers/specs/comments{/number}","issue_comment_url":"https://api.github.com/repos/opencontainers/specs/issues/comments{/number}","contents_url":"https://api.github.com/repos/opencontainers/specs/contents/{+path}","compare_url":"https://api.github.com/repos/opencontainers/specs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/opencontainers/specs/merges","archive_url":"https://api.github.com/repos/opencontainers/specs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/opencontainers/specs/downloads","issues_url":"https://api.github.com/repos/opencontainers/specs/issues{/number}","pulls_url":"https://api.github.com/repos/opencontainers/specs/pulls{/number}","milestones_url":"https://api.github.com/repos/opencontainers/specs/milestones{/number}","notifications_url":"https://api.github.com/repos/opencontainers/specs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/opencontainers/specs/labels{/name}","releases_url":"https://api.github.com/repos/opencontainers/specs/releases{/id}","created_at":"2015-06-05T23:30:10Z","updated_at":"2015-07-30T20:20:38Z","pushed_at":"2015-07-30T20:48:23Z","git_url":"git://github.com/opencontainers/specs.git","ssh_url":"git@github.com:opencontainers/specs.git","clone_url":"https://github.com/opencontainers/specs.git","svn_url":"https://github.com/opencontainers/specs","homepage":"http://www.opencontainers.org","size":663,"stargazers_count":333,"watchers_count":333,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":45,"mirror_url":null,"open_issues_count":23,"forks":45,"open_issues":23,"watchers":333,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/opencontainers/specs/pulls/88"},"html":{"href":"https://github.com/opencontainers/specs/pull/88"},"issue":{"href":"https://api.github.com/repos/opencontainers/specs/issues/88"},"comments":{"href":"https://api.github.com/repos/opencontainers/specs/issues/88/comments"},"review_comments":{"href":"https://api.github.com/repos/opencontainers/specs/pulls/88/comments"},"review_comment":{"href":"https://api.github.com/repos/opencontainers/specs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/opencontainers/specs/pulls/88/commits"},"statuses":{"href":"https://api.github.com/repos/opencontainers/specs/statuses/49ce63d2e2f4c0545d1b54b1e840dbc3ac68dd4b"}}}}