diff --git a/blog/2024-09-13-karmada-v1.11/img/contributors.png b/blog/2024-09-13-karmada-v1.11/img/contributors.png new file mode 100644 index 00000000..3362dc55 Binary files /dev/null and b/blog/2024-09-13-karmada-v1.11/img/contributors.png differ diff --git a/blog/2024-09-13-karmada-v1.11/img/rollout-00.png b/blog/2024-09-13-karmada-v1.11/img/rollout-00.png new file mode 100644 index 00000000..326f6410 Binary files /dev/null and b/blog/2024-09-13-karmada-v1.11/img/rollout-00.png differ diff --git a/blog/2024-09-13-karmada-v1.11/img/rollout-01.png b/blog/2024-09-13-karmada-v1.11/img/rollout-01.png new file mode 100644 index 00000000..c076dde4 Binary files /dev/null and b/blog/2024-09-13-karmada-v1.11/img/rollout-01.png differ diff --git a/blog/2024-09-13-karmada-v1.11/img/rollout-02.png b/blog/2024-09-13-karmada-v1.11/img/rollout-02.png new file mode 100644 index 00000000..a40419a0 Binary files /dev/null and b/blog/2024-09-13-karmada-v1.11/img/rollout-02.png differ diff --git a/blog/2024-09-13-karmada-v1.11/img/rollout-03.png b/blog/2024-09-13-karmada-v1.11/img/rollout-03.png new file mode 100644 index 00000000..71692a6e Binary files /dev/null and b/blog/2024-09-13-karmada-v1.11/img/rollout-03.png differ diff --git a/blog/2024-09-13-karmada-v1.11/karmada-v1.11.md b/blog/2024-09-13-karmada-v1.11/karmada-v1.11.md new file mode 100644 index 00000000..40312954 --- /dev/null +++ b/blog/2024-09-13-karmada-v1.11/karmada-v1.11.md @@ -0,0 +1,127 @@ +# Karmada v1.11 version released! New cross-cluster rolling upgrade capability for workload! + +Karmada is an open multi-cloud and multi-cluster container orchestration engine designed to help users deploy and operate business applications in a multi-cloud environment. With its compatibility with the native Kubernetes API, Karmada can smoothly migrate single-cluster workloads while still maintaining coordination with the surrounding Kubernetes ecosystem tools. + +This version includes the following new features: +- Supports cross-cluster rolling upgrades of federated workloads, making the user's version release process more flexible and controllable. +- karmadactl has added multiple operational capabilities, providing a unique multi-cluster operational experience. +- It provides standardized generation semantics for federated workloads, enabling CD execution in one step. +Karmada Operator supports custom CRD download strategies, making offline deployment more flexible. +- Overview of New Features + +## Cross-Cluster Rolling Upgrade of Federated Workloads + +In the latest released v1.11 version, Karmada has added the feature of cross-cluster rolling upgrades for federated workloads. This feature is particularly suitable for workloads deployed across multiple clusters, allowing users to adopt more flexible and controllable rolling upgrade strategies when releasing new versions of their workloads. Users can finely control the upgrade process to ensure a smooth transition for each cluster during the upgrade, minimizing the impact on the production environment. This feature not only enhances the user experience but also provides more flexibility and reliability for complex multi-cluster management. + +Below is an example to demonstrate how to perform a rolling upgrade on federated workloads: + +Assuming that the user has already propagated the Deployment to three member clusters through PropagationPolicy: `ClusterA`, `ClusterB`, `ClusterC`: + +```yaml +apiVersion: policy.karmada.io/v1alpha1 +kind: PropagationPolicy +metadata: + name: nginx-propagation +spec: + resourceSelectors: + - apiVersion: apps/v1 + kind: Deployment + name: nginx + placement: + clusterAffinity: + clusterNames: + - ClusterA + - ClusterB + - ClusterC +``` + +![rollout step 0](./img/rollout-00.png) + +At this point, the version of the Deployment is v1. To upgrade the Deployment resource version to v2, you can perform the following steps in sequence. + +Firstly, configure the PropagationPolicy to temporarily halt the propagation of resources to `ClusterA` and `ClusterB`, so that the deployment changes will only occur in `ClusterC`: + +```yaml +apiVersion: policy.karmada.io/v1alpha1 +kind: PropagationPolicy +metadata: + name: nginx-propagation +spec: + #... + suspension: + dispatchingOnClusters: + clusterNames: + - ClusterA + - ClusterB +``` + +![rollout step 1](./img/rollout-01.png) + +Then, update the PropagationPolicy resource to allow the system to synchronize the new version of the resources to the `ClusterB` cluster: + +```yaml + suspension: + dispatchingOnClusters: + clusterNames: + - ClusterA +``` + +![rollout step 2](./img/rollout-02.png) + +Finally, remove the `suspension` field from the PropagationPolicy resource to allow the system to synchronize the new version of the resources to the `ClusterA` cluster: + +![rollout step 3](./img/rollout-03.png) + +From the example above, we can see that by using the cross-cluster rolling upgrade capability of federated workloads, the new version of the workload can be rolled out cluster by cluster, and precise control can be achieved. + +Additionally, this feature can also be applied to other scenarios, particularly for developers facing situations where resources are frequently updated due to competition between the Karmada control plane and member clusters for resource control. In such cases, suspending the synchronizing process of resources to member clusters can facilitate the quick identification of issues. + +## Enhancements to karmadactl + +In this version, the Karmada community has focused on enhancing Karmadactl capabilities to provide a better multi-cluster operations experience, thereby reducing users' reliance on kubectl. + +### A More Extensive Command Set + +Karmadactl now supports a richer command set including `create`, `patch`, `delete`, `label`, `annotate`, `edit`, `attach`, `top node`, `api-resources`, and `explain`. These commands allow users to perform more operations on resources either on the Karmada control plane or member clusters. + +### Enhanced Functionality + +Karmadactl introduces the `--operation-scope` parameter to control the scope of command operations. With this new parameter, commands such as `get`, `describe`, `exec`, and `explain` can flexibly switch between cluster perspectives to operate on resources in the Karmada control plane or member clusters. + +### More Detailed Command Output Information + +The output of the `karmadactl get cluster` command now includes additional details such as the cluster object's `Zones`, `Region`, `Provider`, `API-Endpoint`, and `Proxy-URL`. + +Through these capability enhancements, the operational experience with karmadactl has been improved. New features and more detailed information about karmadactl can be accessed using `karmadactl --help`. + +## Standardization of Federation Workload Generation Semantics + +In this version, Karmada has standardized the generation semantics of workload at the federation level. This update provides a reliable reference for the release system, enhancing the accuracy of cross-cluster deployments. By standardizing generation semantics, Karmada simplifies the release process and ensures consistent tracking of workload status, making it easier to manage and monitor applications across multiple clusters. + +The specifics of the standardization are as follows: the observedGeneration value in the status of the federated workload is set to its own `.metadata.generation` value only when the state of resources distributed to all member clusters satisfies `status.observedGeneration` >= `metadata.generation`. This ensures that the corresponding controllers in each member cluster have completed processing of the workload. This move aligns the generation semantics at the federation level with those of Kubernetes clusters, allowing users to more conveniently migrate single-cluster applications to a multi-cluster setup. + +The following resources have been adapted in this version: + +- GroupVersion: apps/v1 Kind: Deployment, DaemonSet, StatefulSet +- GroupVersion: apps.kruise.io/v1alpha1 Kind: CloneSet, DaemonSet +- GroupVersion: apps.kruise.io/v1beta1 Kind: StatefulSet +- GroupVersion: helm.toolkit.fluxcd.io/v2beta1 Kind: HelmRelease +- GroupVersion: kustomize.toolkit.fluxcd.io/v1 Kind: Kustomization +- GroupVersion: source.toolkit.fluxcd.io/v1 Kind: GitRepository +- GroupVersion: source.toolkit.fluxcd.io/v1beta2 Kind: Bucket, HelmChart, HelmRepository, OCIRepository + +If you need to adapt more resources (including CRDs), you can provide feedback to the Karmada community or extend using the Resource Interpreter. + +## Karmada Operator Supports Custom CRD Download Strategies + +CRD (Custom Resource Definition) resources are key prerequisite resources used by the Karmada Operator to configure new Karmada instances. These CRD resources contain critical API definitions for the Karmada system, such as PropagationPolicy, ResourceBinding, and Work. + +In version v1.11, the Karmada Operator supports custom CRD download strategies. With this feature, users can specify the download path for CRD resources and define additional download strategies, providing a more flexible offline deployment method. + +For a detailed description of this feature, refer to the [proposal: Custom CRD Download Strategy Support for Karmada Operator](https://github.com/karmada-io/karmada/tree/master/docs/proposals/operator-custom-crd-download-strategy). + +# Acknowledging Our Contributors + +The Karmada v1.11 release includes 223 code commits from 36 contributors. We would like to extend our sincere gratitude to all the contributors: + +![karmada v1.11 contributors](./img/contributors.png) diff --git a/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/contributors.png b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/contributors.png new file mode 100644 index 00000000..3362dc55 Binary files /dev/null and b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/contributors.png differ diff --git a/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-00.png b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-00.png new file mode 100644 index 00000000..326f6410 Binary files /dev/null and b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-00.png differ diff --git a/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-01.png b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-01.png new file mode 100644 index 00000000..c076dde4 Binary files /dev/null and b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-01.png differ diff --git a/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-02.png b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-02.png new file mode 100644 index 00000000..a40419a0 Binary files /dev/null and b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-02.png differ diff --git a/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-03.png b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-03.png new file mode 100644 index 00000000..71692a6e Binary files /dev/null and b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/img/rollout-03.png differ diff --git a/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/karmada-v1.11.md b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/karmada-v1.11.md new file mode 100644 index 00000000..b1853c5e --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-blog/2024-09-13-karmada-v1.11/karmada-v1.11.md @@ -0,0 +1,127 @@ +# Karmada v1.11 版本发布！新增应用跨集群滚动升级能力！ + +Karmada 是开放的多云多集群容器编排引擎，旨在帮助用户在多云环境下部署和运维业务应用。凭借兼容 Kubernetes 原生 API 的能力，Karmada 可以平滑迁移单集群工作负载，并且仍可保持与 Kubernetes 周边生态工具链协同。 + +本版本包含下列新增特性： + +- 支持联邦应用跨集群滚动升级，使用户版本发布流程更加灵活可控； +- karmadactl 新增了多项运维能力，提供独特的多集群运维体验； +- 为联邦工作负载提供标准化 generation 语义，使 CD 执行一步到位； +- Karmada Operator 支持自定义 CRD 下载策略，使离线部署更灵活。 + +## 联邦应用跨集群滚动升级 + +在最新发布的 v1.11 版本中，Karmada 新增了联邦应用跨集群滚动升级特性。这一特性特别适用于那些部署在多个集群上的应用，使得用户在发布应用新版本时能够采用更加灵活和可控的滚动升级策略。用户可以精细地控制升级流程，确保每个集群在升级过程中都能够平滑过渡，减少对生产环境的影响。这一特性不仅提升了用户体验，也为复杂的多集群管理提供了更多的灵活性和可靠性。 + +下面通过一个示例来演示如何对联邦应用进行滚动升级： + +假定用户已经通过 PropagationPolicy 将 Deployment 应用分发到三个成员集群中：`ClusterA`、`ClusterB`、`ClusterC`： + +```yaml +apiVersion: policy.karmada.io/v1alpha1 +kind: PropagationPolicy +metadata: + name: nginx-propagation +spec: + resourceSelectors: + - apiVersion: apps/v1 + kind: Deployment + name: nginx + placement: + clusterAffinity: + clusterNames: + - ClusterA + - ClusterB + - ClusterC +``` + +![rollout step 0](./img/rollout-00.png) + +此时 Deployment 版本为v1，为了将 Deployment 资源版本升级至 v2，您可以依次执行下列步骤。 + +首先，通过配置 PropagationPolicy 策略，暂时停止向 `ClusterA` 和 `ClusterB` 分发资源，从而应用的变更将只发生在 `ClusterC`： + +```yaml +apiVersion: policy.karmada.io/v1alpha1 +kind: PropagationPolicy +metadata: + name: nginx-propagation +spec: + #... + suspension: + dispatchingOnClusters: + clusterNames: + - ClusterA + - ClusterB +``` + +![rollout step 1](./img/rollout-01.png) + +然后更新 PropagationPolicy 资源，允许系统向 `ClusterB` 集群同步新版本资源： + +```yaml + suspension: + dispatchingOnClusters: + clusterNames: + - ClusterA +``` + +![rollout step 2](./img/rollout-02.png) + +最后删除 PropagationPolicy 资源中的 `suspension` 字段，允许系统向 `ClusterA` 集群同步新版本资源： + +![rollout step 3](./img/rollout-03.png) + +从上述示例中我们可以看到，利用联邦应用跨集群滚动发布能力，新版本应用可以做到按集群粒度滚动升级，并且可以做到精准控制。 + +此外，该功能还可以应用于其他场景，特别是对于开发者来说，由于 Karmada 控制平面和成员集群之间争夺资源控制权而导致资源频繁更新的情况。在这种情况下，暂停资源与成员集群的同步过程可以方便快速识别问题。 + +## karmadactl 能力增强 + +在本版本中，Karmada 社区致力于增强 Karmadactl 的能力，以便提供更好的多集群运维体验，进而摆脱用户对 kubectl 的依赖。 + +### 更丰富的命令集 + +Karmadactl 支持更丰富的命令集，如 `create`、`patch`、`delete`、`label`、`annotate`、`edit`、`attach`、`top node`、`api-resources` 以及 `explain`，这些命令允许用户对 Karmada 控制面或成员集群上的资源执行更多操作。 + +### 更丰富的功能 + +Karmadactl 引入了 `--operation-scope` 参数来控制命令的操作范围。有了这个新参数，`get`、`describe`、`exec` 和 `explain` 等命令可以灵活切换集群视角对 Karmada 控制面或成员集群的资源进行操作。 + +### 更详细的命令输出信息 + +`karmadactl get cluster` 命令的输出现在增加了 cluster 对象的 `Zones`、`Region`、`Provider`、`API-Endpoint` 和 `Proxy-URL` 信息。 + +通过这些能力增强，karmadactl 的操作和运维体验得到了提升。karmadactl 的新功能和更多详细信息可以通过使用 `karmadactl --help` 获得。 + +## 联邦工作负载标准化 generation 语义 + +在本版本中，Karmada 将联邦层面的工作负载 generation 语义进行了标准化。这一更新为发布系统提供了可靠的参考，增强了跨集群部署的精确度。通过标准化 generation 语义，Karmada 简化了发布流程，并确保一致性地跟踪工作负载状态，使得跨多个集群管理和监控应用程序变得更加容易。 + +标准化细节为，当且仅当工作负载分发至所有成员集群中的资源状态满足 `status.observedGeneration` >= `metadata.generation` 时，联邦层面的工作负载状态中的 observedGeneration 值才会被设置为其本身 `.metadata.generation` 值，这确保了每个成员集群中相应的控制器均已完成了对该工作负载的处理。此举将联邦层面的 generation 语义同kubernetes 集群的 generation 语义进行了统一，使用户能够更便捷的将单集群业务迁移至多集群业务。 + +本版本已完成下列资源适配： + +- GroupVersion: apps/v1 Kind: Deployment, DaemonSet, StatefulSet +- GroupVersion: apps.kruise.io/v1alpha1 Kind: CloneSet, DaemonSet +- GroupVersion: apps.kruise.io/v1beta1 Kind: StatefulSet +- GroupVersion: helm.toolkit.fluxcd.io/v2beta1 Kind: HelmRelease +- GroupVersion: kustomize.toolkit.fluxcd.io/v1 Kind: Kustomization +- GroupVersion: source.toolkit.fluxcd.io/v1 Kind: GitRepository +- GroupVersion: source.toolkit.fluxcd.io/v1beta2 Kind: Bucket, HelmChart, HelmRepository, OCIRepository + +如有您有更多资源（包括CRD）需要适配，可以向 Karmada 社区进行反馈，也可以使用 Resource Interpreter进行扩展。 + +## Karmada Operator 支持自定义 CRD 下载策略 + +CRD（Custom Resource Definition，自定义资源定义）资源是 Karmada Operator 用于配置新的 Karmada 实例的关键前提资源。这些 CRD 资源包含了 Karmada 系统的关键 API 定义，例如，PropagationPolicy，ResourceBinding，Work 等。 + +在 v.1.11 版本中，Karmada Operator 支持用户自定义 CRD 下载策略。利用这个功能，用户可以指定 CRD 资源的下载路径，并定义更多的下载策略，为用户提供了更灵活的离线部署方式。 + +有关该特性的详细描述，可以参考[提案：Custom CRD Download Strategy Support for Karmada Operator](https://github.com/karmada-io/karmada/tree/master/docs/proposals/operator-custom-crd-download-strategy)。 + +# 致谢贡献者 + +Karmada v1.11 版本包含了来自 36 位贡献者的 223 次代码提交，在此对各位贡献者表示由衷的感谢： + +![karmada v1.11 contributors](./img/contributors.png)