Bug 1304241

Summary: [DOCS] [3.2] Document how local storage is protected with the quota setting
Product: OpenShift Container Platform Reporter: Vikram Goyal <vigoyal>
Component: DocumentationAssignee: Ashley Hardin <ahardin>
Status: CLOSED CURRENTRELEASE QA Contact: Chao Yang <chaoyang>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: high    
Version: 3.1.0CC: aos-bugs, chaoyang, dgoodwin, 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: 2016-05-13 17:34:34 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:
Deadline: 2016-03-15   

Description Vikram Goyal 2016-02-03 06:37:43 UTC
Right now the volume quota only works against remote persistent volumes and not local host volumes. In OSE, OSD 3.2 and Online, local storage usage can be limited.

We need to document:

1) a new feature in the OpenShift security context constraints for disabling emptyDir usage. This is relevant to enterprise/origin and (I believe Dedicated) users.

2) that for OpenShift Online users, emptyDir is disabled, show the expected error message, and inform them how to work around the problem for Online (this may go away by the time online beta goes GA so check).

Dev for this feature is:
Devan Goodwin

Trello Card is:
https://trello.com/c/kyzO6BFG/482-5-limit-local-storage-usage-by-users-beta

QA for this feature is: 

Likely Guide:
Dev Guide in the new app and volumes sections: https://docs.openshift.com/enterprise/3.1/dev_guide/index.html

The pull request for upstream docs is here: https://github.com/openshift/openshift-docs/pull/1529

Comment 2 Ashley Hardin 2016-03-14 18:49:31 UTC
Work in progress: https://github.com/openshift/openshift-docs/pull/1740

Comment 4 Ashley Hardin 2016-03-16 18:02:07 UTC
@Devan, Can you please help clarify whether EmptyDir volumes is disabled in OpenShift Online? Looks like we have conflicting information between these 2 PRs:

https://github.com/openshift/origin/pull/7351
https://github.com/openshift/openshift-docs/pull/1529

Thanks!

Comment 5 Devan Goodwin 2016-03-17 12:04:00 UTC
Apologies this situation has been a bit confusing and has changed a lot since I started. 

https://github.com/openshift/openshift-docs/pull/1529 was what we expected was going to happen, we didn't think there would be time for empty dir to be working in online. However due to delays that situation has changed and we pursued a better solution in https://github.com/openshift/origin/pull/7351 and that just merged last night. 

I believe 1529 can be reverted now, emptyDir volume quotas should be in the code for launch so we expect to allow emptyDir volumes in online.

Comment 6 Devan Goodwin 2016-03-17 12:16:14 UTC
I will submit a PR to revert 1529.

Comment 7 Devan Goodwin 2016-03-17 12:47:18 UTC
Filed docs PRs to revert the "online restrictions", a since removed feature to block emptyDir volume usage as a cluster admin, and my attempt at docs for the quota feature, feel free to use, or reject that as necessary if it overlaps with what you're working on.

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

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

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

Comment 9 Vikram Goyal 2016-03-18 00:11:16 UTC
Thanks Ashley and Devan.

Chao Yang - requesting QE for this docs work.

Comment 10 Chao Yang 2016-03-18 09:34:50 UTC
Verification is passed
PR 1758,1759,1760 can descripe the EmtpyDir volume function clearly