Merge pull request #1421 from XiShanYongYe-Chang/doc-upgrade

Add upgrade document about v1.0-v1.1

docs/upgrading/README.md

@@ -10,6 +10,9 @@
     - [Upgrading Components](#upgrading-components)
   - [Details Upgrading Instruction](#details-upgrading-instruction)
     - [v0.8 to v0.9](#v08-to-v09)
+    - [v0.9 to v0.10](#v09-to-v010)
+    - [v0.10 to v1.0](#v010-to-v10)
+    - [v1.0 to v1.1](#v10-to-v11)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
@@ -75,3 +78,4 @@ v1.1.x to v1.2.x and the available patch versions are v1.2.0, v1.2.1 and v1.2.2,
 ### [v0.8 to v0.9](./v0.8-v0.9.md)
 ### [v0.9 to v0.10](./v0.9-v0.10.md)
 ### [v0.10 to v1.0](./v0.10-v1.0.md)
+### [v1.0 to v1.1](./v1.0-v1.1.md)

docs/upgrading/v1.0-v1.1.md

@@ -0,0 +1,43 @@
+# v1.0 to v1.1
+
+Follow the [Regular Upgrading Process](./README.md).
+
+## Upgrading Notable Changes
+
+The validation process for `Cluster` objects now has been moved from `karmada-webhook` to `karmada-aggregated-apiserver` 
+by [PR 1152](https://github.com/karmada-io/karmada/pull/1152), you have to remove the `Cluster` webhook configuration 
+from `ValidatingWebhookConfiguration`, such as:
+```diff
+diff --git a/artifacts/deploy/webhook-configuration.yaml b/artifacts/deploy/webhook-configuration.yaml
+index 0a89ad36..f7a9f512 100644
+--- a/artifacts/deploy/webhook-configuration.yaml
++++ b/artifacts/deploy/webhook-configuration.yaml
+@@ -69,20 +69,6 @@ metadata:
+   labels:
+     app: validating-config
+ webhooks:
+-  - name: cluster.karmada.io
+-    rules:
+-      - operations: ["CREATE", "UPDATE"]
+-        apiGroups: ["cluster.karmada.io"]
+-        apiVersions: ["*"]
+-        resources: ["clusters"]
+-        scope: "Cluster"
+-    clientConfig:
+-      url: https://karmada-webhook.karmada-system.svc:443/validate-cluster
+-      caBundle: {{caBundle}}
+-    failurePolicy: Fail
+-    sideEffects: None
+-    admissionReviewVersions: ["v1"]
+-    timeoutSeconds: 3
+   - name: propagationpolicy.karmada.io
+     rules:
+       - operations: ["CREATE", "UPDATE"]
+```
+
+Otherwise, when joining clusters(or updating Cluster objects) the request will be rejected with following errors:
+```
+Error: failed to create cluster(host) object. error: Internal error occurred: failed calling webhook "cluster.karmada.io": the server could not find the requested resource
+```
+
+Please refer to [v1.1.0 Release Notes](https://github.com/karmada-io/karmada/releases/tag/v1.1.0) for more details.