ClusterPropagationPolicy v1alpha1

apiVersion: policy.karmada.io/v1alpha1

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

ClusterPropagationPolicy

ClusterPropagationPolicy 表示将一组资源分发到一个或多个集群的集群策略。与只能在其命名空间内分发资源的 PropagationPolicy 相比，ClusterPropagationPolicy 能够在系统命名空间之外的任何命名空间内分发集群级别的资源。系统命名空间包括：karmada-system、karmada-cluster、karmada-es-*。

  • apiVersion：policy.karmada.io/v1alpha1

  • kind：ClusterPropagationPolicy

  • metadata (ObjectMeta)

  • spec (PropagationSpec)，必选

    Spec 表示 ClusterPropagationPolicy 的规范。

    PropagationSpec 表示 PropagationPolicy 的规范。

    • spec.resourceSelectors ([]ResourceSelector)，必选

      ResourceSelectors 用于选择资源。不允许设置为 nil 或者留空。为安全起见，避免 Secret 等敏感资源被无意分发，不会匹配全部的资源。

      ResourceSelector 用于选择资源。

      • spec.resourceSelectors.apiVersion (string)，必选

        APIVersion 表示目标资源的 API 版本。

      • spec.resourceSelectors.kind (string)，必选

        Kind 表示目标资源的类别。

      • spec.resourceSelectors.labelSelector (LabelSelector)

        查询一组资源的标签。如果 name 不为空，labelSelector 会被忽略。

      • spec.resourceSelectors.name (string)

        目标资源的名称。默认值为空，意味着将选择所有的资源。

      • spec.resourceSelectors.namespace (string)

        目标资源的 namespace。默认值为空，意味着从父对象作用域继承资源。

    • spec.association (boolean)

      Association 表示是否自动选择相关资源，例如，被 Deployment 引用的 ConfigMap。默认值为 false。Deprecated 表示改用 PropagateDeps。

    • spec.conflictResolution (string)

      ConflictResolution 表示当目标集群中已存在正在分发的资源时，处理潜在冲突的方式。

      默认值为 Abort，表示停止分发资源以避免意外覆盖。将原集群资源迁移到 Karmada 时，可设置为“Overwrite”。此时，冲突是可预测的，且 Karmada 可通过覆盖来接管资源。

    • spec.dependentOverrides ([]string)

      DependentOverrides 罗列在当前 PropagationPolicy 生效之前必须出现的覆盖（OverridePolicy）。

      它指明当前 PropagationPolicy 所依赖的覆盖。当用户同时创建 OverridePolicy 和资源时，一般希望可以采用新创建的策略。

      注意：如果当前命名空间中的 OverridePolicy 和 ClusterOverridePolicy 与资源匹配，即使它们不在列表中，仍将被应用于覆盖。

    • spec.failover (FailoverBehavior)

      Failover 表示 Karmada 在故障场景中迁移应用的方式。如果值为 nil，则禁用故障转移。

      FailoverBehavior 表示应用或集群的故障转移。

      • spec.failover.application (ApplicationFailoverBehavior)

        Application 表示应用的故障转移。如果值为 nil，则禁用故障转移。如果值不为 nil，则 PropagateDeps 应设置为 true，以便依赖项随应用一起迁移。

        ApplicationFailoverBehavior 表示应用的故障转移。

        • spec.failover.application.decisionConditions (DecisionConditions)，必选

          DecisionConditions 表示执行故障转移的先决条件。只有满足所有条件，才能执行故障转移。当前条件为 TolerationSeconds（可选）。

          DecisionConditions 表示执行故障转移的先决条件。

          • spec.failover.application.decisionConditions.tolerationSeconds (int32)

            TolerationSeconds 表示应用达到预期状态后，Karmada 在执行故障转移之前应等待的时间。如果未指定，Karmada 将立即执行故障转移。默认为 300 秒。

        • spec.failover.application.gracePeriodSeconds (int32)

          GracePeriodSeconds 表示从新集群中删除应用之前的最长等待时间（以秒为单位）。仅当 PurgeMode 设置为 Graciously 且默认时长为 600 秒时，才需要设置该字段。如果新群集中的应用无法达到健康状态，Karmada 将在达到最长等待时间后删除应用。取值只能为正整数。

        • spec.failover.application.purgeMode (string)

          PurgeMode 表示表示原集群中应用的处理方式。取值包括 Immediately、Graciously 和 Never。默认为 Graciously。

    • spec.placement (Placement)

      Placement 表示选择集群以分发资源的规则。

      Placement 表示选择集群的规则。

      • spec.placement.clusterAffinities ([]ClusterAffinityTerm)

        ClusterAffinities 表示多个集群组的调度限制（ClusterAffinityTerm 指定每种限制）。

        调度器将按照这些组在规范中出现的顺序逐个评估，不满足调度限制的组将被忽略。除非该组中的所有集群也属于下一个组（同一集群可以属于多个组），否则将不会选择此组中的所有集群。

        如果任何组都不满足调度限制，则调度失败，任何群集都不会被选择。

        注意：

        1. ClusterAffinities 不能与 ClusterAffinity 共存。
        2. 如果未同时设置 ClusterAffinities 和 ClusterAffinity，则任何集群都可以作为调度候选集群。

        潜在用例1：本地数据中心的私有集群为主集群组，集群提供商的托管集群是辅助集群组。Karmada 调度器更愿意将工作负载调度到主集群组，只有在主集群组不满足限制（如缺乏资源）的情况下，才会考虑辅助集群组。

        潜在用例2：对于容灾场景，系统管理员可定义主集群组和备份集群组，工作负载将首先调度到主集群组，当主集群组中的集群发生故障（如数据中心断电）时，Karmada 调度器可以将工作负载迁移到备份集群组。

        ClusterAffinityTerm 用于选择集群。

        • spec.placement.clusterAffinities.affinityName (string)，必选

          AffinityName 是集群组的名称。

        • spec.placement.clusterAffinities.clusterNames ([]string)

          ClusterNames 罗列待选择的集群。

        • spec.placement.clusterAffinities.exclude ([]string)

          ExcludedClusters 罗列待忽略的集群。

        • spec.placement.clusterAffinities.fieldSelector (FieldSelector)

          FieldSelector 是一个按字段选择成员集群的过滤器。匹配表达式的键（字段）为 provider、region 或 zone，匹配表达式的运算符为 In 或 NotIn。如果值不为 nil，也未留空，仅选择与此过滤器匹配的集群。

          FieldSelector 是一个字段过滤器。

          • spec.placement.clusterAffinities.fieldSelector.matchExpressions ([][NodeSelectorRequirement](../common-definitions/node-selector-requirement#nodeselectorrequirement))

            字段选择器要求列表。

        • spec.placement.clusterAffinities.labelSelector (LabelSelector)

          LabelSelector 是一个按标签选择成员集群的过滤器。如果值不为 nil，也未留空，仅选择与此过滤器匹配的集群。

      • spec.placement.clusterAffinity (ClusterAffinity)

        ClusterAffinity 表示对某组集群的调度限制。注意：

        1. ClusterAffinity 不能与 ClusterAffinities 共存。
        2. 如果未同时设置 ClusterAffinities 和 ClusterAffinity，则任何集群都可以作为调度候选集群。

        ClusterAffinity 是用于选择集群的过滤条件。

        • spec.placement.clusterAffinity.clusterNames ([]string)

          ClusterNames 罗列待选择的集群。

        • spec.placement.clusterAffinity.exclude ([]string)

          ExcludedClusters 罗列待忽略的集群。

        • spec.placement.clusterAffinity.fieldSelector (FieldSelector)

          FieldSelector 是一个按字段选择成员集群的过滤器。匹配表达式的键（字段）为 provider、region 或 zone，匹配表达式的运算符为 In 或 NotIn。如果值不为 nil，也未留空，仅选择与此过滤器匹配的集群。

          FieldSelector 是一个字段过滤器。

          • spec.placement.clusterAffinity.fieldSelector.matchExpressions ([][NodeSelectorRequirement](../common-definitions/node-selector-requirement#nodeselectorrequirement))

            字段选择器要求列表。

        • spec.placement.clusterAffinity.labelSelector (LabelSelector)

          LabelSelector 是一个按标签选择成员集群的过滤器。如果值不为 nil，也未留空，仅选择与此过滤器匹配的集群。

      • spec.placement.clusterTolerations ([]Toleration)

        ClusterTolerations 表示容忍度。

        附加此容忍度的 Pod 能够容忍任何使用匹配运算符 <operator> 匹配三元组 <key,value,effect> 所得到的污点。

        • spec.placement.clusterTolerations.effect (string)

          Effect 表示要匹配的污点效果。留空表示匹配所有污点效果。如果设置此字段，允许的值为 NoSchedule、PreferNoSchedule 或 NoExecute。

          枚举值包括：

          • "NoExecute"：任何不能容忍该污点的 Pod 都会被驱逐。当前由 NodeController 强制执行。
          • "NoSchedule"：如果新 pod 无法容忍该污点，不允许新 pod 调度到节点上，但允许由 kubelet 调度但不需要调度器启动的所有 pod，并允许节点上已存在的 pod 继续运行。由调度器强制执行。
          • "PreferNoSchedule"：和 TaintEffectNoSchedule 相似，不同的是调度器尽量避免将新 Pod 调度到具有该污点的节点上，除非没有其他节点可调度。由调度器强制执行。

        • spec.placement.clusterTolerations.key (string)

          key 是容忍度的污点键。留空表示匹配所有污点键。如果键为空，则运算符必须为 Exists，所有值和所有键都会被匹配。

        • spec.placement.clusterTolerations.operator (string)

          Operator 表示一个键与其值的关系。有效的运算符包括 Exists 和 Equal。默认为 Equal。Exists 相当于将值设置为通配符，因此一个 Pod 可以容忍特定类别的所有污点。

          枚举值包括：

          • "Equal"
          • "Exists"

        • spec.placement.clusterTolerations.tolerationSeconds (int64)

          TolerationSeconds 表示容忍度容忍污点的时间段（Effect 的取值为 NoExecute，否则忽略此字段）。默认情况下，不设置此字段，表示永远容忍污点（不驱逐）。零和负值将被系统视为 0（立即驱逐）。

        • spec.placement.clusterTolerations.value (string)

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

      • spec.placement.replicaScheduling (ReplicaSchedulingStrategy)

        ReplicaScheduling 表示将 spec 中规约的副本资源（例如 Deployments、Statefulsets）分发到成员集群时处理副本数量的调度策略。

        ReplicaSchedulingStrategy 表示副本的分配策略。

        • spec.placement.replicaScheduling.replicaDivisionPreference (string)

          当 ReplicaSchedulingType 设置为 Divided 时，由 ReplicaDivisionPreference 确定副本的分配策略。取值包括 Aggregated 和 Weighted。Aggregated：将副本分配给尽可能少的集群，同时考虑集群的资源可用性。Weighted：根据 WeightPreference 按权重分配副本。

        • spec.placement.replicaScheduling.replicaSchedulingType (string)

          ReplicaSchedulingType 确定 Karmada 分发资源时副本的调度方式。取值包括 Duplicated 和 Divided。Duplicated：将相同的副本从资源复制到每个候选成员群集。Divided：根据有效候选成员集群的数量分配副本，每个集群的副本由 ReplicaDivisionPreference 确定。

        • spec.placement.replicaScheduling.weightPreference (ClusterPreferences)

          WeightPreference 描述每个集群或每组集群的权重。如果 ReplicaDivisionPreference 设置为 Weighted，但 WeightPreference 未设置，调度器将为所有集群设置相同的权重。

          ClusterPreferences 描述了每个集群或每组集群的权重。

          • spec.placement.replicaScheduling.weightPreference.dynamicWeight (string)

            DynamicWeight 指生成动态权重列表的因子。如果指定，StaticWeightList 将被忽略。

          • spec.placement.replicaScheduling.weightPreference.staticWeightList ([]StaticClusterWeight)

            StaticWeightList 罗列静态集群权重。

            StaticClusterWeight 定义静态集群权重。

            • spec.placement.replicaScheduling.weightPreference.staticWeightList.targetCluster (ClusterAffinity)，必选

              TargetCluster 是选择集群的过滤器。

              ClusterAffinity 表示用于选择集群的过滤条件。

              • spec.placement.replicaScheduling.weightPreference.staticWeightList.targetCluster.clusterNames ([]string)

                ClusterNames 罗列待选择的集群。

              • spec.placement.replicaScheduling.weightPreference.staticWeightList.targetCluster.exclude ([]string)

                ExcludedClusters 罗列待忽略的集群。

              • spec.placement.replicaScheduling.weightPreference.staticWeightList.targetCluster.fieldSelector (FieldSelector)

                FieldSelector 是一个按字段选择成员集群的过滤器。匹配表达式的键（字段）为 provider、region 或 zone，匹配表达式的运算符为 In 或 NotIn。如果值不为 nil，也未留空，仅选择与此过滤器匹配的集群。

                FieldSelector 是一个字段过滤器。

                • spec.placement.replicaScheduling.weightPreference.staticWeightList.targetCluster.fieldSelector.matchExpressions ([][NodeSelectorRequirement](../common-definitions/node-selector-requirement#nodeselectorrequirement))

                  字段选择器要求列表。

              • spec.placement.replicaScheduling.weightPreference.staticWeightList.targetCluster.labelSelector (LabelSelector)

                LabelSelector 是一个按标签选择成员集群的过滤器。如果值不为 nil，也未留空，仅选择与此过滤器匹配的集群。

            • spec.placement.replicaScheduling.weightPreference.staticWeightList.weight (int64), required

              Weight 表示优先选则 TargetCluster 指定的集群。

      • spec.placement.spreadConstraints ([]SpreadConstraint)

        SpreadConstraints 表示调度约束列表。

        SpreadConstraint 表示资源分布的约束。

        • spec.placement.spreadConstraints.maxGroups (int32)

          MaxGroups 表示要选择的集群组的最大数量。

        • spec.placement.spreadConstraints.minGroups (int32)

          MinGroups 表示要选择的集群组的最小数量。默认值为 1。

        • spec.placement.spreadConstraints.spreadByField (string)

          SpreadByField 是 Karmada 集群 API 中的字段，该API用于将成员集群分到不同集群组。资源将被分发到不同的集群组中。可用的字段包括 cluster、region、zone 和 provider。SpreadByField 不能与 SpreadByLabel 共存。如果两个字段都为空，SpreadByField 默认为 cluster。

        • spec.placement.spreadConstraints.spreadByLabel (string)

          SpreadByLabel 表示用于将成员集群分到不同集群组的标签键。资源将被分发到不同的集群组中。SpreadByLabel 不能与 SpreadByField 共存。

    • spec.preemption (string)

      Preemption 表示资源抢占。取值包括 Always 和 Never。

      枚举值包括：

      • "Always"：允许抢占。如果 Always 应用于 PropagationPolicy，则会根据优先级抢占资源。只要 PropagationPolicy 和 ClusterPropagationPolicy 能匹配 ResourceSelector 中定义的规则，均可用于声明资源。此外，如果资源已经被 ClusterPropagationPolicy 声明，PropagationPolicy 仍然可以抢占该资源，无需考虑优先级。如果 Always 应用于 ClusterPropagationPolicy，只有 ClusterPropagationPolicy 能抢占资源。
      • "Never"：PropagationPolicy（或 ClusterPropagationPolicy）不抢占资源。

  • spec.priority (int32)

    Priority 表示策略（PropagationPolicy 或 ClusterPropagationPolicy）的重要性。对于每条策略，如果在资源模板中没有其他优先级更高的策略，则将为匹配的资源模板应用该策略。一旦资源模板被某个策略声明，默认情况下该模板不会被优先级更高的策略抢占。查看 Preemption 字段，了解更多信息。

    如果两条策略有相同的优先级，会使用 ResourceSelector 中有更精确匹配规则的策略。

    • 按 name(resourceSelector.name) 匹配的优先级高于按 selector(resourceSelector.labelSelector) 匹配。
    • 按 selector(resourceSelector.labelSelector) 匹配的优先级又高于按 APIVersion(resourceSelector.apiVersion) 或 Kind(resourceSelector.kind) 匹配。 如果优先级相同，则按字母顺序，会使用字母排名更前的策略，比如，名称以 bar 开头的策略的优先级高于以 foo 开头的策略。

    值越大，优先级越高。默认值为 0。

  • spec.propagateDeps (boolean)

    PropagateDeps 表示相关资源是否被自动分发。以引用 ConfigMap 和 Secret 的 Deployment 为例，当 propagateDeps 为 true 时，resourceSelectors 不引用资源（以减少配置），ConfigMap 和 Secret 将与 Deployment 一起被分发。此外，在故障转移场景中，引用资源将与 Deployment 一起迁移。

    默认值为 false。

    • spec.schedulerName (string)

      SchedulerName 表示要继续进行调度的调度器。如果指定，将由指定的调度器调度策略。如果未指定，将由默认调度器调度策略。

ClusterPropagationPolicyList

ClusterPropagationPolicyList 罗列 ClusterPropagationPolicy。

  • apiVersion：policy.karmada.io/v1alpha1

  • kind: ClusterPropagationPolicyList

  • metadata (ListMeta)

  • items ([][ClusterPropagationPolicy](../policy-resources/cluster-propagation-policy-v1alpha1#clusterpropagationpolicy)), required

操作

get：查询指定的 ClusterPropagationPolicy

HTTP 请求

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

参数

  • 名称（路径参数）：string，必选

    ClusterPropagationPolicy 的名称

  • pretty（查询参数）：string

    pretty

响应

200 (ClusterPropagationPolicy)：OK

get：查询指定 ClusterPropagationPolicy 的状态

HTTP 请求

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

参数

  • 名称（路径参数）：string，必选

    ClusterPropagationPolicy的名称

  • pretty（查询参数）：string

    pretty

响应

200 (ClusterPropagationPolicy)：OK

list 罗列或者监听 ClusterPropagationPolicy 类型的对象

HTTP 请求

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

参数

响应

200 (ClusterPropagationPolicyList)：OK

create：创建一条 ClusterPropagationPolicy

HTTP 请求

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

参数

响应

200 (ClusterPropagationPolicy)：OK

201 (ClusterPropagationPolicy)：Created

202 (ClusterPropagationPolicy)：Accepted

update：更新指定的 ClusterPropagationPolicy

HTTP 请求

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

参数

响应

200 (ClusterPropagationPolicy)：OK

201 (ClusterPropagationPolicy)：Created

update：更新指定 ClusterPropagationPolicy 的状态

HTTP 请求

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

参数

响应

200 (ClusterPropagationPolicy)：OK

201 (ClusterPropagationPolicy)：Created

patch：更新指定 ClusterPropagationPolicy 的部分信息

HTTP 请求

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

参数

  • 名称（路径参数）：string，必选

    ClusterPropagationPolicy 的名称

  • body: Patch，必选

  • dryRun（查询参数）：string

    dryRun

  • fieldManager（查询参数）：string

    fieldManager

  • fieldValidation（查询参数）：string

    fieldValidation

  • force（查询参数）：boolean

    force

  • pretty（查询参数）：string

    pretty

响应

200 (ClusterPropagationPolicy)：OK

201 (ClusterPropagationPolicy)：Created

patch：更新指定 ClusterPropagationPolicy 状态的部分信息

HTTP 请求

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

参数

  • 名称（路径参数）：string，必选

    ClusterPropagationPolicy 的名称

  • body: Patch，必选

  • dryRun（查询参数）：string

    dryRun

  • fieldManager（查询参数）：string

    fieldManager

  • fieldValidation（查询参数）：string

    fieldValidation

  • force（查询参数）：boolean

    force

  • pretty（查询参数）：string

    pretty

响应

200 (ClusterPropagationPolicy)：OK

201 (ClusterPropagationPolicy)：Created

delete：删除一条 ClusterPropagationPolicy

HTTP 请求

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

参数

  • 名称（路径参数）：string，必选

    ClusterPropagationPolicy 的名称

  • body: DeleteOptions

  • dryRun（查询参数）：string

    dryRun

  • gracePeriodSeconds（in query）：integer

    gracePeriodSeconds

  • pretty（查询参数）：string

    pretty

  • propagationPolicy（in query）：string

    propagationPolicy

响应

200 (Status)：OK

202 (Status)：Accepted

deletecollection：删除所有 ClusterPropagationPolicy

HTTP 请求

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

参数

响应

200 (Status)：OK