Skip to content

Commit 9721e4c

Browse files
committed
DRA: clarifications around semantic parameters
"Numeric parameters" are now called "semantic parameters" because they are not just about numbers.
1 parent fa3c5ce commit 9721e4c

File tree

1 file changed

+22
-5
lines changed
  • keps/sig-node/3063-dynamic-resource-allocation

1 file changed

+22
-5
lines changed

keps/sig-node/3063-dynamic-resource-allocation/README.md

Lines changed: 22 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -664,7 +664,7 @@ allocation also may turn out to be insufficient. Some risks are:
664664
captured yet (like limited number of nodes that they can be attached to).
665665

666666
- Cluster autoscaling will not work as expected unless the DRA driver
667-
uses [numeric parameters](https://github.com/kubernetes/enhancements/issues/4381).
667+
uses [semantic parameters](https://github.com/kubernetes/enhancements/issues/4381).
668668

669669
All of these risks will have to be evaluated by gathering feedback from users
670670
and resource driver developers.
@@ -1841,6 +1841,11 @@ like "drivers have provided information" occurs, instead of forcing the pod to
18411841
go through the backoff queue and the usually 5 second long delay associated
18421842
with that.
18431843

1844+
Queuing hints are an optional feature of the scheduler, with (as of Kubernetes
1845+
1.29) their own `SchedulerQueueingHints` feature gate that defaults to
1846+
off. When turned off, performance of scheduling pods with resource claims is
1847+
slower compared to a cluster configuration where they are turned on.
1848+
18441849
#### PreEnqueue
18451850

18461851
This checks whether all claims referenced by a pod exist. If they don't,
@@ -1992,11 +1997,11 @@ to simulate the effect of allocating claims as part of scheduling and of
19921997
creating or removing nodes.
19931998

19941999
This is not possible with opaque parameters as described in this KEP. If a DRA
1995-
driver developer wants to support Cluster Autoscaler, they have to use numeric
1996-
parameters. Numeric parameters are an extension of this KEP that is defined in
2000+
driver developer wants to support Cluster Autoscaler, they have to use semantic
2001+
parameters. Semantic parameters are an extension of this KEP that is defined in
19972002
[KEP #4381](https://github.com/kubernetes/enhancements/issues/4381).
19982003

1999-
Numeric parameters are not necessary for network-attached resources because
2004+
Semantic parameters are not necessary for network-attached resources because
20002005
adding or removing nodes doesn't change their availability and thus Cluster
20012006
Autoscaler does not need to understand their parameters.
20022007

@@ -2465,7 +2470,7 @@ For beta:
24652470

24662471
- In normal scenarios, scheduling pods with claims must not block scheduling of
24672472
other pods by doing blocking API calls
2468-
- Implement integration with Cluster Autoscaler through numeric parameters
2473+
- Implement integration with Cluster Autoscaler through semantic parameters
24692474
- Gather feedback from developers and surveys
24702475
- Positive acknowledgment from 3 would-be implementors of a resource driver,
24712476
from a diversity of companies or projects
@@ -2822,6 +2827,18 @@ Why should this KEP _not_ be implemented?
28222827

28232828
## Alternatives
28242829

2830+
### Semantic Parameters instead of PodSchedulingContext
2831+
2832+
When a DRA driver uses semantic parameters, there is no DRA driver controller
2833+
and no need for communication between scheduler and such a controller. The
2834+
PodSchedulingContext object and the associated support in the scheduler then
2835+
aren't needed. Once semantic parameters are mature enough and confirmed to be
2836+
sufficient for DRA drivers, it might become possible to remove the
2837+
PodSchedulingContext API from this KEP.
2838+
2839+
It might still be needed for other drivers and use cases, which then can be
2840+
discussed in a new KEP which focuses specifically on those use cases.
2841+
28252842
### ResourceClaimTemplate
28262843

28272844
Instead of creating a ResourceClaim from a template, the

0 commit comments

Comments
 (0)