Bug 1387712

Summary: [DOCS] Remove NFS storage examples from the registry.
Product: OpenShift Container Platform Reporter: Ryan Howe <rhowe>
Component: DocumentationAssignee: Brandi Munilla <bmcelvee>
Status: CLOSED CURRENTRELEASE QA Contact: Jianwei Hou <jhou>
Severity: urgent Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.3.0CC: aos-bugs, erich, jokerman, mmccomas
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: 2017-03-14 18:34:12 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 Ryan Howe 2016-10-21 15:51:50 UTC 
Document URL: https://docs.openshift.com/container-platform/3.3/install_config/registry/deploy_registry_existing_clusters.html

Section Number and Name: https://docs.openshift.com/container-platform/3.3/install_config/registry/deploy_registry_existing_clusters.html

Describe the issue: 

NFS can not "guarantee" read-after-write consistency, when scaled. We can not recommend this as a good solution for the registry backed volume for production deployments. 

As NFS as the following known issues,
https://docs.openshift.com/container-platform/3.3/install_config/registry/registry_known_issues.html#known-issue-nfs-image-push-fails

Suggestions for improvement: 
  
 Add documentation that states that NFS is not a good solution for the registry backed volume for production deployments. 
 
 Documentation for production deployments does not scale (we should highlight this). Alternatively production deployments should recommend object based storage for registry that want to scale.
Comment 2 Brandi Munilla 2017-03-03 21:07:59 UTC 
Hi Ryan and Jianwei,

I added a note (per Brad's recommendation) to the known issues section. Please take a look at PR3869[1] when you get a chance. 

Thanks!

[1]https://github.com/openshift/openshift-docs/pull/3869
Comment 5 Jianwei Hou 2017-03-06 03:07:31 UTC 
Thank you. Verified that NFS is not recommended for production deployment in our documentation.
Comment 6 openshift-github-bot 2017-03-08 14:24:56 UTC 
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/1e637aa30d282a3f66324d4be2d4f558841625db
Bug 1387712 Added note recommending moving off NFS for production

https://github.com/openshift/openshift-docs/commit/f306c3593b3aed10143bdaeeb18f4b1fbe1707f2
Merge pull request #3869 from bmcelvee/BZ1387712

Bug 1387712 Added note recommending moving off NFS for production
Comment 7 Brandi Munilla 2017-03-14 18:34:12 UTC 
Link to document in Customer Portal: https://access.redhat.com/documentation/en-us/openshift_container_platform/3.4/html-single/installation_and_configuration/#known-issue-nfs-image-push-fails