Bug 1470214 - [DOCS] openshift_master_default_subdomain should not include master hostname
Summary: [DOCS] openshift_master_default_subdomain should not include master hostname
Keywords:
Status: CLOSED EOL
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.5.0
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Vikram Goyal
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-07-12 14:14 UTC by Steven Walter
Modified: 2019-08-10 06:46 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-08-10 06:46:22 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Steven Walter 2017-07-12 14:14:34 UTC
Document URL: 
https://docs.openshift.com/container-platform/3.5/install_config/install/advanced_install.html

Section Number and Name: 
Configuring Cluster Variables

Describe the issue: 
When openshift_master_default_subdomain is set to a wildcard that the master url or master public url falls into, this can cause misrouting of traffic that should go to the masters to instead go to the router. For instance, if my subdomain is:

*.openshift.example.com

And my master URL is:

master.openshift.example.com

Then OpenShift components/apps might try to route this traffic to the router (since it fits the wildcard subdomain) instead of the master itself.

Suggestions for improvement: 
Include a statement: "This should not be a pattern that the openshift_master_cluster_hostname or openshift_master_cluster_public_hostname applies to. For instance, with a openshift_master_cluster_hostname of 'master.ocp.example.com', a subdomain '*.ocp.example.com' should not be used as this can cause routing conflicts. Instead use a more specific subdomain, such as '*.apps.ocp.example.com'."

Additional information: 
Fixing this docs bug would prevent potential configuration issues, such as with metrics and logging as described in these trackers.
https://bugzilla.redhat.com/show_bug.cgi?id=1448462
https://bugzilla.redhat.com/show_bug.cgi?id=1467433


Note You need to log in before you can comment on or make changes to this bug.