{"action":"created","comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments/26276627","id":26276627,"diff_hunk":"@@ -55,3 +55,11 @@ _Why not just run multiple programs in a single (Docker) container?_\n _Why not support affinity-based co-scheduling of containers?_\n \n That approach would provide co-location, but would not provide most of the benefits of pods, such as resource sharing, IPC, guaranteed fate sharing, and simplified management.\n+\n+## Durability of pods (or lack thereof)\n+\n+Pods should never be treated as durable pets. They won't survive scheduling failures, node failures, or other evictions, such as due to lack of resources or for node maintenance. In general, users shouldn't create pods directly. They should almost always use controllers (e.g., replication controller), even for singletons.\n+\n+Pod is exposed as a primitive to facilitate writing schedulers, controllers, etc., to facilitate bootstrapping, for separation of concerns -- Kubelet vs. cluster-level components, to facilitate decoupling of replication controllers and services, and so that replication controllers and other similar controllers don't need to proxy pod-level operations.\n+\n+The right solution for pets is something like nominal services [#260](https://github.com/GoogleCloudPlatform/kubernetes/issues/260). We expect controllers to replace pods in advance of their termination and certainly in advance of deletion (e.g., for planned evictions, image prefetching, unidling, or live pod migration [#3949](https://github.com/GoogleCloudPlatform/kubernetes/issues/3949)).","path":"docs/pods.md","position":11,"original_position":11,"commit_id":"128a73cae8fe1db77e28641d9be227c4bd807793","original_commit_id":"128a73cae8fe1db77e28641d9be227c4bd807793","user":{"login":"thockin","id":5595220,"avatar_url":"https://avatars.githubusercontent.com/u/5595220?v=3","gravatar_id":"","url":"https://api.github.com/users/thockin","html_url":"https://github.com/thockin","followers_url":"https://api.github.com/users/thockin/followers","following_url":"https://api.github.com/users/thockin/following{/other_user}","gists_url":"https://api.github.com/users/thockin/gists{/gist_id}","starred_url":"https://api.github.com/users/thockin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thockin/subscriptions","organizations_url":"https://api.github.com/users/thockin/orgs","repos_url":"https://api.github.com/users/thockin/repos","events_url":"https://api.github.com/users/thockin/events{/privacy}","received_events_url":"https://api.github.com/users/thockin/received_events","type":"User","site_admin":false},"body":"I have a small problem saying \"the right solution\" and then linking to something that isn't implemented.","created_at":"2015-03-12T03:43:10Z","updated_at":"2015-03-12T03:43:10Z","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/5353#discussion_r26276627","pull_request_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353","_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments/26276627"},"html":{"href":"https://github.com/GoogleCloudPlatform/kubernetes/pull/5353#discussion_r26276627"},"pull_request":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353"}}},"pull_request":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353","id":31005887,"html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/5353","diff_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/5353.diff","patch_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/5353.patch","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/5353","number":5353,"state":"open","locked":false,"title":"Clarified expectations for pods.","user":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"body":"Motivated by #5335 and #5334.\r\n","created_at":"2015-03-12T03:33:57Z","updated_at":"2015-03-12T03:43:10Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7302ffcc1e0a13b0a280ea814a1979995c74379e","assignee":{"login":"lavalamp","id":647318,"avatar_url":"https://avatars.githubusercontent.com/u/647318?v=3","gravatar_id":"","url":"https://api.github.com/users/lavalamp","html_url":"https://github.com/lavalamp","followers_url":"https://api.github.com/users/lavalamp/followers","following_url":"https://api.github.com/users/lavalamp/following{/other_user}","gists_url":"https://api.github.com/users/lavalamp/gists{/gist_id}","starred_url":"https://api.github.com/users/lavalamp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lavalamp/subscriptions","organizations_url":"https://api.github.com/users/lavalamp/orgs","repos_url":"https://api.github.com/users/lavalamp/repos","events_url":"https://api.github.com/users/lavalamp/events{/privacy}","received_events_url":"https://api.github.com/users/lavalamp/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353/commits","review_comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353/comments","review_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments{/number}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/5353/comments","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/128a73cae8fe1db77e28641d9be227c4bd807793","head":{"label":"bgrant0607:docfix","ref":"docfix","sha":"128a73cae8fe1db77e28641d9be227c4bd807793","user":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"repo":{"id":23933470,"name":"kubernetes","full_name":"bgrant0607/kubernetes","owner":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/bgrant0607/kubernetes","description":"Container Cluster Manager","fork":true,"url":"https://api.github.com/repos/bgrant0607/kubernetes","forks_url":"https://api.github.com/repos/bgrant0607/kubernetes/forks","keys_url":"https://api.github.com/repos/bgrant0607/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bgrant0607/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bgrant0607/kubernetes/teams","hooks_url":"https://api.github.com/repos/bgrant0607/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/bgrant0607/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/bgrant0607/kubernetes/events","assignees_url":"https://api.github.com/repos/bgrant0607/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/bgrant0607/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/bgrant0607/kubernetes/tags","blobs_url":"https://api.github.com/repos/bgrant0607/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bgrant0607/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bgrant0607/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/bgrant0607/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bgrant0607/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/bgrant0607/kubernetes/languages","stargazers_url":"https://api.github.com/repos/bgrant0607/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/bgrant0607/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/bgrant0607/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/bgrant0607/kubernetes/subscription","commits_url":"https://api.github.com/repos/bgrant0607/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/bgrant0607/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/bgrant0607/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/bgrant0607/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/bgrant0607/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/bgrant0607/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bgrant0607/kubernetes/merges","archive_url":"https://api.github.com/repos/bgrant0607/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bgrant0607/kubernetes/downloads","issues_url":"https://api.github.com/repos/bgrant0607/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/bgrant0607/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/bgrant0607/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/bgrant0607/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bgrant0607/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/bgrant0607/kubernetes/releases{/id}","created_at":"2014-09-11T19:55:59Z","updated_at":"2015-01-20T22:09:04Z","pushed_at":"2015-03-12T03:32:49Z","git_url":"git://github.com/bgrant0607/kubernetes.git","ssh_url":"git@github.com:bgrant0607/kubernetes.git","clone_url":"https://github.com/bgrant0607/kubernetes.git","svn_url":"https://github.com/bgrant0607/kubernetes","homepage":null,"size":33501,"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":"GoogleCloudPlatform:master","ref":"master","sha":"996f9e6710e5e755baa2836cd4e3d9eb930e9a86","user":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"repo":{"id":20580498,"name":"kubernetes","full_name":"GoogleCloudPlatform/kubernetes","owner":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/GoogleCloudPlatform/kubernetes","description":"Container Cluster Manager from Google","fork":false,"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes","forks_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/forks","keys_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/teams","hooks_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/events","assignees_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/tags","blobs_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/languages","stargazers_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/subscription","commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/merges","archive_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/downloads","issues_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/releases{/id}","created_at":"2014-06-06T22:56:04Z","updated_at":"2015-03-12T03:26:38Z","pushed_at":"2015-03-12T02:52:49Z","git_url":"git://github.com/GoogleCloudPlatform/kubernetes.git","ssh_url":"git@github.com:GoogleCloudPlatform/kubernetes.git","clone_url":"https://github.com/GoogleCloudPlatform/kubernetes.git","svn_url":"https://github.com/GoogleCloudPlatform/kubernetes","homepage":"http://kubernetes.io","size":99860,"stargazers_count":6541,"watchers_count":6541,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1187,"mirror_url":null,"open_issues_count":766,"forks":1187,"open_issues":766,"watchers":6541,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353"},"html":{"href":"https://github.com/GoogleCloudPlatform/kubernetes/pull/5353"},"issue":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/5353"},"comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/5353/comments"},"review_comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353/comments"},"review_comment":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/5353/commits"},"statuses":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/128a73cae8fe1db77e28641d9be227c4bd807793"}}}}