diff --git a/docs/faq/deprecated-features.md b/docs/faq/deprecated-features.md index a29ded629f2..4c1836c30ae 100644 --- a/docs/faq/deprecated-features.md +++ b/docs/faq/deprecated-features.md @@ -16,6 +16,7 @@ Rancher will publish deprecated features as part of the [release notes](https:// | Patch Version | Release Date | |---------------|---------------| +| [2.13.1](https://github.com/rancher/rancher/releases/tag/v2.13.1) | December 18, 2025 | | [2.13.0](https://github.com/rancher/rancher/releases/tag/v2.13.0) | November 25, 2025 | ## What can I expect when a feature is marked for deprecation? diff --git a/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md b/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md index a04809166e9..90b23876201 100644 --- a/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md +++ b/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md @@ -50,6 +50,38 @@ The following CLI tools are required for setting up the Kubernetes cluster. Plea ## Install the Rancher Helm Chart +:::important + +**Important:** In Rancher Community v2.13.1 if your registry configuration is one of the following you may see Rancher generate the `cattle-cluster-agent` image with an incorrect `docker.io` path segment: + +- Environments where a **cluster-scoped container registry** is configured for system images. +- Environments where a **global `system-default-registry`** is configured (e.g. airgap setups), even if no cluster-scoped registry is set. + +**Workaround for Affected Setups:** As a workaround, override the `cattle-cluster-agent` image via the `CATTLE_AGENT_IMAGE` environment variable. This value must **not** contain any registry prefix (Rancher will handle that automatically). It should be set only to the repository and tag, for example:`rancher/rancher-agent:v2.13.1` + +**Helm `install` example:** + +```bash +helm install rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Helm `upgrade` example:** + +```bash +helm upgrade rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Important Upgrade Note:** + +The `CATTLE_AGENT_IMAGE` override is intended only as a temporary workaround for the affected configurations. Once a Rancher version is available that corrects this behavior, the `CATTLE_AGENT_IMAGE` override should be **removed** from Helm values, so that Rancher can resume managing the agent image normally and automatically track future image and tag changes. See [#53187](https://github.com/rancher/rancher/issues/53187#issuecomment-3676484603) for further information. +::: + Rancher is installed using the [Helm](https://helm.sh/) package manager for Kubernetes. Helm charts provide templating syntax for Kubernetes YAML manifest documents. With Helm, we can create configurable deployments instead of just using static files. For systems without direct internet access, see [Air Gap: Kubernetes install](../other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha.md). diff --git a/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md b/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md index 1c2ce244893..d4b8be7d061 100644 --- a/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md +++ b/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md @@ -28,6 +28,38 @@ Note that upgrades _to_ or _from_ any chart in the [rancher-alpha repository](.. ### Helm Version +:::important + +**Important:** In Rancher Community v2.13.1 if your registry configuration is one of the following you may see Rancher generate the `cattle-cluster-agent` image with an incorrect `docker.io` path segment: + +- Environments where a **cluster-scoped container registry** is configured for system images. +- Environments where a **global `system-default-registry`** is configured (e.g. airgap setups), even if no cluster-scoped registry is set. + +**Workaround for Affected Setups:** As a workaround, override the `cattle-cluster-agent` image via the `CATTLE_AGENT_IMAGE` environment variable. This value must **not** contain any registry prefix (Rancher will handle that automatically). It should be set only to the repository and tag, for example:`rancher/rancher-agent:v2.13.1` + +**Helm `install` example:** + +```bash +helm install rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Helm `upgrade` example:** + +```bash +helm upgrade rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Important Upgrade Note:** + +The `CATTLE_AGENT_IMAGE` override is intended only as a temporary workaround for the affected configurations. Once a Rancher version is available that corrects this behavior, the `CATTLE_AGENT_IMAGE` override should be **removed** from Helm values, so that Rancher can resume managing the agent image normally and automatically track future image and tag changes. See [#53187](https://github.com/rancher/rancher/issues/53187#issuecomment-3676484603) for further information. +::: + The upgrade instructions assume you are using Helm 3. diff --git a/docs/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md b/docs/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md index c4b6177e1b3..73827ab809a 100644 --- a/docs/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md +++ b/docs/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md @@ -15,10 +15,8 @@ The etcd data set is automatically cleaned up on a five-minute interval by Kuber ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - quota-backend-bytes: 5368709120 +etcd-arg: + - "quota-backend-bytes=5368709120" ``` ## Scaling etcd Disk Performance @@ -32,12 +30,7 @@ To implement this solution in an RKE2/K3s cluster, the `/var/lib/etcd/data` and ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - data-dir: '/var/lib/rancher/etcd/data/' - wal-dir: '/var/lib/rancher/etcd/wal/wal_dir' - extra_binds: - - '/var/lib/etcd/data:/var/lib/rancher/etcd/data' - - '/var/lib/etcd/wal:/var/lib/rancher/etcd/wal' +etcd-arg: + - "data-dir=/var/lib/etcd/data" + - "wal-dir=/var/lib/etcd/wal" ``` diff --git a/docs/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md b/docs/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md index 27ab8e1b60d..15c63dde632 100644 --- a/docs/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md +++ b/docs/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md @@ -19,6 +19,7 @@ In order to deploy and run the adapter successfully, you need to ensure its vers | Rancher Version | Adapter Version | |-----------------|------------------| +| v2.13.1 | 108.0.0+up8.0.0 | | v2.13.0 | 108.0.0+up8.0.0 | ### 1. Gain Access to the Local Cluster diff --git a/docs/reference-guides/rancher-webhook.md b/docs/reference-guides/rancher-webhook.md index c318999bae0..f5f8fcc012c 100644 --- a/docs/reference-guides/rancher-webhook.md +++ b/docs/reference-guides/rancher-webhook.md @@ -20,6 +20,7 @@ Each Rancher version is designed to be compatible with a single version of the w | Rancher Version | Webhook Version | Availability in Prime | Availability in Community | |-----------------|-----------------|-----------------------|---------------------------| +| v2.13.1 | v0.9.1 | ✓ | ✓ | | v2.13.0 | v0.9.0 | ✗ | ✓ | ## Why Do We Need It? diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md b/i18n/zh/docusaurus-plugin-content-docs/current/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md index 5402c2a14cd..3866f39db8e 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md @@ -11,10 +11,8 @@ Kubernetes 每隔五分钟会自动清理 etcd 数据集。在某些情况下（ ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - quota-backend-bytes: 5368709120 +etcd-arg: + - "quota-backend-bytes=5368709120" ``` ## 扩展 etcd 磁盘性能 @@ -28,12 +26,7 @@ services: ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - data-dir: '/var/lib/rancher/etcd/data/' - wal-dir: '/var/lib/rancher/etcd/wal/wal_dir' - extra_binds: - - '/var/lib/etcd/data:/var/lib/rancher/etcd/data' - - '/var/lib/etcd/wal:/var/lib/rancher/etcd/wal' +etcd-arg: + - "data-dir=/var/lib/etcd/data" + - "wal-dir=/var/lib/etcd/wal" ``` diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.11/faq/deprecated-features.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.11/faq/deprecated-features.md index f8e683f6f64..64944b195d3 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.11/faq/deprecated-features.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.11/faq/deprecated-features.md @@ -16,6 +16,7 @@ Rancher 将在 GitHub 上发布的 Rancher 的[发版说明](https://github.com/ | Patch 版本 | 发布时间 | | --------------------------------------------------------------- | ------------------ | +| [2.11.9](https://github.com/rancher/rancher/releases/tag/v2.11.9) | 2025 年 12 月 18 日 | | [2.11.8](https://github.com/rancher/rancher/releases/tag/v2.11.8) | 2025 年 11 月 24 日 | | [2.11.7](https://github.com/rancher/rancher/releases/tag/v2.11.7) | 2025 年 10 月 23 日 | | [2.11.6](https://github.com/rancher/rancher/releases/tag/v2.11.6) | 2025 年 9 月 25 日 | diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md index 2eb9e884d0d..ac4e782301f 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md @@ -15,6 +15,7 @@ title: 安装 Adapter | Rancher 版本 | Adapter 版本 | |-----------------|:----------------:| +| v2.11.9 | v106.0.0+up6.0.0 | | v2.11.8 | v106.0.0+up6.0.0 | | v2.11.7 | v106.0.0+up6.0.0 | | v2.11.6 | v106.0.0+up6.0.0 | diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.11/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.11/reference-guides/rancher-webhook.md index 346b640dac8..cb360345c42 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.11/reference-guides/rancher-webhook.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.11/reference-guides/rancher-webhook.md @@ -20,6 +20,7 @@ Rancher 将 Rancher-Webhook 作为单独的 deployment 和服务部署在 local | Rancher Version | Webhook Version | Availability in Prime | Availability in Community | |-----------------|-----------------|-----------------------|---------------------------| +| v2.11.9 | v0.7.8 | ✓ | ✗ | | v2.11.8 | v0.7.8 | ✓ | ✗ | | v2.11.7 | v0.7.7 | ✓ | ✗ | | v2.11.6 | v0.7.6 | ✓ | ✗ | diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/faq/deprecated-features.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/faq/deprecated-features.md index d6402c0b2d8..c88bfe65551 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/faq/deprecated-features.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/faq/deprecated-features.md @@ -16,7 +16,8 @@ Rancher 将在 GitHub 上发布的 Rancher 的[发版说明](https://github.com/ | Patch 版本 | 发布时间 | | ----------------------------------------------------------------- | ------------------ | -| [2.12.4](https://github.com/rancher/rancher/releases/tag/v2.12.3) | 2025 年 11 月 24 日 | +| [2.12.5](https://github.com/rancher/rancher/releases/tag/v2.12.5) | 2025 年 12 月 18 日 | +| [2.12.4](https://github.com/rancher/rancher/releases/tag/v2.12.4) | 2025 年 11 月 24 日 | | [2.12.3](https://github.com/rancher/rancher/releases/tag/v2.12.3) | 2025 年 10 月 23 日 | | [2.12.2](https://github.com/rancher/rancher/releases/tag/v2.12.2) | 2025 年 9 月 25 日 | | [2.12.1](https://github.com/rancher/rancher/releases/tag/v2.12.1) | 2025 年 8 月 28 日 | diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md index 5402c2a14cd..3866f39db8e 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md @@ -11,10 +11,8 @@ Kubernetes 每隔五分钟会自动清理 etcd 数据集。在某些情况下（ ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - quota-backend-bytes: 5368709120 +etcd-arg: + - "quota-backend-bytes=5368709120" ``` ## 扩展 etcd 磁盘性能 @@ -28,12 +26,7 @@ services: ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - data-dir: '/var/lib/rancher/etcd/data/' - wal-dir: '/var/lib/rancher/etcd/wal/wal_dir' - extra_binds: - - '/var/lib/etcd/data:/var/lib/rancher/etcd/data' - - '/var/lib/etcd/wal:/var/lib/rancher/etcd/wal' +etcd-arg: + - "data-dir=/var/lib/etcd/data" + - "wal-dir=/var/lib/etcd/wal" ``` diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md index 3fe6f014b14..6a8e402aceb 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md @@ -15,6 +15,7 @@ title: 安装 Adapter | Rancher 版本 | Adapter 版本 | |-----------------|:----------------:| +| v2.12.5 | 107.0.0+up7.0.0 | | v2.12.4 | 107.0.0+up7.0.0 | | v2.12.3 | 107.0.0+up7.0.0 | | v2.12.2 | 107.0.0+up7.0.0 | diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/reference-guides/rancher-webhook.md index 78f661a5480..87b86cde4de 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.12/reference-guides/rancher-webhook.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.12/reference-guides/rancher-webhook.md @@ -20,7 +20,8 @@ Rancher 将 Rancher-Webhook 作为单独的 deployment 和服务部署在 local | Rancher Version | Webhook Version | Availability in Prime | Availability in Community | |-----------------|-----------------|-----------------------|---------------------------| -| v2.12.4 | v0.8.4 | ✓ | ✗ | +| v2.12.5 | v0.8.4 | ✓ | ✗ | +| v2.12.4 | v0.8.4 | ✓ | ✗ | | v2.12.3 | v0.8.3 | ✓ | ✓ | | v2.12.2 | v0.8.2 | ✓ | ✓ | | v2.12.1 | v0.8.1 | ✓ | ✓ | diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/faq/deprecated-features.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/faq/deprecated-features.md index 6bf9555cfa8..8b139249361 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/faq/deprecated-features.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/faq/deprecated-features.md @@ -16,7 +16,8 @@ Rancher 将在 GitHub 上发布的 Rancher 的[发版说明](https://github.com/ | Patch 版本 | 发布时间 | | ----------------------------------------------------------------- | ------------------ | -| [2.13.0](https://github.com/rancher/rancher/releases/tag/v2.13.0) | 2025 年 11 月 25 日 | +| [2.13.1](https://github.com/rancher/rancher/releases/tag/v2.13.1) | 2025 年 12 月 18 日 | +| [2.13.0](https://github.com/rancher/rancher/releases/tag/v2.13.0) | 2025 年 11 月 25 日 | ## 当一个功能被标记为弃用我可以得到什么样的预期？ diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md index 5402c2a14cd..7ca1b25184e 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md @@ -11,10 +11,8 @@ Kubernetes 每隔五分钟会自动清理 etcd 数据集。在某些情况下（ ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - quota-backend-bytes: 5368709120 +etcd-arg: + - "quota-backend-bytes=5368709120" ``` ## 扩展 etcd 磁盘性能 @@ -28,12 +26,7 @@ services: ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - data-dir: '/var/lib/rancher/etcd/data/' - wal-dir: '/var/lib/rancher/etcd/wal/wal_dir' - extra_binds: - - '/var/lib/etcd/data:/var/lib/rancher/etcd/data' - - '/var/lib/etcd/wal:/var/lib/rancher/etcd/wal' +etcd-args: + - "data-dir=/var/lib/etcd/data" + - "wal-dir=/var/lib/etcd/wal" ``` diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md index 6c1e7ac6b9e..59b2bad8492 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md @@ -15,6 +15,7 @@ title: 安装 Adapter | Rancher 版本 | Adapter 版本 | |-----------------|------------------| +| v2.13.1 | 108.0.0+up8.0.0 | | v2.13.0 | 108.0.0+up8.0.0 | ## 1. 获取对 Local 集群的访问权限 diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/reference-guides/rancher-webhook.md index 555bc2d9f73..e100cb6d1fc 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/version-2.13/reference-guides/rancher-webhook.md +++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.13/reference-guides/rancher-webhook.md @@ -20,6 +20,7 @@ Rancher 将 Rancher-Webhook 作为单独的 deployment 和服务部署在 local | Rancher Version | Webhook Version | Availability in Prime | Availability in Community | |-----------------|-----------------|-----------------------|---------------------------| +| v2.13.1 | v0.9.1 | ✓ | ✓ | | v2.13.0 | v0.9.0 | ✗ | ✓ | ## 为什么我们需要它？ diff --git a/shared-files/_cni-popularity.md b/shared-files/_cni-popularity.md index 2e22a703585..a4b5fce5dc4 100644 --- a/shared-files/_cni-popularity.md +++ b/shared-files/_cni-popularity.md @@ -1,10 +1,10 @@ -The following table summarizes different GitHub metrics to give you an idea of each project's popularity and activity levels. This data was collected in September 2025. +The following table summarizes different GitHub metrics to give you an idea of each project's popularity and activity levels. This data was collected in December 2025. | Provider | Project | Stars | Forks | Contributors | | ---- | ---- | ---- | ---- | ---- | -| Canal | https://github.com/projectcalico/canal | 721 | 98 | 20 | +| Canal | https://github.com/projectcalico/canal | 721 | 97 | 18 | | Flannel | https://github.com/flannel-io/flannel | 9.3k | 2.9k | 244 | -| Calico | https://github.com/projectcalico/calico | 6.9k | 1.5k | 392 | -| Weave | https://github.com/weaveworks/weave | 6.6k | 680 | 84 | -| Cilium | https://github.com/cilium/cilium | 22.9k | 3.4k | 1,012 | +| Calico | https://github.com/projectcalico/calico | 6.9k | 1.5k | 396 | +| Weave | https://github.com/weaveworks/weave | 6.6k | 680 | 83 | +| Cilium | https://github.com/cilium/cilium | 23k | 3.5k | 1k | diff --git a/src/pages/versions.md b/src/pages/versions.md index 188a70818c3..56544225e75 100644 --- a/src/pages/versions.md +++ b/src/pages/versions.md @@ -17,12 +17,12 @@ Here you can find links to supporting documentation for the current released ver Community - v2.13.0 + v2.13.1 Documentation - Release Notes -
N/A
+ Release Notes
N/A
✓
+
✓
@@ -38,9 +38,9 @@ Here you can find links to supporting documentation for the current released ver Community - v2.12.4 + v2.12.5 Documentation - Release Notes + Release Notes
N/A
✓
N/A
@@ -59,9 +59,9 @@ Here you can find links to supporting documentation for the current released ver Community - v2.11.8 + v2.11.9 Documentation - Release Notes + Release Notes
N/A
✓
NA
@@ -112,6 +112,27 @@ Here you can find links to supporting documentation for the current released ver ### Past Versions +Here you can find links to supporting documentation for previous versions of Rancher v2.13, and their availability for [Rancher Prime](/v2.13/getting-started/quick-start-guides/deploy-rancher-manager/prime) and the Community version of Rancher: + + + + + + + + + + + + + + + + + + +
VersionDocumentationRelease NotesSupport MatrixPrimeCommunity
v2.13.0DocumentationRelease Notes
N/A
N/A
✓
+ Here you can find links to supporting documentation for previous versions of Rancher v2.12, and their availability for [Rancher Prime](/v2.12/getting-started/quick-start-guides/deploy-rancher-manager/prime) and the Community version of Rancher: @@ -123,6 +144,14 @@ Here you can find links to supporting documentation for previous versions of Ran + + + + + + + + @@ -168,6 +197,14 @@ Here you can find links to supporting documentation for previous versions of Ran + + + + + + + + diff --git a/versioned_docs/version-2.11/faq/deprecated-features.md b/versioned_docs/version-2.11/faq/deprecated-features.md index 52f8eeec38a..d890549625a 100644 --- a/versioned_docs/version-2.11/faq/deprecated-features.md +++ b/versioned_docs/version-2.11/faq/deprecated-features.md @@ -16,6 +16,7 @@ Rancher will publish deprecated features as part of the [release notes](https:// | Patch Version | Release Date | |---------------|---------------| +| [2.11.9](https://github.com/rancher/rancher/releases/tag/v2.11.9) | December 18, 2025 | | [2.11.8](https://github.com/rancher/rancher/releases/tag/v2.11.8) | November 24, 2025 | | [2.11.7](https://github.com/rancher/rancher/releases/tag/v2.11.7) | October 23, 2025 | | [2.11.6](https://github.com/rancher/rancher/releases/tag/v2.11.6) | September 25, 2025 | diff --git a/versioned_docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md b/versioned_docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md index 278ded001f1..fade78bb04a 100644 --- a/versioned_docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md +++ b/versioned_docs/version-2.11/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md @@ -19,6 +19,7 @@ In order to deploy and run the adapter successfully, you need to ensure its vers | Rancher Version | Adapter Version | |-----------------|------------------| +| v2.11.9 | v106.0.0+up6.0.0 | | v2.11.8 | v106.0.0+up6.0.0 | | v2.11.7 | v106.0.0+up6.0.0 | | v2.11.6 | v106.0.0+up6.0.0 | diff --git a/versioned_docs/version-2.11/reference-guides/rancher-webhook.md b/versioned_docs/version-2.11/reference-guides/rancher-webhook.md index 1a455c8c41d..f630a6ec2be 100644 --- a/versioned_docs/version-2.11/reference-guides/rancher-webhook.md +++ b/versioned_docs/version-2.11/reference-guides/rancher-webhook.md @@ -20,6 +20,7 @@ Each Rancher version is designed to be compatible with a single version of the w | Rancher Version | Webhook Version | Availability in Prime | Availability in Community | |-----------------|-----------------|-----------------------|---------------------------| +| v2.11.9 | v0.7.8 | ✓ | ✗ | | v2.11.8 | v0.7.8 | ✓ | ✗ | | v2.11.7 | v0.7.7 | ✓ | ✗ | | v2.11.6 | v0.7.6 | ✓ | ✗ | diff --git a/versioned_docs/version-2.12/faq/deprecated-features.md b/versioned_docs/version-2.12/faq/deprecated-features.md index b5f7531d34a..a3080ae3db8 100644 --- a/versioned_docs/version-2.12/faq/deprecated-features.md +++ b/versioned_docs/version-2.12/faq/deprecated-features.md @@ -16,6 +16,7 @@ Rancher will publish deprecated features as part of the [release notes](https:// | Patch Version | Release Date | |---------------|---------------| +| [2.12.5](https://github.com/rancher/rancher/releases/tag/v2.12.5) | December 18, 2025 | | [2.12.4](https://github.com/rancher/rancher/releases/tag/v2.12.4) | November 24, 2025 | | [2.12.3](https://github.com/rancher/rancher/releases/tag/v2.12.3) | October 23, 2025 | | [2.12.2](https://github.com/rancher/rancher/releases/tag/v2.12.2) | September 25, 2025 | diff --git a/versioned_docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md b/versioned_docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md index c4b6177e1b3..73827ab809a 100644 --- a/versioned_docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md +++ b/versioned_docs/version-2.12/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md @@ -15,10 +15,8 @@ The etcd data set is automatically cleaned up on a five-minute interval by Kuber ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - quota-backend-bytes: 5368709120 +etcd-arg: + - "quota-backend-bytes=5368709120" ``` ## Scaling etcd Disk Performance @@ -32,12 +30,7 @@ To implement this solution in an RKE2/K3s cluster, the `/var/lib/etcd/data` and ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - data-dir: '/var/lib/rancher/etcd/data/' - wal-dir: '/var/lib/rancher/etcd/wal/wal_dir' - extra_binds: - - '/var/lib/etcd/data:/var/lib/rancher/etcd/data' - - '/var/lib/etcd/wal:/var/lib/rancher/etcd/wal' +etcd-arg: + - "data-dir=/var/lib/etcd/data" + - "wal-dir=/var/lib/etcd/wal" ``` diff --git a/versioned_docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md b/versioned_docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md index 020de4c4535..040289b530a 100644 --- a/versioned_docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md +++ b/versioned_docs/version-2.12/integrations-in-rancher/cloud-marketplace/aws-cloud-marketplace/install-adapter.md @@ -19,6 +19,7 @@ In order to deploy and run the adapter successfully, you need to ensure its vers | Rancher Version | Adapter Version | |-----------------|------------------| +| v2.12.5 | 107.0.0+up7.0.0 | | v2.12.4 | 107.0.0+up7.0.0 | | v2.12.3 | 107.0.0+up7.0.0 | | v2.12.2 | 107.0.0+up7.0.0 | diff --git a/versioned_docs/version-2.12/reference-guides/rancher-webhook.md b/versioned_docs/version-2.12/reference-guides/rancher-webhook.md index 4226fc67549..a6f83580dd3 100644 --- a/versioned_docs/version-2.12/reference-guides/rancher-webhook.md +++ b/versioned_docs/version-2.12/reference-guides/rancher-webhook.md @@ -20,7 +20,8 @@ Each Rancher version is designed to be compatible with a single version of the w | Rancher Version | Webhook Version | Availability in Prime | Availability in Community | |-----------------|-----------------|-----------------------|---------------------------| -| v2.12.4 | v0.8.4 | ✓ | ✗ | +| v2.12.5 | v0.8.4 | ✓ | ✗ | +| v2.12.4 | v0.8.4 | ✓ | ✗ | | v2.12.3 | v0.8.3 | ✓ | ✓ | | v2.12.2 | v0.8.2 | ✓ | ✓ | | v2.12.1 | v0.8.1 | ✓ | ✓ | diff --git a/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md b/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md index a04809166e9..90b23876201 100644 --- a/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md +++ b/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/install-upgrade-on-a-kubernetes-cluster.md @@ -50,6 +50,38 @@ The following CLI tools are required for setting up the Kubernetes cluster. Plea ## Install the Rancher Helm Chart +:::important + +**Important:** In Rancher Community v2.13.1 if your registry configuration is one of the following you may see Rancher generate the `cattle-cluster-agent` image with an incorrect `docker.io` path segment: + +- Environments where a **cluster-scoped container registry** is configured for system images. +- Environments where a **global `system-default-registry`** is configured (e.g. airgap setups), even if no cluster-scoped registry is set. + +**Workaround for Affected Setups:** As a workaround, override the `cattle-cluster-agent` image via the `CATTLE_AGENT_IMAGE` environment variable. This value must **not** contain any registry prefix (Rancher will handle that automatically). It should be set only to the repository and tag, for example:`rancher/rancher-agent:v2.13.1` + +**Helm `install` example:** + +```bash +helm install rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Helm `upgrade` example:** + +```bash +helm upgrade rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Important Upgrade Note:** + +The `CATTLE_AGENT_IMAGE` override is intended only as a temporary workaround for the affected configurations. Once a Rancher version is available that corrects this behavior, the `CATTLE_AGENT_IMAGE` override should be **removed** from Helm values, so that Rancher can resume managing the agent image normally and automatically track future image and tag changes. See [#53187](https://github.com/rancher/rancher/issues/53187#issuecomment-3676484603) for further information. +::: + Rancher is installed using the [Helm](https://helm.sh/) package manager for Kubernetes. Helm charts provide templating syntax for Kubernetes YAML manifest documents. With Helm, we can create configurable deployments instead of just using static files. For systems without direct internet access, see [Air Gap: Kubernetes install](../other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha.md). diff --git a/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md b/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md index 1c2ce244893..d4b8be7d061 100644 --- a/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md +++ b/versioned_docs/version-2.13/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades.md @@ -28,6 +28,38 @@ Note that upgrades _to_ or _from_ any chart in the [rancher-alpha repository](.. ### Helm Version +:::important + +**Important:** In Rancher Community v2.13.1 if your registry configuration is one of the following you may see Rancher generate the `cattle-cluster-agent` image with an incorrect `docker.io` path segment: + +- Environments where a **cluster-scoped container registry** is configured for system images. +- Environments where a **global `system-default-registry`** is configured (e.g. airgap setups), even if no cluster-scoped registry is set. + +**Workaround for Affected Setups:** As a workaround, override the `cattle-cluster-agent` image via the `CATTLE_AGENT_IMAGE` environment variable. This value must **not** contain any registry prefix (Rancher will handle that automatically). It should be set only to the repository and tag, for example:`rancher/rancher-agent:v2.13.1` + +**Helm `install` example:** + +```bash +helm install rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Helm `upgrade` example:** + +```bash +helm upgrade rancher rancher-latest/rancher \ +... + --set extraEnv[0].name=CATTLE_AGENT_IMAGE \ + --set extraEnv[0].value=rancher/rancher-agent:v2.13.1 +``` + +**Important Upgrade Note:** + +The `CATTLE_AGENT_IMAGE` override is intended only as a temporary workaround for the affected configurations. Once a Rancher version is available that corrects this behavior, the `CATTLE_AGENT_IMAGE` override should be **removed** from Helm values, so that Rancher can resume managing the agent image normally and automatically track future image and tag changes. See [#53187](https://github.com/rancher/rancher/issues/53187#issuecomment-3676484603) for further information. +::: + The upgrade instructions assume you are using Helm 3. diff --git a/versioned_docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md b/versioned_docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md index c4b6177e1b3..73827ab809a 100644 --- a/versioned_docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md +++ b/versioned_docs/version-2.13/how-to-guides/advanced-user-guides/tune-etcd-for-large-installs.md @@ -15,10 +15,8 @@ The etcd data set is automatically cleaned up on a five-minute interval by Kuber ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - quota-backend-bytes: 5368709120 +etcd-arg: + - "quota-backend-bytes=5368709120" ``` ## Scaling etcd Disk Performance @@ -32,12 +30,7 @@ To implement this solution in an RKE2/K3s cluster, the `/var/lib/etcd/data` and ```yaml # RKE2/K3s config.yaml --- -services: - etcd: - extra_args: - data-dir: '/var/lib/rancher/etcd/data/' - wal-dir: '/var/lib/rancher/etcd/wal/wal_dir' - extra_binds: - - '/var/lib/etcd/data:/var/lib/rancher/etcd/data' - - '/var/lib/etcd/wal:/var/lib/rancher/etcd/wal' +etcd-arg: + - "data-dir=/var/lib/etcd/data" + - "wal-dir=/var/lib/etcd/wal" ```
Prime Community
v2.12.4DocumentationRelease Notes
Support Matrix
✓
N/A
v2.12.3 DocumentationPrime Community
v2.11.8DocumentationRelease Notes
Support Matrix
✓
NA
v2.11.7 Documentation