Bug 1274950

Summary: Missing description of resource units
Product: OpenShift Container Platform Reporter: Erik M Jacobs <ejacobs>
Component: DocumentationAssignee: Thien-Thi Nguyen <tnguyen>
Status: CLOSED NOTABUG QA Contact: Vikram Goyal <vigoyal>
Severity: high Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.0.0CC: amelicha, aos-bugs, decarr, ejacobs, jokerman, mmccomas, tnguyen
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: 2015-12-07 16:04:17 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 Erik M Jacobs 2015-10-24 01:43:12 UTC
We may want to incorporate something like:

http://kubernetes.io/v1.0/docs/design/resources.html

To explain what cores/cpu actually are. Specifically, the section on kcu/cpu:

http://kubernetes.io/v1.0/docs/design/resources.html#processor-cycles

Comment 2 Thien-Thi Nguyen 2015-10-24 14:50:13 UTC
Related: https://bugzilla.redhat.com/show_bug.cgi?id=1267008

Comment 3 Thien-Thi Nguyen 2015-11-24 17:49:47 UTC
(In reply to Erik M Jacobs from comment #0)

> We may want to incorporate something like:
>
> http://kubernetes.io/v1.0/docs/design/resources.html
>
> To explain what cores/cpu actually are. Specifically, the section on kcu/cpu:
>
> http://kubernetes.io/v1.0/docs/design/resources.html#processor-cycles

The "Compute Resources" chapter of the Developer Guide:

 https://access.redhat.com/documentation/en/openshift-enterprise/version-3.1/developer-guide/#compute-resource-units

seems to partially satisfy this BZ.  (It's still missing some mention of "kcu".)  Do we still want to include "kcu" info?  What about the current text -- is it sufficient?

Comment 4 Erik M Jacobs 2015-11-24 17:52:04 UTC
The question regarding KCU would need to be answered by engineering. Part of the reason KCU exists is because of CPU scaling, but I'm not sure we're exposing that to customers.

I would say that most of the text is sufficient but someone should probably decide whether or not we need to talk about KCU.

Comment 5 Thien-Thi Nguyen 2015-11-24 20:09:53 UTC
Thanks for the redirect.  Setting needinfo to the the author (AFAICT) of the Compute Resources chapter, who is in engineering.  (Derek, please see comments 3 and 4.)

Comment 6 Derek Carr 2015-12-07 14:37:00 UTC
I think the current text is sufficient.

Until such time that we look to support normalization of compute across the cluster with any more intelligence, just describing compute in terms of fractional cores is the clearest thing that we can do.  I think anything else introduces confusion.

Comment 7 Thien-Thi Nguyen 2015-12-07 16:04:17 UTC
Moving to CLOSED NOTABUG.