Bug 1296605

Summary: [SME] registry deployment documentation missing update/delete and missing service account info
Product: OpenShift Container Platform Reporter: Josh Preston <jpreston>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.1.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-12-30 14:25:57 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:

Description Josh Preston 2016-01-07 16:10:17 UTC
Document URL: 

Section Number and Name: 

Section 2.5.1 Overview
Section 2.5.2 Deploying the Registry

Describe the issue: 

After jacking up my registry because I created the registry user as described in 2.5.1 Overview and following 2.5.2 Deploying the Registry section, I required a reinstall.  However, it is not intuitive how to remove a registry that was deployed with oadm registry …

Suggestions for improvement: 

The docs should include some reference to redeploying / removing a registry.  This was actually solved by performing an oc delete|create, but it would be better if it were in the original ‘oadm registry’ command:

‘oadm registry … -o yaml | oc delete -f -’
‘oadm registry … -o yaml | oc create -f -’

Section 2.5.1 Overview, should use 'registry' not 'reguser' for the registry!

Section 2.5.2 Deploying the Registry, should include the “--service-account=registry” as listed in Section 2.5.1, because following the directions creates a registry that does not utilize a service account.

Additional information: 

Documentation aside, we should include some sort of --update or --delete option to either give me the option to update a previously deployed registry or delete it so I can start over.

Comment 1 Vikram Goyal 2017-12-30 14:25:57 UTC
Many changes have been made to the 3.1 docs [1] since this bug was created and I cannot find the issues mentioned. I am going to close this bug, but please feel free to open a new one if issues persist in the updated docs.

[1] https://access.redhat.com/documentation/en-us/openshift_enterprise/3.1/single/installation_and_configuration/index#overview-6