Bug 1877966

Summary: [DOC] GCP Page on creating mirror registry is missing critical information
Product: OpenShift Container Platform Reporter: To Hung Sze <tsze>
Component: DocumentationAssignee: Chinmayi Chandrasekhar <cchandra>
Status: CLOSED WONTFIX QA Contact: To Hung Sze <tsze>
Severity: high Docs Contact: Latha S <lmurthy>
Priority: medium    
Version: 4.6CC: aos-bugs, cchandra, jokerman, lmurthy, mpytlak
Target Milestone: ---   
Target Release: 4.6.z   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-10-14 14:07:54 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 To Hung Sze 2020-09-10 21:46:33 UTC
Document URL: 
https://docs.openshift.com/container-platform/4.3/installing/install_config/installing-restricted-networks-preparations.html


Section Number and Name: 
Procedures

Describe the issue: 
From 4.4 on, the page is missing a critical block of information about how to actually create the mirror registry.

Suggestions for improvement: 
Get these sections from 
https://docs.openshift.com/container-platform/4.2/installing/install_config/installing-restricted-networks-preparations.html

Creating a mirror registry
Adding the registry to your pull secret

Insert before 
Mirroring the OpenShift Container Platform image repositor

Additional information:

Comment 3 Chinmayi Chandrasekhar 2021-10-04 11:18:02 UTC
@tsze From 4.6 onwards, the whole "Creating a mirror registry for installation in a restricted network" section is removed from the installation configuration book. See https://docs.openshift.com/container-platform/4.8/installing/install_config/installing-customizing.html

Should the whole section be included again? Could there be a reason why it was removed in the first place?

Comment 4 To Hung Sze 2021-10-04 12:44:38 UTC
In my opinion, yes, I believe the whole section on how to create registry should be restored.

I do not know why it was removed - before my time. When I asked about it,I think I was just told "there was restructuring".

Not sure what that link about customizing nodes has to do with this topic.

Comment 5 Chinmayi Chandrasekhar 2021-10-12 13:42:30 UTC
@tsze: "Creating a mirror registry" was deliberately excluded from 4.6+ and "Adding the registry to your pull secret" is already here - https://docs.openshift.com/container-platform/4.6/installing/installing-mirroring-installation-images.html#installation-adding-registry-pull-secret_installing-mirroring-installation-images.

Please let me know if we can close this bug.

Comment 6 Mike Pytlak 2021-10-14 13:34:24 UTC
@cchandra @tsze Is this what the team is looking for in 4.6+?
https://docs.openshift.com/container-platform/4.6/installing/installing-mirroring-installation-images.html

Comment 7 To Hung Sze 2021-10-14 14:07:54 UTC
When I wrote this bz, I was looking to have instructions on how to create the mirror registry included.
If it was removed on purpose, and that decision is still valid, then I will close this ticket.

Comment 8 Red Hat Bugzilla 2023-09-15 00:47:55 UTC
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 500 days