Extend podresources API to report allocatable resources

[ffromani]

Enhancement Description

• One-line enhancement description (can be used as a release note): Extend the podresources API to report the allocatable compute resources
• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/blob/master/keps/sig-node/2403-pod-resources-allocatable-resources/README.md
• Discussion Link:
  • SIG Node Meeting 20200811: Recording, Slides
  • Slack thread for introducing GetAllocatableResources() endpoint (previously called GetAvailableResources) in podresource API
• Primary contact (assignee): @ffromani
• Responsible SIGs: sig-node
• Enhancement target (which target equals to which milestone):
  • Alpha release target (x.y): 1.21
  • Beta release target (x.y): 1.23
  • Stable release target (x.y): 1.28
• Stable
  • KEP (k/enhancements) update PR(s):
    • KEP-2403: graduate to GA #4045
  • Code (k/k) update PR(s):
    • node: podresources: graduate to GA kubernetes#116525
    • node: podresources: getallocatable: move to GA kubernetes#118973
  • Docs (k/website) update(s):
    • node: podresources: GetAllocatable API is GA website#41729

Previous/Related work:

• initial issue - initially targeting 1.20, we are creating a separate issue + KEP to clearly describe this unit of work.

PRs:

• podresources APIs: concrete resources apis: implement GetAllocatableResources kubernetes#95734

[ffromani]

/sig node

[ffromani]

rationale for this split in this slack conversation

the main goal is to make this change easier to review

[derekwaynecarr]

/milestone v1.21

[JamesLaverack]

Hey @fromanirh, enhancements 1.21 shadow here,

Enhancements Freeze is 2 days away, Feb 9th EOD PST

The enhancements team is aware that KEP update is currently in progress (PR #2404). Please make sure to work on PRR questionnaires and requirements and get it merged before the freeze. For PRR related questions or to boost the PR for PRR review, please reach out in Slack on the #prod-readiness channel.

Any enhancements that do not complete the following requirements by the freeze will require an exception.

• [IN PROGRESS] The KEP must be merged in an implementable state
• [IN PROGRESS] The KEP must have test plans
• [IN PROGRESS] The KEP must have graduation criteria
• [IN PROGRESS] The KEP must have a production readiness review

[JamesLaverack]

Hi @fromanirh,

Since your Enhancement is scheduled to be in 1.21, please keep in mind the important upcoming dates:

• Tuesday, March 9th: Week 9 — Code Freeze
• Tuesday, March 16th: Week 10 — Docs Placeholder PR deadline
  • If this enhancement requires new docs or modification to existing docs, please follow the steps in the Open a placeholder PR doc to open a PR against k/website repo.

As a reminder, please link all of your k/k PR(s) and k/website PR(s) to this issue so we can track them.

Thanks!

[ffromani]

Hi @fromanirh,

Since your Enhancement is scheduled to be in 1.21, please keep in mind the important upcoming dates:

* Tuesday, March 9th: Week 9 — Code Freeze

* Tuesday, March 16th: Week 10 — Docs Placeholder PR deadline
  
  * If this enhancement requires new docs or modification to existing docs, please follow the steps in the [Open a placeholder PR doc](https://kubernetes.io/docs/contribute/new-content/new-features/#open-a-placeholder-pr) to open a PR against k/website repo.

As a reminder, please link all of your k/k PR(s) and k/website PR(s) to this issue so we can track them.

Thanks!

Thanks for the reminder!
I don't think this enhancement requires a k/website PR, but I'll doublecheck and file a placeholder PR if needed.
Implementation PR: kubernetes/kubernetes#95734

[JamesLaverack]

Hi @fromanirh,

A friendly reminder that Code freeze is 3 days away, March 9th EOD PST

Any enhancements that are NOT code complete by the freeze will be removed from the milestone and will require an exception to be added back.

Please also keep in mind that if this enhancement requires new docs or modification to existing docs, you'll need to follow the steps in the Open a placeholder PR doc to open a PR against k/website repo by March 16th EOD PST

Thanks!

[annajung]

Hi @fromanirh, with kubernetes/kubernetes#95734 merged in, we will mark this as code complete.

[ffromani]

yes, thanks!