Skip to content

Commit

Permalink
add docs covering capacity-type topology spread
Browse files Browse the repository at this point in the history
  • Loading branch information
tzneal committed Mar 30, 2022
1 parent 392d509 commit 3f8d39a
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 0 deletions.
1 change: 1 addition & 0 deletions website/content/en/preview/provisioner.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,7 @@ Karpenter supports specifying capacity type, which is analogous to [EC2 purchase

Karpenter prioritizes Spot offerings if the provisioner allows Spot and on-demand instances. If the provider API (e.g. EC2 Fleet's API) indicates Spot capacity is unavailable, Karpenter caches that result across all attempts to provision EC2 capacity for that instance type and zone for the next 45 seconds. If there are no other possible offerings available for Spot, Karpenter will attempt to provision on-demand instances, generally within milliseconds.

Karpenter also allows `karpenter.sh/capacity-type` to be used as a topology key for enforcing topology-spread.

## spec.kubeletConfiguration

Expand Down
6 changes: 6 additions & 0 deletions website/content/en/preview/tasks/scheduling.md
Original file line number Diff line number Diff line change
Expand Up @@ -240,6 +240,12 @@ For example, if there were three nodes and five pods the pods could be spread 1,
If instead the spread were 5, pods could be 5, 0, 0 or 3, 2, 0, or 2, 1, 2 and so on.
* Karpenter is always able to improve skew by launching new nodes in the right zones. Therefore, `whenUnsatisfiable` does not change provisioning behavior.

The three supported `topologyKey` values that Karpenter supports are:
- `topology.kubernetes.io/zone`
- `kubernetes.io/hostname`
- `karpenter.sh/capacity-type`


See [Pod Topology Spread Constraints](https://kubernetes.io/docs/concepts/workloads/pods/pod-topology-spread-constraints/) for details.

## Persistent Volume Topology
Expand Down

0 comments on commit 3f8d39a

Please sign in to comment.