跳转到文档内容
版本：v1.16

ClusterTaintPolicy v1alpha1

//: # (该生成器是从 reference-docs 分叉而来。) //: # (要更新参考内容，请遵循 reference-api.sh。)

apiVersion: policy.karmada.io/v1alpha1

import "github.com/karmada-io/karmada/pkg/apis/policy/v1alpha1"

ClusterTaintPolicy​

ClusterTaintPolicy 基于声明式条件自动管理 Cluster 对象上的污点。系统评估 AddOnConditions 来确定何时添加污点，评估 RemoveOnConditions 来确定何时移除污点。AddOnConditions 在 RemoveOnConditions 之前评估。当 ClusterTaintPolicy 被删除时，污点永远不会自动移除。

  • apiVersion: policy.karmada.io/v1alpha1

  • kind: ClusterTaintPolicy

  • metadata (ObjectMeta)

  • spec (ClusterTaintPolicySpec)，必需

    Spec 表示 ClusterTaintPolicy 的期望行为。

ClusterTaintPolicySpec​

ClusterTaintPolicySpec 表示 ClusterTaintPolicy 的期望行为。

  • taints ([]Taint)，必需

    Taints 指定需要在与 TargetClusters 匹配的集群对象上添加或移除的污点。如果 Taints 被修改，系统将在下次条件触发执行期间基于 Taints 的最新值处理污点，无论污点是否已被添加或移除。

    Taint 描述需要应用到集群的污点。

    • taints.effect (string)，必需

      Effect 表示要应用到集群的污点效果。

      可能的枚举值：

      • "NoExecute" 驱逐任何不容忍该污点的已运行 Pod。目前由 NodeController 强制执行。
      • "NoSchedule" 不允许新 Pod 调度到节点上，除非它们容忍该污点，但允许所有提交给 Kubelet 而不通过调度器的 Pod 启动，并允许所有已运行的 Pod 继续运行。由调度器强制执行。
      • "PreferNoSchedule" 类似于 TaintEffectNoSchedule，但调度器尽量不将新 Pod 调度到节点上，而不是完全禁止新 Pod 调度到节点上。由调度器强制执行。

    • taints.key (string)，必需

      Key 表示要应用到集群的污点键。

    • taints.value (string)

      Value 表示与污点键对应的污点值。

  • addOnConditions ([]MatchCondition)

    AddOnConditions 定义触发控制器在集群对象上添加污点的匹配条件。匹配条件使用 AND 逻辑。如果 AddOnConditions 为空，则不会添加污点。

    MatchCondition 表示在目标集群上激活故障转移相关污点的条件匹配详情。

    • addOnConditions.conditionType (string)，必需

      ConditionType 指定 ClusterStatus 条件类型。

    • addOnConditions.operator (string)，必需

      Operator 表示与一组值的关系。有效的操作符是 In、NotIn。

    • addOnConditions.statusValues ([]string)，必需

      StatusValues 是 metav1.ConditionStatus 值的数组。该项指定 ClusterStatus 条件状态。

  • removeOnConditions ([]MatchCondition)

    RemoveOnConditions 定义触发控制器从集群对象移除污点的匹配条件。匹配条件使用 AND 逻辑。如果 RemoveOnConditions 为空，则不会移除污点。

    MatchCondition 表示在目标集群上激活故障转移相关污点的条件匹配详情。

    • removeOnConditions.conditionType (string)，必需

      ConditionType 指定 ClusterStatus 条件类型。

    • removeOnConditions.operator (string)，必需

      Operator 表示与一组值的关系。有效的操作符是 In、NotIn。

    • removeOnConditions.statusValues ([]string)，必需

      StatusValues 是 metav1.ConditionStatus 值的数组。该项指定 ClusterStatus 条件状态。

  • targetClusters (ClusterAffinity)

    TargetClusters 指定 ClusterTaintPolicy 需要关注的集群。对于不再匹配 TargetClusters 的集群，污点将保持不变。如果未设置 targetClusters，则可以选择任何集群。

    ClusterAffinity 表示选择集群的过滤器。

    • targetClusters.clusterNames ([]string)

      ClusterNames 是要选择的集群列表。

    • targetClusters.exclude ([]string)

      ExcludedClusters 是要忽略的集群列表。

    • targetClusters.fieldSelector (FieldSelector)

      FieldSelector 是按字段选择成员集群的过滤器。匹配表达式的键（字段）应该是 'provider'、'region' 或 'zone'，匹配表达式的操作符应该是 'In' 或 'NotIn'。如果非空且非空，只有匹配此过滤器的集群才会被选择。

      FieldSelector 是字段过滤器。

    • targetClusters.labelSelector (LabelSelector)

      LabelSelector 是按标签选择成员集群的过滤器。如果非空且非空，只有匹配此过滤器的集群才会被选择。

