{"action":"created","comment":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/40365695","id":40365695,"diff_hunk":"@@ -24,48 +24,59 @@ and (optionally) security configuration.\n == Routers\n \n An OpenShift administrator can\n-link:../../install_config/install/deploy_router.html[deploy\n-routers] in an OpenShift cluster. These enable routes\n-link:../../dev_guide/routes.html#creating-routes[created by developers]\n-to be used by external clients.\n-\n-OpenShift routers provide external hostname mapping and load balancing\n+link:../../install_config/install/deploy_router.html[deploy routers] in an\n+OpenShift cluster, which enable routes\n+link:../../dev_guide/routes.html#creating-routes[created by developers] to be\n+used by external clients. The routing layer in OpenShift is pluggable, and two\n+available link:#available-router-plug-ins[router plug-ins] are provided and\n+supported by default.\n+\n+OpenShift routers provide external host name mapping and load balancing\n to link:pods_and_services.html#services[services] over protocols that\n-pass distinguishing information directly to the router; the hostname\n+pass distinguishing information directly to the router; the host name\n must be present in the protocol in order for the router to determine\n-where to send it. Routers support the following protocols:\n+where to send it.\n+\n+Router plug-ins assume they can bind to host ports 80 and 443. This is to allow\n+external traffic to route to the host and subsequently through the router.\n+Routers also assume that networking is configured such that it can access all\n+pods in the cluster.\n+\n+Routers support the following protocols:\n \n - HTTP\n - HTTPS (with SNI)\n - WebSockets\n - TLS with SNI\n \n-NOTE: WebSocket traffic uses the same route conventions and supports the same\n-TLS termination types as other traffic.\n-\n-A router uses the service selector to find the service and the endpoints\n-backing the service. Service-provided load balancing is bypassed and\n-replaced with the router's own load balancing. Routers watch the cluster\n-API and automatically update their own configuration according to any\n-relevant changes in the API objects. Routers may be containerized or\n-virtual. Custom routers can be deployed to communicate modifications of\n-API objects to another system, such as an *F5*.\n-\n-In order to reach a router in the first place, requests for hostnames\n-must resolve via DNS to a router or set of routers. The suggested\n-method is to define a cloud domain with a wildcard DNS entry pointing\n-to a virtual IP backed by multiple router instances on designated nodes.\n+[NOTE]\n+====\n+WebSocket traffic uses the same route conventions and supports the same TLS\n+termination types as other traffic.\n+====\n+\n+A router uses the service selector to find the service and the endpoints backing\n+the service. Service-provided load balancing is bypassed and replaced with the\n+router's own load balancing. Routers watch the cluster API and automatically\n+update their own configuration according to any relevant changes in the API\n+objects. Routers may be containerized or virtual. Custom routers can be deployed\n+to communicate modifications of API objects to an external routing solution.\n+\n+In order to reach a router in the first place, requests for host names must\n+resolve via DNS to a router or set of routers. The suggested method is to define\n+a cloud domain with a wildcard DNS entry pointing to a virtual IP backed by\n+multiple router instances on designated nodes.\n link:../../admin_guide/high_availability.html#configuring-a-highly-available-routing-service[Router\n-vIP configuration is described in the Administration Guide]. DNS\n-for addresses outside the cloud domain would need to be configured\n-individually. Other approaches may be feasible.\n+vIP configuration is described in the Administration Guide]. DNS for addresses","path":"architecture/core_concepts/routes.adoc","position":73,"original_position":73,"commit_id":"f8b2d368ad260bab65d1664ae795de36b72b4954","original_commit_id":"f8b2d368ad260bab65d1664ae795de36b72b4954","user":{"login":"adellape","id":3442316,"avatar_url":"https://avatars.githubusercontent.com/u/3442316?v=3","gravatar_id":"","url":"https://api.github.com/users/adellape","html_url":"https://github.com/adellape","followers_url":"https://api.github.com/users/adellape/followers","following_url":"https://api.github.com/users/adellape/following{/other_user}","gists_url":"https://api.github.com/users/adellape/gists{/gist_id}","starred_url":"https://api.github.com/users/adellape/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adellape/subscriptions","organizations_url":"https://api.github.com/users/adellape/orgs","repos_url":"https://api.github.com/users/adellape/repos","events_url":"https://api.github.com/users/adellape/events{/privacy}","received_events_url":"https://api.github.com/users/adellape/received_events","type":"User","site_admin":false},"body":"Fixed.","created_at":"2015-09-24T20:04:07Z","updated_at":"2015-09-24T20:04:07Z","html_url":"https://github.com/openshift/openshift-docs/pull/980#discussion_r40365695","pull_request_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/980","_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/40365695"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/980#discussion_r40365695"},"pull_request":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/980"}}},"pull_request":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/980","id":45463651,"html_url":"https://github.com/openshift/openshift-docs/pull/980","diff_url":"https://github.com/openshift/openshift-docs/pull/980.diff","patch_url":"https://github.com/openshift/openshift-docs/pull/980.patch","issue_url":"https://api.github.com/repos/openshift/openshift-docs/issues/980","number":980,"state":"closed","locked":false,"title":"Updates for F5 router","user":{"login":"adellape","id":3442316,"avatar_url":"https://avatars.githubusercontent.com/u/3442316?v=3","gravatar_id":"","url":"https://api.github.com/users/adellape","html_url":"https://github.com/adellape","followers_url":"https://api.github.com/users/adellape/followers","following_url":"https://api.github.com/users/adellape/following{/other_user}","gists_url":"https://api.github.com/users/adellape/gists{/gist_id}","starred_url":"https://api.github.com/users/adellape/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adellape/subscriptions","organizations_url":"https://api.github.com/users/adellape/orgs","repos_url":"https://api.github.com/users/adellape/repos","events_url":"https://api.github.com/users/adellape/events{/privacy}","received_events_url":"https://api.github.com/users/adellape/received_events","type":"User","site_admin":false},"body":"@Miciah PTAL\r\n\r\nPretty builds (internal) of affected topics:\r\n\r\nhttp://file.rdu.redhat.com/~adellape/091815/f5_router/architecture/core_concepts/routes.html\r\n\r\nhttp://file.rdu.redhat.com/~adellape/091815/f5_router/install_config/install/deploy_router.html\r\n\r\nhttp://file.rdu.redhat.com/~adellape/091815/f5_router/admin_guide/routing_from_edge_lb.html#establishing-a-tunnel-using-a-ramp-node","created_at":"2015-09-18T23:43:20Z","updated_at":"2015-09-24T20:04:07Z","closed_at":"2015-09-23T00:20:13Z","merged_at":"2015-09-23T00:20:13Z","merge_commit_sha":"de41937206830adf0e1a883ad93479d1c0ee773d","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/980/commits","review_comments_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/980/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/980/comments","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/f8b2d368ad260bab65d1664ae795de36b72b4954","head":{"label":"adellape:f5_router","ref":"f5_router","sha":"f8b2d368ad260bab65d1664ae795de36b72b4954","user":{"login":"adellape","id":3442316,"avatar_url":"https://avatars.githubusercontent.com/u/3442316?v=3","gravatar_id":"","url":"https://api.github.com/users/adellape","html_url":"https://github.com/adellape","followers_url":"https://api.github.com/users/adellape/followers","following_url":"https://api.github.com/users/adellape/following{/other_user}","gists_url":"https://api.github.com/users/adellape/gists{/gist_id}","starred_url":"https://api.github.com/users/adellape/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adellape/subscriptions","organizations_url":"https://api.github.com/users/adellape/orgs","repos_url":"https://api.github.com/users/adellape/repos","events_url":"https://api.github.com/users/adellape/events{/privacy}","received_events_url":"https://api.github.com/users/adellape/received_events","type":"User","site_admin":false},"repo":{"id":29119125,"name":"openshift-docs","full_name":"adellape/openshift-docs","owner":{"login":"adellape","id":3442316,"avatar_url":"https://avatars.githubusercontent.com/u/3442316?v=3","gravatar_id":"","url":"https://api.github.com/users/adellape","html_url":"https://github.com/adellape","followers_url":"https://api.github.com/users/adellape/followers","following_url":"https://api.github.com/users/adellape/following{/other_user}","gists_url":"https://api.github.com/users/adellape/gists{/gist_id}","starred_url":"https://api.github.com/users/adellape/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adellape/subscriptions","organizations_url":"https://api.github.com/users/adellape/orgs","repos_url":"https://api.github.com/users/adellape/repos","events_url":"https://api.github.com/users/adellape/events{/privacy}","received_events_url":"https://api.github.com/users/adellape/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/adellape/openshift-docs","description":"OpenShift Documentation","fork":true,"url":"https://api.github.com/repos/adellape/openshift-docs","forks_url":"https://api.github.com/repos/adellape/openshift-docs/forks","keys_url":"https://api.github.com/repos/adellape/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/adellape/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/adellape/openshift-docs/teams","hooks_url":"https://api.github.com/repos/adellape/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/adellape/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/adellape/openshift-docs/events","assignees_url":"https://api.github.com/repos/adellape/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/adellape/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/adellape/openshift-docs/tags","blobs_url":"https://api.github.com/repos/adellape/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/adellape/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/adellape/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/adellape/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/adellape/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/adellape/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/adellape/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/adellape/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/adellape/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/adellape/openshift-docs/subscription","commits_url":"https://api.github.com/repos/adellape/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/adellape/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/adellape/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/adellape/openshift-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/adellape/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/adellape/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/adellape/openshift-docs/merges","archive_url":"https://api.github.com/repos/adellape/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/adellape/openshift-docs/downloads","issues_url":"https://api.github.com/repos/adellape/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/adellape/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/adellape/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/adellape/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/adellape/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/adellape/openshift-docs/releases{/id}","created_at":"2015-01-12T04:47:07Z","updated_at":"2015-04-29T21:31:10Z","pushed_at":"2015-09-24T20:03:50Z","git_url":"git://github.com/adellape/openshift-docs.git","ssh_url":"git@github.com:adellape/openshift-docs.git","clone_url":"https://github.com/adellape/openshift-docs.git","svn_url":"https://github.com/adellape/openshift-docs","homepage":null,"size":6044,"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":"4112b569c7f47c2dda968654a671a3f7c2496e91","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-09-21T12:49:43Z","pushed_at":"2015-09-24T19:57:41Z","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":10483,"stargazers_count":26,"watchers_count":26,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":121,"mirror_url":null,"open_issues_count":96,"forks":121,"open_issues":96,"watchers":26,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/980"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/980"},"issue":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/980"},"comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/980/comments"},"review_comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/980/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/980/commits"},"statuses":{"href":"https://api.github.com/repos/openshift/openshift-docs/statuses/f8b2d368ad260bab65d1664ae795de36b72b4954"}}}}