Skip to content

Commit

Permalink
translate: cluster-level resource propagation pause and resume capabi…
Browse files Browse the repository at this point in the history
…lities

Signed-off-by: changzhen <[email protected]>
  • Loading branch information
XiShanYongYe-Chang committed Aug 16, 2024
1 parent 40cdcd7 commit d2bb699
Show file tree
Hide file tree
Showing 5 changed files with 76 additions and 5 deletions.
7 changes: 3 additions & 4 deletions docs/userguide/scheduling/resource-propagating.md
Original file line number Diff line number Diff line change
Expand Up @@ -671,14 +671,13 @@ spec:
```
The `nginx` deployment in `default` namespace will be propagated to cluster `member2`.


## Suspend and resume of resource propagation

The `.spec.suspension` field in the `PropagationPolicy` and `ClusterPropagationPolicy` allows suspending and resuming resource propagation to one or more clusters.

### Suspend resource propagation to all clusters

To suspend resource propagfation work to all member clusters, use the following configuration:
To suspend resource propagation work to all member clusters, use the following configuration:

```yaml
apiVersion: policy.karmada.io/v1alpha1
Expand All @@ -701,7 +700,7 @@ Updates to the `nginx` deployment in the Karmada control plane will not be synch

### Suspend resource propagation to specific clusters

To suspend resource propgation to individual member clusters, specify the cluster names in the `.spec.suspension.clusterNames` field:
To suspend resource propagation to individual member clusters, specify the cluster names in the `.spec.suspension.clusterNames` field:

```yaml
apiVersion: policy.karmada.io/v1alpha1
Expand All @@ -717,7 +716,7 @@ spec:
- member3
#...
suspension:
clusterNames: ["member3"]
clusterNames: ["member3"] # Modify the cluster name here
```

Updates to the `nginx` deployment in the Karmada control plane will not be synchronized to the `member3` cluster but will be synchronized to all other clusters.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ title: Karmada 事件参考
| InterpretHealthSucceed | Work | Normal | work-status-controller |
| SyncFailed | Work | Warning | execution-controller |
| SyncSucceed | Work | Normal | execution-controller |
| WorkDispatching | Work | Normal | execution-controller |
| CleanupWorkFailed | ResourceBinding<br/>ClusterResourceBinding | Warning | binding-controller<br/>cluster-resource-binding-controller |
| SyncScheduleResultToDependenciesSucceed | ResourceBinding<br/>ClusterResourceBinding | Normal | dependencies-distributor |
| SyncScheduleResultToDependenciesFailed | ResourceBinding<br/>ClusterResourceBinding | Warning | dependencies-distributor |
Expand Down
Original file line number Diff line number Diff line change
@@ -1 +1 @@
<mxfile host="Electron" modified="2020-11-25T09:56:00.544Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/12.9.13 Chrome/80.0.3987.163 Electron/8.2.1 Safari/537.36" etag="kak3FtXZ4eCliDUD2HFw" version="12.9.13" type="device"><diagram id="C5RBs43oDa-KdzZeNtuy" name="Page-1">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</diagram></mxfile>
<mxfile host="app.diagrams.net" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36" version="24.7.6"><diagram name="Page-1" id="M6yWU5w82lywSmNtNJ9b">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</diagram></mxfile>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -671,3 +671,74 @@ spec:
```
The `nginx` deployment in `default` namespace will be propagated to cluster `member2`.


## 暂停与恢复资源分发

`PropagationPolicy` 和 `ClusterPropagationPolicy` 中的 `.spec.suspension` 字段允许对一个或多个集群的资源分发进行暂停和恢复。

### 暂停向所有集群分发资源

为了暂停向所有成员集群分发资源,您可以使用以下配置:

```yaml
apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
name: nginx-propagation
spec:
#...
placement:
clusterAffinity:
exclude:
- member1
- member3
#...
suspension:
dispatching: true
```

在 Karmada 控制平面上对 `nginx` Deployment 的更新将不会被同步到任何成员集群。

### 暂停向特定集群分发资源

为了暂停向个别的成员集群分发资源,您可以在 `.spec.suspension.clusterNames` 字段中指定集群名称:

```yaml
apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
name: nginx-propagation
spec:
#...
placement:
clusterAffinity:
exclude:
- member1
- member3
#...
suspension:
clusterNames: ["member3"] # 修改此处的集群名称
```

在 Karmada 控制平面上对 `nginx` Deployment 的更新将不会被同步到 `member3` 集群,但会被同步到所有其他集群。

### 恢复资源分发

为了恢复资源工作,您只需移除 `.spec.suspension` 配置:

```yaml
apiVersion: policy.karmada.io/v1alpha1
kind: PropagationPolicy
metadata:
name: nginx-propagation
spec:
#...
placement:
clusterAffinity:
exclude:
- member1
- member3
#...
```

Karmada 控制平面中的 `nginx` Deployment 状态将被同步到所有成员集群,任何后续的更新也将被同步。

0 comments on commit d2bb699

Please sign in to comment.