diff --git a/docs/upgrading/README.md b/docs/upgrading/README.md index 0fb25a714..24f743249 100644 --- a/docs/upgrading/README.md +++ b/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) @@ -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) diff --git a/docs/upgrading/v1.0-v1.1.md b/docs/upgrading/v1.0-v1.1.md new file mode 100644 index 000000000..aaf2e26d4 --- /dev/null +++ b/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.