{"action":"created","comment":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/23458678","id":23458678,"diff_hunk":"@@ -9,30 +9,43 @@\n \n toc::[]\n \n-== Master\n+Kubernetes is a system for managing containerized applications across a set of containers or hosts, providing deployment, maintenence, and application-scaling mechanisms. Docker is used to package, instantiate, and run containerized applications. \n \n-The host(s) containing the master components (API Server, Controller Manger Server, etcd, etc)\n+A Kubernetes cluster involves a master component and a set of nodes, all on top of a distributed storage system. \n \n-=== API Server\n+== Master\n \n-Serves the main API\n+The Kubernetes master is the host or hosts that contain the master components (API Server, Controller Manger Server, etcd, etc)\n \n-=== Controller Manager Server\n+=== API Server\n \n-Watches etcd for changes to ReplicationController objects and then uses the API to enforce the desired state.\n+The Kubernetes API server serves the main API, and validates and configures the data for pods, services, and replication controllers. The Kuberbetes API server also assigns pods to nodes and synchronizes pod information with service configuration. \n \n === etcd\n \n All persistent master state is stored in etcd. Other components watch etcd for changes and eventually bring themselves into the desired state described in etcd.\n \n+=== Controller Manager Server\n+\n+The controller manager server watches etcd for changes to replication controller objects and then uses the API to enforce the desired state.\n+\n == Node\n \n-Each node has the services necessary to run Docker containers and be managed from the master systems\n+A Kubernetes node is managed from the master systems, and has the services necessary in order to run Docker containers. Each node runs Docker, which takes care of downloading and running containers.","path":"architecture/kubernetes_infrastructure.adoc","position":33,"original_position":33,"commit_id":"c2b6b869c03d5b245c437d8a241331e192624b37","original_commit_id":"c2b6b869c03d5b245c437d8a241331e192624b37","user":{"login":"danmcp","id":492994,"avatar_url":"https://avatars.githubusercontent.com/u/492994?v=3","gravatar_id":"","url":"https://api.github.com/users/danmcp","html_url":"https://github.com/danmcp","followers_url":"https://api.github.com/users/danmcp/followers","following_url":"https://api.github.com/users/danmcp/following{/other_user}","gists_url":"https://api.github.com/users/danmcp/gists{/gist_id}","starred_url":"https://api.github.com/users/danmcp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/danmcp/subscriptions","organizations_url":"https://api.github.com/users/danmcp/orgs","repos_url":"https://api.github.com/users/danmcp/repos","events_url":"https://api.github.com/users/danmcp/events{/privacy}","received_events_url":"https://api.github.com/users/danmcp/received_events","type":"User","site_admin":false},"body":"\"takes care of\" seems a little strong.  It does download and run containers.  But \"takes care of reads\" as though Docker is the one triggering the downloading and running to occur.  Which is actually the kubelet.","created_at":"2015-01-23T16:01:22Z","updated_at":"2015-01-23T16:01:22Z","html_url":"https://github.com/openshift/openshift-docs/pull/82#discussion_r23458678","pull_request_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/82","_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/23458678"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/82#discussion_r23458678"},"pull_request":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/82"}}},"pull_request":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/82","id":27895702,"html_url":"https://github.com/openshift/openshift-docs/pull/82","diff_url":"https://github.com/openshift/openshift-docs/pull/82.diff","patch_url":"https://github.com/openshift/openshift-docs/pull/82.patch","issue_url":"https://api.github.com/repos/openshift/openshift-docs/issues/82","number":82,"state":"open","locked":false,"title":"added previous edits","user":{"login":"bfallonf","id":5474938,"avatar_url":"https://avatars.githubusercontent.com/u/5474938?v=3","gravatar_id":"","url":"https://api.github.com/users/bfallonf","html_url":"https://github.com/bfallonf","followers_url":"https://api.github.com/users/bfallonf/followers","following_url":"https://api.github.com/users/bfallonf/following{/other_user}","gists_url":"https://api.github.com/users/bfallonf/gists{/gist_id}","starred_url":"https://api.github.com/users/bfallonf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bfallonf/subscriptions","organizations_url":"https://api.github.com/users/bfallonf/orgs","repos_url":"https://api.github.com/users/bfallonf/repos","events_url":"https://api.github.com/users/bfallonf/events{/privacy}","received_events_url":"https://api.github.com/users/bfallonf/received_events","type":"User","site_admin":false},"body":"Added to files in architecture directory","created_at":"2015-01-23T01:57:14Z","updated_at":"2015-01-23T16:01:22Z","closed_at":null,"merged_at":null,"merge_commit_sha":"a7c35f7f0a0529af009b00bf17ce5b694a15d39b","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/82/commits","review_comments_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/82/comments","review_comment_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/{number}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/issues/82/comments","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/c2b6b869c03d5b245c437d8a241331e192624b37","head":{"label":"bfallonf:testbranch","ref":"testbranch","sha":"c2b6b869c03d5b245c437d8a241331e192624b37","user":{"login":"bfallonf","id":5474938,"avatar_url":"https://avatars.githubusercontent.com/u/5474938?v=3","gravatar_id":"","url":"https://api.github.com/users/bfallonf","html_url":"https://github.com/bfallonf","followers_url":"https://api.github.com/users/bfallonf/followers","following_url":"https://api.github.com/users/bfallonf/following{/other_user}","gists_url":"https://api.github.com/users/bfallonf/gists{/gist_id}","starred_url":"https://api.github.com/users/bfallonf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bfallonf/subscriptions","organizations_url":"https://api.github.com/users/bfallonf/orgs","repos_url":"https://api.github.com/users/bfallonf/repos","events_url":"https://api.github.com/users/bfallonf/events{/privacy}","received_events_url":"https://api.github.com/users/bfallonf/received_events","type":"User","site_admin":false},"repo":{"id":29709118,"name":"openshift-docs","full_name":"bfallonf/openshift-docs","owner":{"login":"bfallonf","id":5474938,"avatar_url":"https://avatars.githubusercontent.com/u/5474938?v=3","gravatar_id":"","url":"https://api.github.com/users/bfallonf","html_url":"https://github.com/bfallonf","followers_url":"https://api.github.com/users/bfallonf/followers","following_url":"https://api.github.com/users/bfallonf/following{/other_user}","gists_url":"https://api.github.com/users/bfallonf/gists{/gist_id}","starred_url":"https://api.github.com/users/bfallonf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bfallonf/subscriptions","organizations_url":"https://api.github.com/users/bfallonf/orgs","repos_url":"https://api.github.com/users/bfallonf/repos","events_url":"https://api.github.com/users/bfallonf/events{/privacy}","received_events_url":"https://api.github.com/users/bfallonf/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/bfallonf/openshift-docs","description":"OpenShift Documentation","fork":true,"url":"https://api.github.com/repos/bfallonf/openshift-docs","forks_url":"https://api.github.com/repos/bfallonf/openshift-docs/forks","keys_url":"https://api.github.com/repos/bfallonf/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bfallonf/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bfallonf/openshift-docs/teams","hooks_url":"https://api.github.com/repos/bfallonf/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/bfallonf/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/bfallonf/openshift-docs/events","assignees_url":"https://api.github.com/repos/bfallonf/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/bfallonf/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/bfallonf/openshift-docs/tags","blobs_url":"https://api.github.com/repos/bfallonf/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bfallonf/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bfallonf/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/bfallonf/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bfallonf/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/bfallonf/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/bfallonf/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/bfallonf/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/bfallonf/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/bfallonf/openshift-docs/subscription","commits_url":"https://api.github.com/repos/bfallonf/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/bfallonf/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/bfallonf/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/bfallonf/openshift-docs/issues/comments/{number}","contents_url":"https://api.github.com/repos/bfallonf/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/bfallonf/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bfallonf/openshift-docs/merges","archive_url":"https://api.github.com/repos/bfallonf/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bfallonf/openshift-docs/downloads","issues_url":"https://api.github.com/repos/bfallonf/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/bfallonf/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/bfallonf/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/bfallonf/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bfallonf/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/bfallonf/openshift-docs/releases{/id}","created_at":"2015-01-23T00:54:27Z","updated_at":"2015-01-23T01:51:49Z","pushed_at":"2015-01-23T01:51:49Z","git_url":"git://github.com/bfallonf/openshift-docs.git","ssh_url":"git@github.com:bfallonf/openshift-docs.git","clone_url":"https://github.com/bfallonf/openshift-docs.git","svn_url":"https://github.com/bfallonf/openshift-docs","homepage":null,"size":1348,"stargazers_count":0,"watchers_count":0,"language":"CSS","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":"openshift:master","ref":"master","sha":"69b0bd14c1e87fcd2a89fddb8beba0ca7c02564e","user":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"repo":{"id":21740844,"name":"openshift-docs","full_name":"openshift/openshift-docs","owner":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/openshift/openshift-docs","description":"OpenShift Documentation","fork":false,"url":"https://api.github.com/repos/openshift/openshift-docs","forks_url":"https://api.github.com/repos/openshift/openshift-docs/forks","keys_url":"https://api.github.com/repos/openshift/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openshift/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openshift/openshift-docs/teams","hooks_url":"https://api.github.com/repos/openshift/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/openshift/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/openshift/openshift-docs/events","assignees_url":"https://api.github.com/repos/openshift/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/openshift/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/openshift/openshift-docs/tags","blobs_url":"https://api.github.com/repos/openshift/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openshift/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openshift/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/openshift/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/openshift/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/openshift/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/openshift/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/openshift/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/openshift/openshift-docs/subscription","commits_url":"https://api.github.com/repos/openshift/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/openshift/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/openshift/openshift-docs/issues/comments/{number}","contents_url":"https://api.github.com/repos/openshift/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/openshift/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openshift/openshift-docs/merges","archive_url":"https://api.github.com/repos/openshift/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openshift/openshift-docs/downloads","issues_url":"https://api.github.com/repos/openshift/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/openshift/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/openshift/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/openshift/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openshift/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/openshift/openshift-docs/releases{/id}","created_at":"2014-07-11T15:14:42Z","updated_at":"2015-01-23T01:45:16Z","pushed_at":"2015-01-23T01:45:15Z","git_url":"git://github.com/openshift/openshift-docs.git","ssh_url":"git@github.com:openshift/openshift-docs.git","clone_url":"https://github.com/openshift/openshift-docs.git","svn_url":"https://github.com/openshift/openshift-docs","homepage":null,"size":1348,"stargazers_count":11,"watchers_count":11,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":31,"mirror_url":null,"open_issues_count":3,"forks":31,"open_issues":3,"watchers":11,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/82"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/82"},"issue":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/82"},"comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/82/comments"},"review_comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/82/comments"},"review_comment":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/82/commits"},"statuses":{"href":"https://api.github.com/repos/openshift/openshift-docs/statuses/c2b6b869c03d5b245c437d8a241331e192624b37"}}}}