ClusterTaintPolicyList​

ClusterTaintPolicyList 包含 ClusterTaintPolicy 的列表

操作​

get 读取指定的 ClusterTaintPolicy​

HTTP 请求​

GET /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}

参数​

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

    ClusterTaintPolicy 的名称

  • pretty (查询参数): string

    pretty

响应​

200 (ClusterTaintPolicy): OK

get 读取指定 ClusterTaintPolicy 的状态​

HTTP 请求​

GET /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}/status

参数​

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

    ClusterTaintPolicy 的名称

  • pretty (查询参数): string

    pretty

响应​

200 (ClusterTaintPolicy): OK

list 列出或监视 ClusterTaintPolicy 类型的对象​

HTTP 请求​

GET /apis/policy.karmada.io/v1alpha1/clustertaintpolicies

参数​

响应​

200 (ClusterTaintPolicyList): OK

create 创建 ClusterTaintPolicy​

HTTP 请求​

POST /apis/policy.karmada.io/v1alpha1/clustertaintpolicies

参数​

响应​

200 (ClusterTaintPolicy): OK

201 (ClusterTaintPolicy): Created

202 (ClusterTaintPolicy): Accepted

update 替换指定的 ClusterTaintPolicy​

HTTP 请求​

PUT /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}

参数​

响应​

200 (ClusterTaintPolicy): OK

201 (ClusterTaintPolicy): Created

update 替换指定 ClusterTaintPolicy 的状态​

HTTP 请求​

PUT /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}/status

参数​

响应​

200 (ClusterTaintPolicy): OK

201 (ClusterTaintPolicy): Created

patch 部分更新指定的 ClusterTaintPolicy​

HTTP 请求​

PATCH /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}

参数​

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

    ClusterTaintPolicy 的名称

  • body: Patch，必需

  • dryRun (查询参数): string

    dryRun

  • fieldManager (查询参数): string

    fieldManager

  • fieldValidation (查询参数): string

    fieldValidation

  • force (查询参数): boolean

    force

  • pretty (查询参数): string

    pretty

响应​

200 (ClusterTaintPolicy): OK

201 (ClusterTaintPolicy): Created

patch 部分更新指定 ClusterTaintPolicy 的状态​

HTTP 请求​

PATCH /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}/status

参数​

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

    ClusterTaintPolicy 的名称

  • body: Patch，必需

  • dryRun (查询参数): string

    dryRun

  • fieldManager (查询参数): string

    fieldManager

  • fieldValidation (查询参数): string

    fieldValidation

  • force (查询参数): boolean

    force

  • pretty (查询参数): string

    pretty

响应​

200 (ClusterTaintPolicy): OK

201 (ClusterTaintPolicy): Created

delete 删除 ClusterTaintPolicy​

HTTP 请求​

DELETE /apis/policy.karmada.io/v1alpha1/clustertaintpolicies/{name}

参数​

响应​

200 (Status): OK

202 (Status): Accepted

deletecollection 删除 ClusterTaintPolicy 集合​

HTTP 请求​

DELETE /apis/policy.karmada.io/v1alpha1/clustertaintpolicies

参数​

响应​

200 (Status): OK

编辑本页
最近更新时间 在 由 zhzhuang-zju