Bug 1577702

Summary: [DOCS] Support Statement on NFS for Registry for OCP 3.9
Product: OpenShift Container Platform Reporter: Mike Calizo <mcalizo>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED CURRENTRELEASE QA Contact: Dongbo Yan <dyan>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.9.0CC: ahatfiel, aos-bugs, jokerman, mmccomas, tkimura, wzheng
Target Milestone: ---   
Target Release: ---   
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: 2018-05-24 04:08:30 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 Mike Calizo 2018-05-14 02:34:08 UTC
Document URL: https://access.redhat.com/documentation/en-us/openshift_container_platform/3.9/html/installation_and_configuration/installing-a-cluster#install-config-installing-stand-alone-registry

Section Number and Name: 2.6.3.11.1. Configuring Registry Storage

Describe the issue: Support statement for NFS on registry conflicts with what is stated on the OCP 3.9 docs "The use of NFS for metrics storage is experimental and not supported in OpenShift Container Platform."

According to Support team (via SBR-Shift) The statement (in short) was, NFS is supported but not recommended" while the document specifically mentioned it NFS is not supported full-stop 

Suggestions for improvement: I think we should update the document to mention something like this (thanks to SBR-Shift for this statement) - If you have a registry, you should be using object storage for it.  
If you don't have object storage, you should get object storage.  If you
can't get object storage, only then should you consider using NFS to
store registry contents. NFS and the registry always have to have some
limitations that make them a small-scale solution.
If you have object storage, then you already have a solution in place
to do global content sharing and local seeding of content, so that's
the recommended approach.



Additional information: 

SBR-shift Statement:
 NFS is supported for registry. And the statement should be "NFS is supported but object storage followed by block storage is preferred".
https://docs.openshift.com/container-platform/3.9/scaling_performance/optimizing_storage.html#application-storage-recommendations