Bug 1305403

Summary: [DOCS] [3.2] Document Router Sharding
Product: OpenShift Container Platform Reporter: Vikram Goyal <vigoyal>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED CURRENTRELEASE QA Contact: zhaozhanqi <zzhao>
Severity: high Docs Contact: Vikram Goyal <vigoyal>
Priority: high    
Version: 3.1.0CC: amelicha, aos-bugs, erich, jokerman, misalunk, mmccomas, ramr, rchopra, tnguyen, vigoyal, zzhao
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-31 19:36:19 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1257963    
Deadline: 2016-03-15   

Description Vikram Goyal 2016-02-08 02:07:52 UTC 
Routers (since 3.1.1) support overriding the host value in a route at startup. You can start multiple routers and serve the same route over different wildcards (with different configurations). See the help text for openshift-router.

https://docs.openshift.com/enterprise/3.1/release_notes/ose_3_1_release_notes.html#ose-3-1-1

However, this information on how to setup the routes is not specified in the docs and should be documented for 3.2.

See this thread for more info and background:
http://lists.openshift.redhat.com/openshift-archives/dev/2016-January/msg00081.html

Source from upstream docs:
https://github.com/openshift/origin/blob/master/docs/router_sharding.md

Relevant BZ:
https://bugzilla.redhat.com/show_bug.cgi?id=1257963

No Trello cards AFAIK.

Dev for contact:
Clayton Coleman

QA for contact:
Zhanqi Zhao
Comment 2 Thien-Thi Nguyen 2016-03-14 13:20:25 UTC 
Plan: Adapt the upstream docs.
Comment 6 Thien-Thi Nguyen 2016-03-24 22:34:07 UTC 
There are two parts to this BZ.  First is the ability to override the host value in a route at startup.  Second is router sharding, proper.
Comment 7 Thien-Thi Nguyen 2016-03-27 21:41:12 UTC 
PR for the first part (hostname override):
https://github.com/openshift/openshift-docs/pull/1815
Comment 9 Thien-Thi Nguyen 2016-04-05 13:38:31 UTC 
WIP for second part:
https://github.com/tnguyen-rh/openshift-docs/tree/bz1305403-router-sharding
Comment 10 openshift-github-bot 2016-04-06 15:53:47 UTC 
Commit pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/02c6f5d348f5d1070bd2652cb115954d3dfe5355
Merge pull request #1815 from tnguyen-rh/bz1305403

Bug 1305403 (part 1) Describe env vars that can be used to override route hostname
Comment 12 Thien-Thi Nguyen 2016-04-08 02:12:12 UTC 
PR for second part (describe router sharding):
https://github.com/openshift/openshift-docs/pull/1876
Comment 23 openshift-github-bot 2016-05-16 18:08:47 UTC 
Commit pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/2bb1ed159a1d08f2161cedd98ab8005a34894d2f
Merge pull request #1876 from tnguyen-rh/bz1305403-router-sharding

Bug 1305403 - Describe router sharding
Comment 25 zhaozhanqi 2016-05-17 05:58:33 UTC 
looks good to me.

verified this bug.
Comment 27 Vikram Goyal 2016-05-24 12:17:13 UTC 
*** Bug 1339218 has been marked as a duplicate of this bug. ***
Comment 32 Thien-Thi Nguyen 2016-05-31 19:36:19 UTC 
Verified live:
- PR 1815
https://access.redhat.com/documentation/en/openshift-enterprise/3.2/installation-and-configuration/chapter-2-installing (section 2.8.3)
- PR 1876
https://access.redhat.com/documentation/en/openshift-enterprise/3.2/architecture/chapter-3-core-concepts#routes (section 3.7.8)
https://access.redhat.com/documentation/en/openshift-enterprise/version-3.2/installation-and-configuration/#creating-router-shards (section 2.8.3.3)
https://access.redhat.com/documentation/en/openshift-enterprise/version-3.2/installation-and-configuration/#modifying-router-shards (section 2.8.3.4)

Moving status to CLOSED CURRENTRELEASE.