我的书签
添加书签
移除书签RuntimeClass
apiVersion: node.k8s.io/v1
import "k8s.io/api/node/v1"
RuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod. For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/
kind: RuntimeClass
metadata ()
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
handler (string), required
Handler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node & CRI configuration. It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called “runc” might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.
overhead (Overhead)
Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. For more details, see
Overhead structure represents the resource overhead associated with running a pod.
overhead.podFixed (map[string]Quantity)
PodFixed represents the fixed resource overhead associated with running a pod.
scheduling (Scheduling)
Scheduling holds the scheduling constraints to ensure that pods running with this RuntimeClass are scheduled to nodes that support it. If scheduling is nil, this RuntimeClass is assumed to be supported by all nodes.
Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass.
scheduling.nodeSelector (map[string]string)
nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod’s existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.
scheduling.tolerations ([]Toleration)
Atomic: will be replaced during a merge
tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.
The pod this Toleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator .
scheduling.tolerations.key (string)
Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.
scheduling.tolerations.operator (string)
Operator represents a key’s relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all taints of a particular category.
scheduling.tolerations.value (string)
Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
scheduling.tolerations.effect (string)
Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
scheduling.tolerations.tolerationSeconds (int64)
TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system.
RuntimeClassList is a list of RuntimeClass objects.
apiVersion: node.k8s.io/v1
kind: RuntimeClassList
metadata ()
Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]), required
Items is a list of schema objects.
HTTP Request
GET /apis/node.k8s.io/v1/runtimeclasses/{name}
Parameters
name (in path): string, required
name of the RuntimeClass
pretty (in query): string
Response
200 (RuntimeClass): OK
401: Unauthorized
list or watch objects of kind RuntimeClass
HTTP Request
GET /apis/node.k8s.io/v1/runtimeclasses
Parameters
allowWatchBookmarks (in query): boolean
continue (in query): string
labelSelector (in query): string
limit (in query): integer
pretty (in query): string
resourceVersion (in query): string
resourceVersionMatch (in query): string
timeoutSeconds (in query): integer
watch (in query): boolean
Response
200 (): OK
401: Unauthorized
HTTP Request
POST /apis/node.k8s.io/v1/runtimeclasses
Parameters
body: RuntimeClass, required
dryRun (in query): string
fieldValidation (in query): string
pretty (in query): string
Response
200 (): OK
201 (RuntimeClass): Created
202 (): Accepted
401: Unauthorized
update replace the specified RuntimeClass
HTTP Request
PUT /apis/node.k8s.io/v1/runtimeclasses/{name}
Parameters
name (in path): string, required
name of the RuntimeClass
body: , required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
Response
200 (): OK
201 (RuntimeClass): Created
401: Unauthorized
HTTP Request
PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
Parameters
name (in path): string, required
name of the RuntimeClass
body: , required
dryRun (in query): string
fieldValidation (in query): string
force (in query): boolean
pretty (in query): string
Response
200 (RuntimeClass): OK
201 (): Created
401: Unauthorized
delete delete a RuntimeClass
HTTP Request
DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}
Parameters
name (in path): string, required
name of the RuntimeClass
body:
dryRun (in query): string
gracePeriodSeconds (in query): integer
pretty (in query): string
propagationPolicy (in query): string
Response
200 (): OK
202 (Status): Accepted
401: Unauthorized
HTTP Request
DELETE /apis/node.k8s.io/v1/runtimeclasses
Parameters
body:
continue (in query): string
dryRun (in query): string
fieldSelector (in query): string
gracePeriodSeconds (in query): integer
labelSelector (in query): string
limit (in query): integer
pretty (in query): string
propagationPolicy (in query): string
resourceVersion (in query): string
timeoutSeconds (in query): integer
Response
200 (): OK
401: Unauthorized
Last modified April 09, 2022 at 9:47 AM PST: Update API Reference multi-pages for v1.24 (363eea4e22)
