{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/comments/68267425","id":68267425,"diff_hunk":"@@ -0,0 +1,269 @@\n+---\n+---\n+\n+* TOC\n+{:toc}\n+\n+__Terminology and conventions__\n+\n+Throughout this doc you will see a few terms that are sometimes used interchangeably elsewhere, that might cause confusion. This section attempts to clarify them.\n+\n+* Node: A single virtual or physical machine in a Kubernetes cluster.\n+* Cluster: A group of nodes in a single failure domain, unless mentioned otherwise.\n+* Persistent Volume Claim: A request for storage, typically a [persistent volume](/docs/user-guide/persistent-volumes/walkthrough.md).\n+* Host name: The hostname attached to the UTS namespace of the pod, i.e the output of `hostname` in the pod.\n+* DNS/Domain name: A *cluster local* domain name resolvable using standard methods (eg: [gethostbyname](http://linux.die.net/man/3/gethostbyname)).\n+* Ordinality: the proprety of being \"ordinal\", or occupying a position in a sequence.\n+* Pet: a single member of a Pet Set; more generally, a stateful application.\n+* Peer: a process running a server, capable of communicating with other such processes.\n+\n+__Prerequisites__\n+\n+This doc assumes familiarity with the following Kubernetes concepts:\n+\n+* [Pods](/docs/user-guide/gc/pods/single-container.md)\n+* [Cluster DNS](/docs/admin/dns.md)\n+* [Headless Services](/docs/user-guide/gc/services/#headless-services)\n+* [Persistent Volumes](/docs/user-guide/gc/volumes.md)\n+* [Dynamic volume provisioning](http://releases.k8s.io/{{page.githubbranch}}/examples/experimental/persistent-volume-provisioning/README.md)\n+\n+You need a working Kubernetes cluster at version >= 1.3, with a healthy DNS [cluster addon](http://releases.k8s.io/{{page.githubbranch}}/cluster/addons/README.md) at version >= 15. You cannot use Pet Set on a hosted Kubernetes provider that has disabled `alpha` resources.\n+\n+## What is a Pet Set?\n+\n+In Kubernetes, most pod management abstractions group them into disposable units of work that compose a micro service. Replication controllers for example, are designed with a weak guarantee - that there should be N replicas of a particular pod template. The pods are treated as stateless units, if one of them is unhealthy or superseded by a better version, the system just disposes it.","path":"docs/user-guide/petset.md","position":34,"original_position":34,"commit_id":"e707733a1fc49f528e9602be51a19afc6b4d8785","original_commit_id":"e707733a1fc49f528e9602be51a19afc6b4d8785","user":{"login":"pwittrock","id":7882754,"avatar_url":"https://avatars.githubusercontent.com/u/7882754?v=3","gravatar_id":"","url":"https://api.github.com/users/pwittrock","html_url":"https://github.com/pwittrock","followers_url":"https://api.github.com/users/pwittrock/followers","following_url":"https://api.github.com/users/pwittrock/following{/other_user}","gists_url":"https://api.github.com/users/pwittrock/gists{/gist_id}","starred_url":"https://api.github.com/users/pwittrock/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pwittrock/subscriptions","organizations_url":"https://api.github.com/users/pwittrock/orgs","repos_url":"https://api.github.com/users/pwittrock/repos","events_url":"https://api.github.com/users/pwittrock/events{/privacy}","received_events_url":"https://api.github.com/users/pwittrock/received_events","type":"User","site_admin":false},"body":"nit:\r\n\r\ns/better version/newer version/","created_at":"2016-06-23T16:28:49Z","updated_at":"2016-06-23T16:28:49Z","html_url":"https://github.com/kubernetes/kubernetes.github.io/pull/698#discussion_r68267425","pull_request_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698","_links":{"self":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/comments/68267425"},"html":{"href":"https://github.com/kubernetes/kubernetes.github.io/pull/698#discussion_r68267425"},"pull_request":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698"}}},"pull_request":{"url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698","id":74654307,"html_url":"https://github.com/kubernetes/kubernetes.github.io/pull/698","diff_url":"https://github.com/kubernetes/kubernetes.github.io/pull/698.diff","patch_url":"https://github.com/kubernetes/kubernetes.github.io/pull/698.patch","issue_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues/698","number":698,"state":"open","locked":false,"title":"Petset 1.3 documentation.","user":{"login":"bprashanth","id":10927820,"avatar_url":"https://avatars.githubusercontent.com/u/10927820?v=3","gravatar_id":"","url":"https://api.github.com/users/bprashanth","html_url":"https://github.com/bprashanth","followers_url":"https://api.github.com/users/bprashanth/followers","following_url":"https://api.github.com/users/bprashanth/following{/other_user}","gists_url":"https://api.github.com/users/bprashanth/gists{/gist_id}","starred_url":"https://api.github.com/users/bprashanth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bprashanth/subscriptions","organizations_url":"https://api.github.com/users/bprashanth/orgs","repos_url":"https://api.github.com/users/bprashanth/repos","events_url":"https://api.github.com/users/bprashanth/events{/privacy}","received_events_url":"https://api.github.com/users/bprashanth/received_events","type":"User","site_admin":false},"body":"Still very much a wip. I'm uploading in case @erictune @matchstick @smarterclayton want to take a look because I need to context switch to a higher prio bug that recently cropped up.\r\n\r\nI get the feeling this might be too bulky for a user doc, but there's so much to say. This is more a dump of all I think it should contain, open to opinions on what we should shave off. ","created_at":"2016-06-21T17:36:49Z","updated_at":"2016-06-23T16:28:49Z","closed_at":null,"merged_at":null,"merge_commit_sha":"df8d4581f622e92e2cb2a55d6ec2018e4af42fb7","assignee":{"login":"smarterclayton","id":1163175,"avatar_url":"https://avatars.githubusercontent.com/u/1163175?v=3","gravatar_id":"","url":"https://api.github.com/users/smarterclayton","html_url":"https://github.com/smarterclayton","followers_url":"https://api.github.com/users/smarterclayton/followers","following_url":"https://api.github.com/users/smarterclayton/following{/other_user}","gists_url":"https://api.github.com/users/smarterclayton/gists{/gist_id}","starred_url":"https://api.github.com/users/smarterclayton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/smarterclayton/subscriptions","organizations_url":"https://api.github.com/users/smarterclayton/orgs","repos_url":"https://api.github.com/users/smarterclayton/repos","events_url":"https://api.github.com/users/smarterclayton/events{/privacy}","received_events_url":"https://api.github.com/users/smarterclayton/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698/commits","review_comments_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698/comments","review_comment_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues/698/comments","statuses_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/statuses/e707733a1fc49f528e9602be51a19afc6b4d8785","head":{"label":"bprashanth:petset_1.3","ref":"petset_1.3","sha":"e707733a1fc49f528e9602be51a19afc6b4d8785","user":{"login":"bprashanth","id":10927820,"avatar_url":"https://avatars.githubusercontent.com/u/10927820?v=3","gravatar_id":"","url":"https://api.github.com/users/bprashanth","html_url":"https://github.com/bprashanth","followers_url":"https://api.github.com/users/bprashanth/followers","following_url":"https://api.github.com/users/bprashanth/following{/other_user}","gists_url":"https://api.github.com/users/bprashanth/gists{/gist_id}","starred_url":"https://api.github.com/users/bprashanth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bprashanth/subscriptions","organizations_url":"https://api.github.com/users/bprashanth/orgs","repos_url":"https://api.github.com/users/bprashanth/repos","events_url":"https://api.github.com/users/bprashanth/events{/privacy}","received_events_url":"https://api.github.com/users/bprashanth/received_events","type":"User","site_admin":false},"repo":{"id":53696895,"name":"kubernetes.github.io","full_name":"bprashanth/kubernetes.github.io","owner":{"login":"bprashanth","id":10927820,"avatar_url":"https://avatars.githubusercontent.com/u/10927820?v=3","gravatar_id":"","url":"https://api.github.com/users/bprashanth","html_url":"https://github.com/bprashanth","followers_url":"https://api.github.com/users/bprashanth/followers","following_url":"https://api.github.com/users/bprashanth/following{/other_user}","gists_url":"https://api.github.com/users/bprashanth/gists{/gist_id}","starred_url":"https://api.github.com/users/bprashanth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bprashanth/subscriptions","organizations_url":"https://api.github.com/users/bprashanth/orgs","repos_url":"https://api.github.com/users/bprashanth/repos","events_url":"https://api.github.com/users/bprashanth/events{/privacy}","received_events_url":"https://api.github.com/users/bprashanth/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/bprashanth/kubernetes.github.io","description":"Website/documentation repo","fork":true,"url":"https://api.github.com/repos/bprashanth/kubernetes.github.io","forks_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/forks","keys_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/teams","hooks_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/hooks","issue_events_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/events","assignees_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/tags","blobs_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/languages","stargazers_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/stargazers","contributors_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/contributors","subscribers_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/subscribers","subscription_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/subscription","commits_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/merges","archive_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/downloads","issues_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/labels{/name}","releases_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/bprashanth/kubernetes.github.io/deployments","created_at":"2016-03-11T21:08:18Z","updated_at":"2016-03-11T21:08:20Z","pushed_at":"2016-06-23T03:29:32Z","git_url":"git://github.com/bprashanth/kubernetes.github.io.git","ssh_url":"git@github.com:bprashanth/kubernetes.github.io.git","clone_url":"https://github.com/bprashanth/kubernetes.github.io.git","svn_url":"https://github.com/bprashanth/kubernetes.github.io","homepage":null,"size":36723,"stargazers_count":0,"watchers_count":0,"language":"HTML","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":"kubernetes:release-1.3","ref":"release-1.3","sha":"ce6bf3d9c25e1c9b275839a79558824b1dd91aa1","user":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"repo":{"id":51478266,"name":"kubernetes.github.io","full_name":"kubernetes/kubernetes.github.io","owner":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kubernetes/kubernetes.github.io","description":"Website/documentation repo","fork":false,"url":"https://api.github.com/repos/kubernetes/kubernetes.github.io","forks_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/forks","keys_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/teams","hooks_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/hooks","issue_events_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/events","assignees_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/tags","blobs_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/languages","stargazers_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/stargazers","contributors_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/contributors","subscribers_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/subscribers","subscription_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/subscription","commits_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/merges","archive_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/downloads","issues_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/labels{/name}","releases_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/kubernetes/kubernetes.github.io/deployments","created_at":"2016-02-10T22:46:48Z","updated_at":"2016-06-22T16:07:56Z","pushed_at":"2016-06-23T15:51:58Z","git_url":"git://github.com/kubernetes/kubernetes.github.io.git","ssh_url":"git@github.com:kubernetes/kubernetes.github.io.git","clone_url":"https://github.com/kubernetes/kubernetes.github.io.git","svn_url":"https://github.com/kubernetes/kubernetes.github.io","homepage":null,"size":37534,"stargazers_count":50,"watchers_count":50,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":302,"mirror_url":null,"open_issues_count":290,"forks":302,"open_issues":290,"watchers":50,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698"},"html":{"href":"https://github.com/kubernetes/kubernetes.github.io/pull/698"},"issue":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues/698"},"comments":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/issues/698/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698/comments"},"review_comment":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/pulls/698/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes/kubernetes.github.io/statuses/e707733a1fc49f528e9602be51a19afc6b4d8785"}}}}
{"actor":{"display_login":"pwittrock"}}