Bug 1485824

Summary:	[DOCS] openshift_hosted_registry_routehost variable for customizing docker-registry route is not documented.
Product:	OpenShift Container Platform	Reporter:	Joel Rosental R. <jrosenta>
Component:	Documentation	Assignee:	Kathryn Alexander <kalexand>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Dongbo Yan <dyan>
Severity:	high	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	low
Version:	3.5.1	CC:	aos-bugs, dyan, jkupfere, jokerman, jrosenta, jtudelag, mmccomas, sjr
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	3.10-release-plan
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2018-04-12 19:04:50 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:

Description Joel Rosental R. 2017-08-28 07:51:08 UTC

Document URL: 
https://docs.openshift.com/container-platform/3.5/install_config/install/advanced_install.html#advanced-install-configuring-registry-location

Section Number and Name: 
Configuring a Registry Location

Describe the issue: 
As of OCP 3.5 there is a new variable (openshift_hosted_registry_routehost) which can be used to customize docker-registry route prior installation, however it does not seem to be present in official documentation: https://docs.openshift.com/container-platform/3.5/install_config/install/advanced_install.html

Suggestions for improvement: 
Document this variable.

Additional information:

Comment 2 Johnathan Kupferer 2018-03-05 23:50:57 UTC

I was just looking for the same and found that this and related variables are also missing from the docs:

openshift_hosted_registry_routehost
openshift_hosted_registry_routecertificates
openshift_hosted_registry_routetermination

Comment 3 Kathryn Alexander 2018-04-05 14:34:35 UTC

I've created a draft of the update here: https://github.com/openshift/openshift-docs/pull/8612

Since the function changed in 3.7, I think we should include it in the docs from that version on.

Comment 4 Kathryn Alexander 2018-04-05 16:04:55 UTC

Dongbo, will you please take a look? https://github.com/openshift/openshift-docs/pull/8612

Comment 5 Dongbo Yan 2018-04-12 11:08:23 UTC

PR look good to me, move to verified

Comment 6 openshift-github-bot 2018-04-12 12:45:58 UTC

Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/9f06b16a583f30c31a466f13dd496b6165f45341
bug 1485824 adding registry route variables

https://github.com/openshift/openshift-docs/commit/bd12d3c36a279529e25b0489f9dc621d5731095e
Merge pull request #8612 from kalexand-rh/BZ1485824

bug 1485824 adding registry route variables

Comment 7 Kathryn Alexander 2018-04-12 13:17:32 UTC

Thanks Dongbo!

I've cherry-picked the change back to 3.7 and am waiting for it to be visible in a build.

Comment 8 Kathryn Alexander 2018-04-12 19:04:50 UTC

This is live in 3.7 and 3.9:

https://docs.openshift.com/container-platform/3.7/install_config/install/advanced_install.html#advanced-install-configuring-docker-route

https://docs.openshift.com/container-platform/3.9/install_config/install/advanced_install.html#advanced-install-configuring-docker-route