214 lines
6.7 KiB
Go
214 lines
6.7 KiB
Go
|
/*
|
||
|
|
Copyright 2015 The Kubernetes Authors.
|
||
|
|
|
||
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
you may not use this file except in compliance with the License.
|
||
|
|
You may obtain a copy of the License at
|
||
|
|
|
||
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
|
||
|
|
Unless required by applicable law or agreed to in writing, software
|
||
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
See the License for the specific language governing permissions and
|
||
|
|
limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
package qos
|
||
|
|
|
||
|
|
import (
|
||
|
|
"k8s.io/apimachinery/pkg/util/sets"
|
||
|
|
"k8s.io/kubernetes/pkg/api"
|
||
|
|
"k8s.io/kubernetes/pkg/api/resource"
|
||
|
|
"k8s.io/kubernetes/pkg/api/v1"
|
||
|
|
)
|
||
|
|
|
||
|
|
// isResourceGuaranteed returns true if the container's resource requirements are Guaranteed.
|
||
|
|
func isResourceGuaranteed(container *v1.Container, resource v1.ResourceName) bool {
|
||
|
|
// A container resource is guaranteed if its request == limit.
|
||
|
|
// If request == limit, the user is very confident of resource consumption.
|
||
|
|
req, hasReq := container.Resources.Requests[resource]
|
||
|
|
limit, hasLimit := container.Resources.Limits[resource]
|
||
|
|
if !hasReq || !hasLimit {
|
||
|
|
return false
|
||
|
|
}
|
||
|
|
return req.Cmp(limit) == 0 && req.Value() != 0
|
||
|
|
}
|
||
|
|
|
||
|
|
// isResourceBestEffort returns true if the container's resource requirements are best-effort.
|
||
|
|
func isResourceBestEffort(container *v1.Container, resource v1.ResourceName) bool {
|
||
|
|
// A container resource is best-effort if its request is unspecified or 0.
|
||
|
|
// If a request is specified, then the user expects some kind of resource guarantee.
|
||
|
|
req, hasReq := container.Resources.Requests[resource]
|
||
|
|
return !hasReq || req.Value() == 0
|
||
|
|
}
|
||
|
|
|
||
|
|
// GetPodQOS returns the QoS class of a pod.
|
||
|
|
// A pod is besteffort if none of its containers have specified any requests or limits.
|
||
|
|
// A pod is guaranteed only when requests and limits are specified for all the containers and they are equal.
|
||
|
|
// A pod is burstable if limits and requests do not match across all containers.
|
||
|
|
func GetPodQOS(pod *v1.Pod) v1.PodQOSClass {
|
||
|
|
requests := v1.ResourceList{}
|
||
|
|
limits := v1.ResourceList{}
|
||
|
|
zeroQuantity := resource.MustParse("0")
|
||
|
|
isGuaranteed := true
|
||
|
|
for _, container := range pod.Spec.Containers {
|
||
|
|
// process requests
|
||
|
|
for name, quantity := range container.Resources.Requests {
|
||
|
|
if !supportedQoSComputeResources.Has(string(name)) {
|
||
|
|
continue
|
||
|
|
}
|
||
|
|
if quantity.Cmp(zeroQuantity) == 1 {
|
||
|
|
delta := quantity.Copy()
|
||
|
|
if _, exists := requests[name]; !exists {
|
||
|
|
requests[name] = *delta
|
||
|
|
} else {
|
||
|
|
delta.Add(requests[name])
|
||
|
|
requests[name] = *delta
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
// process limits
|
||
|
|
qosLimitsFound := sets.NewString()
|
||
|
|
for name, quantity := range container.Resources.Limits {
|
||
|
|
if !supportedQoSComputeResources.Has(string(name)) {
|
||
|
|
continue
|
||
|
|
}
|
||
|
|
if quantity.Cmp(zeroQuantity) == 1 {
|
||
|
|
qosLimitsFound.Insert(string(name))
|
||
|
|
delta := quantity.Copy()
|
||
|
|
if _, exists := limits[name]; !exists {
|
||
|
|
limits[name] = *delta
|
||
|
|
} else {
|
||
|
|
delta.Add(limits[name])
|
||
|
|
limits[name] = *delta
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
if len(qosLimitsFound) != len(supportedQoSComputeResources) {
|
||
|
|
isGuaranteed = false
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if len(requests) == 0 && len(limits) == 0 {
|
||
|
|
return v1.PodQOSBestEffort
|
||
|
|
}
|
||
|
|
// Check is requests match limits for all resources.
|
||
|
|
if isGuaranteed {
|
||
|
|
for name, req := range requests {
|
||
|
|
if lim, exists := limits[name]; !exists || lim.Cmp(req) != 0 {
|
||
|
|
isGuaranteed = false
|
||
|
|
break
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if isGuaranteed &&
|
||
|
|
len(requests) == len(limits) {
|
||
|
|
return v1.PodQOSGuaranteed
|
||
|
|
}
|
||
|
|
return v1.PodQOSBurstable
|
||
|
|
}
|
||
|
|
|
||
|
|
// InternalGetPodQOS returns the QoS class of a pod.
|
||
|
|
// A pod is besteffort if none of its containers have specified any requests or limits.
|
||
|
|
// A pod is guaranteed only when requests and limits are specified for all the containers and they are equal.
|
||
|
|
// A pod is burstable if limits and requests do not match across all containers.
|
||
|
|
func InternalGetPodQOS(pod *api.Pod) api.PodQOSClass {
|
||
|
|
requests := api.ResourceList{}
|
||
|
|
limits := api.ResourceList{}
|
||
|
|
zeroQuantity := resource.MustParse("0")
|
||
|
|
isGuaranteed := true
|
||
|
|
for _, container := range pod.Spec.Containers {
|
||
|
|
// process requests
|
||
|
|
for name, quantity := range container.Resources.Requests {
|
||
|
|
if !supportedQoSComputeResources.Has(string(name)) {
|
||
|
|
continue
|
||
|
|
}
|
||
|
|
if quantity.Cmp(zeroQuantity) == 1 {
|
||
|
|
delta := quantity.Copy()
|
||
|
|
if _, exists := requests[name]; !exists {
|
||
|
|
requests[name] = *delta
|
||
|
|
} else {
|
||
|
|
delta.Add(requests[name])
|
||
|
|
requests[name] = *delta
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
// process limits
|
||
|
|
qosLimitsFound := sets.NewString()
|
||
|
|
for name, quantity := range container.Resources.Limits {
|
||
|
|
if !supportedQoSComputeResources.Has(string(name)) {
|
||
|
|
continue
|
||
|
|
}
|
||
|
|
if quantity.Cmp(zeroQuantity) == 1 {
|
||
|
|
qosLimitsFound.Insert(string(name))
|
||
|
|
delta := quantity.Copy()
|
||
|
|
if _, exists := limits[name]; !exists {
|
||
|
|
limits[name] = *delta
|
||
|
|
} else {
|
||
|
|
delta.Add(limits[name])
|
||
|
|
limits[name] = *delta
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
if len(qosLimitsFound) != len(supportedQoSComputeResources) {
|
||
|
|
isGuaranteed = false
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if len(requests) == 0 && len(limits) == 0 {
|
||
|
|
return api.PodQOSBestEffort
|
||
|
|
}
|
||
|
|
// Check is requests match limits for all resources.
|
||
|
|
if isGuaranteed {
|
||
|
|
for name, req := range requests {
|
||
|
|
if lim, exists := limits[name]; !exists || lim.Cmp(req) != 0 {
|
||
|
|
isGuaranteed = false
|
||
|
|
break
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if isGuaranteed &&
|
||
|
|
len(requests) == len(limits) {
|
||
|
|
return api.PodQOSGuaranteed
|
||
|
|
}
|
||
|
|
return api.PodQOSBurstable
|
||
|
|
}
|
||
|
|
|
||
|
|
// QOSList is a set of (resource name, QoS class) pairs.
|
||
|
|
type QOSList map[v1.ResourceName]v1.PodQOSClass
|
||
|
|
|
||
|
|
// GetQOS returns a mapping of resource name to QoS class of a container
|
||
|
|
func GetQOS(container *v1.Container) QOSList {
|
||
|
|
resourceToQOS := QOSList{}
|
||
|
|
for resource := range allResources(container) {
|
||
|
|
switch {
|
||
|
|
case isResourceGuaranteed(container, resource):
|
||
|
|
resourceToQOS[resource] = v1.PodQOSGuaranteed
|
||
|
|
case isResourceBestEffort(container, resource):
|
||
|
|
resourceToQOS[resource] = v1.PodQOSBestEffort
|
||
|
|
default:
|
||
|
|
resourceToQOS[resource] = v1.PodQOSBurstable
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return resourceToQOS
|
||
|
|
}
|
||
|
|
|
||
|
|
// supportedComputeResources is the list of compute resources for with QoS is supported.
|
||
|
|
var supportedQoSComputeResources = sets.NewString(string(v1.ResourceCPU), string(v1.ResourceMemory))
|
||
|
|
|
||
|
|
// allResources returns a set of all possible resources whose mapped key value is true if present on the container
|
||
|
|
func allResources(container *v1.Container) map[v1.ResourceName]bool {
|
||
|
|
resources := map[v1.ResourceName]bool{}
|
||
|
|
for _, resource := range supportedQoSComputeResources.List() {
|
||
|
|
resources[v1.ResourceName(resource)] = false
|
||
|
|
}
|
||
|
|
for resource := range container.Resources.Requests {
|
||
|
|
resources[resource] = true
|
||
|
|
}
|
||
|
|
for resource := range container.Resources.Limits {
|
||
|
|
resources[resource] = true
|
||
|
|
}
|
||
|
|
return resources
|
||
|
|
}
|