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

Bug 1704381

Summary: [DOCS] Exposing and Securing Registry are wrong
Product: OpenShift Container Platform Reporter: Eric Rich <erich>
Component: DocumentationAssignee: Brandi Munilla <bmcelvee>
Status: CLOSED CURRENTRELEASE QA Contact: Wenjing Zheng <wzheng>
Severity: urgent Docs Contact: Vikram Goyal <vigoyal>
Priority: low    
Version: 4.1.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: 4.1.0   
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: 2019-06-03 13:53:27 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: 1704358    
Bug Blocks: 1704382    

Description Eric Rich 2019-04-29 15:55:25 UTC
Document URL: https://docs.openshift.com/container-platform/4.1/registry/securing-exposing-registry.html

Section Number and Name: Securing and exposing the registry (full docs set)

Describe the issue: This docs set is wrong and needs to be re-written. 

Suggestions for improvement: 

You need to explain how the Operator works, likely by following: https://docs.google.com/document/d/1tmq05NLrVgXx5C3DiqNR_6L7OegZt3_Kj4LrHvvjza8/edit#heading=h.v9urtevn4ssm

We need to explain how the user can use the DefaultRoute and Routes to both automatically expose and secure the registry, or to manually expose and secure the registry. 

Additional information: 

- https://github.com/openshift/cluster-image-registry-operator

Comment 1 Eric Rich 2019-04-29 15:57:08 UTC
To automatically secure the registry you should simply have to do: 

> oc patch configs.imageregistry.operator.openshift.io/cluster -p '{"spec":{"defaultRoute":true}}'

But this is likely blocked by https://bugzilla.redhat.com/show_bug.cgi?id=1704358

Comment 2 Eric Rich 2019-04-29 16:08:05 UTC
Be aware of how to patch resources (CRD's): https://bugzilla.redhat.com/show_bug.cgi?id=1704358

Comment 3 Brandi Munilla 2019-04-30 20:14:59 UTC
Thank you! I have a WIP PR for the Registry Operator, and I dropped the patch command in (though I'll likely move it). 

https://github.com/openshift/openshift-docs/pull/14476

Comment 4 Brandi Munilla 2019-05-21 18:38:07 UTC
Eric, I commented out the "Securing and exposing the registry" topic in https://github.com/openshift/openshift-docs/pull/14986.

There is a section to secure the registry in the operator topic: https://docs.openshift.com/container-platform/4.1/registry/configuring-registry-operator.html (merged from previous comment)

Do you think the entire "Securing and exposing the registry" topic should be removed from 4.1 or rewritten and added back post-GA?


Thanks!

Comment 5 Brandi Munilla 2019-05-21 20:44:58 UTC
Wenjing, would you mind please taking a look too? Thanks!

Comment 6 Wenjing Zheng 2019-05-22 03:33:29 UTC
Comments are added to the pull request, please follow up there.

Comment 8 Wenjing Zheng 2019-05-23 03:28:01 UTC
In 4.x, registry is secured by default, so the part https://docs.openshift.com/container-platform/4.1/registry/configuring-registry-operator.html#registry-operator-default-crd_configuring-registry-operator can be removed, plus the patch command is not to secure registry, it is just to enable default external route.

Comment 9 Brandi Munilla 2019-05-24 21:17:53 UTC
Thanks, Eric and Wenjing! 

I updated the patch command and the module to `true` and changed the context to enable the default route.

Comment 10 Wenjing Zheng 2019-05-27 06:19:13 UTC
Since the whole section of Securing Registry needs to be removed, so I will assign this bug back.

Comment 11 Brandi Munilla 2019-05-29 16:53:02 UTC
Removed the securing the registry manually module, but left the exposing the registry content. That content is linked from two other assemblies.

Comment 12 Wenjing Zheng 2019-05-30 06:01:58 UTC
The whole section of Securing Registry has been moved, so move this bug to verified. Thanks, Brandi!

Comment 13 Brandi Munilla 2019-05-31 16:59:57 UTC
Thanks so much! PR merged.