RuntimeClass

    apiVersion: node.k8s.io/v1

    import "k8s.io/api/node/v1"

    RuntimeClass 定义集群中支持的容器运行时类。 RuntimeClass 用于确定哪个容器运行时用于运行某 Pod 中的所有容器。 RuntimeClass 由用户或集群制备程序手动定义，并在 PodSpec 中引用。 Kubelet 负责在运行 Pod 之前解析 RuntimeClassName 引用。 有关更多详细信息，请参阅

    • kind: RuntimeClass

    • metadata (ObjectMeta)

      更多信息：

    • handler (string)，必需

      handler 指定底层运行时和配置，在 CRI 实现过程中将使用这些运行时和配置来处理这个类的 Pod。 可能的值特定于节点和 CRI 配置。 假定所有 handler 可用于每个节点上，且同一名称的 handler 在所有节点上是等效的。 例如，一个名为 “runc” 的 handler 可能指定 runc OCI 运行时将（使用原生 Linux 容器） 用于运行 Pod 中的容器。该 handler 必须采用小写，遵从 DNS Label (RFC 1123) 要求，且是不可变更的。

    • overhead (Overhead)

      overhead 表示运行给定 RuntimeClass 的 Pod 时所关联的资源开销。有关更多详细信息，请参阅 https://kubernetes.io/zh-cn/docs/concepts/scheduling-eviction/pod-overhead/

      Overhead 结构表示运行一个 Pod 所关联的资源开销。

      • overhead.podFixed (map[string])

        podFixed 表示与运行一个 Pod 所关联的资源开销。

    • scheduling (Scheduling)

      scheduling 包含调度约束，这些约束用来确保以这个 RuntimeClass 运行的 Pod 被调度到支持此运行时类的节点。 如果 scheduling 设为空，则假定所有节点支持此 RuntimeClass。

      Scheduling 指定支持 RuntimeClass 的节点的调度约束。

      • scheduling.nodeSelector (map[string]string)

        nodeSelector 列出支持此 RuntimeClass 的节点上必须存在的标签。 使用此 RuntimeClass 的 Pod 只能调度到与这个选择算符匹配的节点上。 RuntimeClass nodeSelector 与 Pod 现有的 nodeSelector 合并。 任何冲突均会使得该 Pod 在准入时被拒绝。

      • scheduling.tolerations ([]Toleration)

        原子性：将在合并期间被替换

        tolerations 在准入期间追加到以此 RuntimeClass 运行的 Pod（不包括重复项）上， 本质上是求取 Pod 和 RuntimeClass 所容忍的节点并集。

        附加此容忍度的 Pod 将容忍用匹配运算符 operator 运算后与三元组 <key,value,effect> 匹配的任何污点。

        • scheduling.tolerations.key (string)

          key 是容忍度所应用到的污点键。空意味着匹配所有污点键。 如果键为空，则运算符必须为 Exists；这个组合意味着匹配所有值和所有键。

        • scheduling.tolerations.operator (string)

          operator 表示一个键与值的关系。有效的运算符为 Exists 和 Equal。默认为 Equal。 Exists 等价于将值设置为通配符的情况，因此一个 Pod 可以容忍特定类别的所有污点。

        • scheduling.tolerations.value (string)

          value 是容忍度匹配到的污点值。如果运算符为 Exists，则值应为空，否则就是一个普通字符串。

        • scheduling.tolerations.effect (string)

          effect 表示匹配度污点效果。空意味着匹配所有污点效果。 当指定值时，允许的值为 NoSchedule、PreferNoSchedule 或 NoExecute。

        • scheduling.tolerations.tolerationSeconds (int64)

          tolerationSeconds 表示容忍度容忍污点的时间段（必须是 NoExecute 的效果，否则忽略此字段）。 默认情况下，不设置此字段，这意味着永远容忍污点（不驱逐）。零和负值将被系统视为 0（立即驱逐）。

    RuntimeClassList 是 RuntimeClass 对象的列表。

    HTTP 请求

    GET /apis/node.k8s.io/v1/runtimeclasses/{name}

    参数

    • name (路径参数): string，必需

      RuntimeClass 的名称

    • pretty (查询参数): string

      pretty

    响应

    200 (RuntimeClass): OK

    401: Unauthorized

    列出或监视 RuntimeClass 类别的对象

    HTTP 请求

    GET /apis/node.k8s.io/v1/runtimeclasses

    参数

    • allowWatchBookmarks (查询参数): boolean

      allowWatchBookmarks

    • continue (查询参数): string

    • fieldSelector (查询参数): string

    • labelSelector (查询参数): string

      labelSelector

    • limit (查询参数): integer

    • pretty (查询参数): string

      pretty

    • resourceVersion (查询参数): string

    • resourceVersionMatch (查询参数): string

      resourceVersionMatch

    • timeoutSeconds (查询参数): integer

    • watch (查询参数): boolean

      watch

    响应

    200 (RuntimeClassList): OK

    401: Unauthorized

    HTTP 请求

    POST /apis/node.k8s.io/v1/runtimeclasses

    参数

    • body: RuntimeClass，必需

    • dryRun (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (RuntimeClass): Created

    202 (): Accepted

    401: Unauthorized

    update 替换指定的 RuntimeClass

    HTTP 请求

    PUT /apis/node.k8s.io/v1/runtimeclasses/{name}

    参数

    • name (路径参数): string，必需

      RuntimeClass 的名称

    • body: ，必需

    • dryRun (查询参数): string

      dryRun

    • fieldManager (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (RuntimeClass): Created

    401: Unauthorized

    HTTP 请求

    PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}

    参数

    • name (路径参数): string，必需

      RuntimeClass 的名称

    • body: Patch，必需

    • fieldManager (查询参数): string

      fieldManager

    • fieldValidation (查询参数): string

    • force (查询参数): boolean

      force

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (RuntimeClass): Created

    401: Unauthorized

    delete 删除 RuntimeClass

    HTTP 请求

    DELETE /apis/node.k8s.io/v1/runtimeclasses/{name}

    参数

    • name (路径参数): string，必需

      RuntimeClass 的名称

    • body: DeleteOptions

    • dryRun (查询参数): string

    • gracePeriodSeconds (查询参数): integer

      gracePeriodSeconds

    • pretty (查询参数): string

    • propagationPolicy (查询参数): string

      propagationPolicy

    响应

    200 (Status): OK

    202 (): Accepted

    401: Unauthorized

    HTTP 请求

    DELETE /apis/node.k8s.io/v1/runtimeclasses

    参数

    • body:

    • continue (查询参数): string

      continue

    • dryRun (查询参数): string

    • fieldSelector (查询参数): string

      fieldSelector

    • gracePeriodSeconds (查询参数): integer

    • labelSelector (查询参数): string

      labelSelector

    • limit (查询参数): integer

    • pretty (查询参数): string

      pretty

    • propagationPolicy (查询参数): string

    • resourceVersion (查询参数): string

      resourceVersion

    • timeoutSeconds (查询参数): integer

    响应

    401: Unauthorized