Bug 1304241 - [DOCS] [3.2] Document how local storage is protected with the quota setting
Summary: [DOCS] [3.2] Document how local storage is protected with the quota setting
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2016-03-15
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ---
: ---
Assignee: Ashley Hardin
QA Contact: Chao Yang
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-02-03 06:37 UTC by Vikram Goyal
Modified: 2017-03-08 18:14 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-05-13 17:34:34 UTC
Target Upstream Version:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.