Bug 1968452

Summary: [4.8.0] [doc] "Mirror Registry Configuration" doc section needs clarification of functionality and limitations
Product: OpenShift Container Platform Reporter: Ronnie Lazar <alazar>
Component: assisted-installerAssignee: Antoni Segura Puimedon <asegurap>
assisted-installer sub component: Deployment Operator QA Contact: Chad Crum <ccrum>
Status: CLOSED ERRATA Docs Contact:
Severity: high    
Priority: medium CC: alazar, aos-bugs, ccrum, dcadzow, rfreiman
Version: 4.8Keywords: Triaged
Target Milestone: ---   
Target Release: 4.8.0   
Hardware: x86_64   
OS: Linux   
Whiteboard: AI-Team-Platform
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: 1968124 Environment:
Last Closed: 2021-07-27 23:11:49 UTC Type: ---
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: 1968124    
Bug Blocks:    

Description Ronnie Lazar 2021-06-07 12:46:52 UTC 
+++ This bug was initially created as a clone of Bug #1968124 +++

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 6 Chad Crum 2021-07-07 12:47:11 UTC 
Verified docs are updated.
Comment 8 errata-xmlrpc 2021-07-27 23:11:49 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.8.2 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:2438