Bug 1968124

Summary: [master] [doc] "Mirror Registry Configuration" doc section needs clarification of functionality and limitations
Product: OpenShift Container Platform Reporter: Chad Crum <ccrum>
Component: assisted-installerAssignee: Richard Su <rwsu>
assisted-installer sub component: Deployment Operator QA Contact: Chad Crum <ccrum>
Status: CLOSED ERRATA Docs Contact:
Severity: high    
Priority: medium CC: aos-bugs, ccrum, yobshans
Version: 4.8Keywords: Triaged
Target Milestone: ---   
Target Release: 4.9.0   
Hardware: x86_64   
OS: Linux   
Whiteboard: AI-Team-Platform
Fixed In Version: OCP-Metal-v1.0.22.1 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1968452 (view as bug list) Environment:
Last Closed: 2021-10-18 17:32: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:
Bug Depends On:    
Bug Blocks: 1968452    

Description Chad Crum 2021-06-05 16:43:19 UTC 
Description of problem:
The "Mirror Registry Configuration" section of the Assisted Service operator doc needs clarification on what exactly is impacted when implementing it (it changes both ignition config + install-config.yaml) as well as limitations (registries.conf mirroring must be repo scope, not registry, otherwise ocp install fails.)


Doc ref: https://github.com/openshift/assisted-service/blob/master/docs/operator.md#mirror-registry-configuration

Version-Release number of selected component (if applicable):
Current


Additional info:

In regards to the limitation of mirroring, this example using repo scope to mirror will work:
    [[registry]]
       prefix = ""
       location = "quay.io/ocpmetal"
       mirror-by-digest-only = false

       [[registry.mirror]]
       location = "bm-cluster-1-hyper.e2e.bos.redhat.com:5000/ocpmetal"

But this next example using full registry scope to mirror will not pass validation in the openshift-installer, so ocp install will fail:

    [[registry]]
       prefix = ""
       location = "quay.io"
       mirror-by-digest-only = false

       [[registry.mirror]]
       location = "bm-cluster-1-hyper.e2e.bos.redhat.com:5000"


See this bz for more details: https://bugzilla.redhat.com/show_bug.cgi?id=1960378
Comment 5 errata-xmlrpc 2021-10-18 17:32:54 UTC 
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (Moderate: OpenShift Container Platform 4.9.0 bug fix and security update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHSA-2021:3759