Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1860560

Summary: [DOC] update doc related to creating mirror registry
Product: OpenShift Container Platform Reporter: To Hung Sze <tsze>
Component: DocumentationAssignee: Amrita <asakthiv>
Status: CLOSED CURRENTRELEASE QA Contact: To Hung Sze <tsze>
Severity: medium Docs Contact: Latha S <lmurthy>
Priority: medium    
Version: 4.6CC: aos-bugs, asakthiv, jokerman, lmurthy
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-11-09 05:49: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-07-25 04:45:32 UTC 
Document URL: 
This page has room for improvements:
https://docs.openshift.com/container-platform/4.2/installing/install_config/installing-restricted-networks-preparations.html


Describe the issue:

 
#1 The sample in "Adding the registry to your pull secret", step 4
Edit the new file and add a section that describes your registry to it:

<original>
{
  "auths": {
    "cloud.openshift.com": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "quay.io": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "registry.connect.redhat.com": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    },
    "<mirror_registry>": {
      "auth": "<credentials>",
      "email": "you"
    },
    "registry.redhat.io": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    }
  }
}
...

<suggestion>
{
  "auths": {
    "cloud.openshift.com": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "quay.io": {
      "auth": "b3BlbnNo...",
      "email": "you"
    },
    "registry.connect.redhat.com": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    },
    "registry.example.com": {
      "auth": "BGVtbYk3ZHAtqXs=",
      "email": "you"
    },
    "registry.redhat.io": {
      "auth": "NTE3Njg5Nj...",
      "email": "you"
    }
  }
}



#2 In the sample in "Adding the registry to your pull secret" , step 3:

<original>
cat ./pull-secret.text | jq .  > <path>/<pull-secret-file>

<suggestion>
cat ./pull-secret.text | jq .  > <path>/<pull-secret-file-in-json>


Additional information: 
Big portion of this page was removed from 4.4 / 4.5 doc.
https://bugzilla.redhat.com/show_bug.cgi?id=1877966
Comment 1 To Hung Sze 2020-07-28 21:17:57 UTC 
The above mentioned defect to restore missing part of the doc is 
https://bugzilla.redhat.com/show_bug.cgi?id=1861531
Comment 2 To Hung Sze 2021-06-11 22:10:52 UTC 
Another defect in rollback: https://bugzilla.redhat.com/show_bug.cgi?id=1971087
Comment 3 Latha S 2021-10-06 08:25:05 UTC 
@tsze - I understand this bug was raised in 4.2 version and I am not sure if this is still applicable for 4.6+ versions. Please confirm. 
If it is applicable for 4.6+ versions, then please provide specific details on what needs to be fixed. Thank you!
Comment 4 To Hung Sze 2021-10-06 12:58:16 UTC 
Those examples mentioned in this bz (that need to be improved)are now listed in newer versions like
https://docs.openshift.com/container-platform/4.8/installing/installing-mirroring-installation-images.html

(they were not there when I wrote this bz).

Therefore, please improve those examples as described in all versions.

Thanks.