diff --git a/docs/api/workflows/projects.md b/docs/api/workflows/projects.md
index 853dd7f164b..a3678d8addc 100644
--- a/docs/api/workflows/projects.md
+++ b/docs/api/workflows/projects.md
@@ -25,11 +25,15 @@ spec:
EOF
```
-Use `metadata.generateName` to ensure a unique project ID, but note that `kubectl apply` does not work with `metadata.generateName`, so `kubectl create` must be used instead.
+When creating a new project, you have two primary options for setting the name:
+
+- **Automatic Generation:** Use `metadata.generateName` to ensure a unique project ID. However, note that you must use `kubectl create` (instead of `kubectl apply`) with this option, as `kubectl apply` does not support it.
+- **Manual Naming:** You can explicitly set the project ID using `metadata.name`. If a project with that exact name already exists, the name request is denied.
+The display name seen in the UI is set by `spec.displayName`. If `spec.displayName` is not provided, the field `metadata.name` is used instead.
Set `metadata.namespace` and `spec.clusterName` to the ID for the cluster the project belongs to.
-If you create a project through a cluster member account, you must include the annotation, `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
+If you create a project through a cluster member account and want that account to be able to access the project, you must include the annotation `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
```bash
kubectl create -f - <
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/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md b/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md
index 1e17aa6cd48..57233c17fb1 100644
--- a/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md
+++ b/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md
@@ -13,7 +13,7 @@ A project is a group of namespaces, and it is a concept introduced by Rancher. P
:::note
-Projects are de-emphasized on the UI because it is not required to create Kubernetes resources within a project scope. However, resources such as [Secrets](../../new-user-guides/kubernetes-resources-setup/secrets.md#creating-secrets-in-projects) can still be created in a project scope if the legacy feature flag is enabled.
+Projects are de-emphasized on the UI because it is not required to create Kubernetes resources within a project scope. However, resources such as [Secrets](../../new-user-guides/kubernetes-resources-setup/secrets.md#creating-secrets-in-projects) can still be created in a project scope.
:::
@@ -196,3 +196,7 @@ To add a resource quota,
1. Select **Delete**.
When you delete a project, any namespaces that were formerly associated with the project will remain on the cluster. You can find these namespaces in the Rancher UI, in the **Not in a Project** tab of the **Projects/Namespaces** page. You can reassign these namespaces to a project by [moving](../manage-namespaces.md#moving-namespaces-to-another-project) them.
+
+## Further Reading
+
+You can create projects and project members more programmatically via the [Public API](../../../api/quickstart.md). See the [project workflow doc](../../../api/workflows/projects.md) for more information.
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:
+
+
+
+ | Version |
+ Documentation |
+ Release Notes |
+ Support Matrix |
+ Prime |
+ Community |
+
+
+ | v2.13.0 |
+ Documentation |
+ Release 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
| Prime |
Community |
+
+ | v2.12.4 |
+ Documentation |
+ Release Notes |
+ Support Matrix |
+ ✓ |
+ N/A |
+
| v2.12.3 |
Documentation |
@@ -168,6 +197,14 @@ Here you can find links to supporting documentation for previous versions of Ran
Prime |
Community |
+
+ | v2.11.8 |
+ Documentation |
+ Release Notes |
+ Support Matrix |
+ ✓ |
+ NA |
+
| v2.11.7 |
Documentation |
diff --git a/versioned_docs/version-2.10/api/workflows/projects.md b/versioned_docs/version-2.10/api/workflows/projects.md
index 853dd7f164b..a3678d8addc 100644
--- a/versioned_docs/version-2.10/api/workflows/projects.md
+++ b/versioned_docs/version-2.10/api/workflows/projects.md
@@ -25,11 +25,15 @@ spec:
EOF
```
-Use `metadata.generateName` to ensure a unique project ID, but note that `kubectl apply` does not work with `metadata.generateName`, so `kubectl create` must be used instead.
+When creating a new project, you have two primary options for setting the name:
+
+- **Automatic Generation:** Use `metadata.generateName` to ensure a unique project ID. However, note that you must use `kubectl create` (instead of `kubectl apply`) with this option, as `kubectl apply` does not support it.
+- **Manual Naming:** You can explicitly set the project ID using `metadata.name`. If a project with that exact name already exists, the name request is denied.
+The display name seen in the UI is set by `spec.displayName`. If `spec.displayName` is not provided, the field `metadata.name` is used instead.
Set `metadata.namespace` and `spec.clusterName` to the ID for the cluster the project belongs to.
-If you create a project through a cluster member account, you must include the annotation, `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
+If you create a project through a cluster member account and want that account to be able to access the project, you must include the annotation `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
```bash
kubectl create -f - <
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"
```
diff --git a/versioned_docs/version-2.13/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md b/versioned_docs/version-2.13/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md
index 1e17aa6cd48..57233c17fb1 100644
--- a/versioned_docs/version-2.13/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md
+++ b/versioned_docs/version-2.13/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md
@@ -13,7 +13,7 @@ A project is a group of namespaces, and it is a concept introduced by Rancher. P
:::note
-Projects are de-emphasized on the UI because it is not required to create Kubernetes resources within a project scope. However, resources such as [Secrets](../../new-user-guides/kubernetes-resources-setup/secrets.md#creating-secrets-in-projects) can still be created in a project scope if the legacy feature flag is enabled.
+Projects are de-emphasized on the UI because it is not required to create Kubernetes resources within a project scope. However, resources such as [Secrets](../../new-user-guides/kubernetes-resources-setup/secrets.md#creating-secrets-in-projects) can still be created in a project scope.
:::
@@ -196,3 +196,7 @@ To add a resource quota,
1. Select **Delete**.
When you delete a project, any namespaces that were formerly associated with the project will remain on the cluster. You can find these namespaces in the Rancher UI, in the **Not in a Project** tab of the **Projects/Namespaces** page. You can reassign these namespaces to a project by [moving](../manage-namespaces.md#moving-namespaces-to-another-project) them.
+
+## Further Reading
+
+You can create projects and project members more programmatically via the [Public API](../../../api/quickstart.md). See the [project workflow doc](../../../api/workflows/projects.md) for more information.
diff --git a/versioned_docs/version-2.9/api/workflows/projects.md b/versioned_docs/version-2.9/api/workflows/projects.md
index b3ee46374df..a3678d8addc 100644
--- a/versioned_docs/version-2.9/api/workflows/projects.md
+++ b/versioned_docs/version-2.9/api/workflows/projects.md
@@ -25,11 +25,15 @@ spec:
EOF
```
-Use `metadata.generateName` to ensure a unique project ID, but note that `kubectl apply` does not work with `metadata.generateName`, so `kubectl create` must be used instead.
+When creating a new project, you have two primary options for setting the name:
+
+- **Automatic Generation:** Use `metadata.generateName` to ensure a unique project ID. However, note that you must use `kubectl create` (instead of `kubectl apply`) with this option, as `kubectl apply` does not support it.
+- **Manual Naming:** You can explicitly set the project ID using `metadata.name`. If a project with that exact name already exists, the name request is denied.
+The display name seen in the UI is set by `spec.displayName`. If `spec.displayName` is not provided, the field `metadata.name` is used instead.
Set `metadata.namespace` and `spec.clusterName` to the ID for the cluster the project belongs to.
-If you create a project through a cluster member account, you must include the annotation, `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
+If you create a project through a cluster member account and want that account to be able to access the project, you must include the annotation `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
```bash
kubectl create -f - <