diff --git a/.gitignore b/.gitignore
index d64d0f4b1f5..7a424bbdf3b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -20,3 +20,6 @@ yarn-debug.log*
yarn-error.log*
.idea/
+
+/dev-resources/algolia-search/.env
+/dev-resources/algolia-search/algolia-index.sh
\ No newline at end of file
diff --git a/dev-resources/algolia-search/config.json b/dev-resources/algolia-search/config.json
index 6bbe7d33b7b..db628e87078 100644
--- a/dev-resources/algolia-search/config.json
+++ b/dev-resources/algolia-search/config.json
@@ -1,21 +1,21 @@
{
- "index_name": "docs_ranchermanager_rancher_io",
- "sitemap_urls": ["http://ranchermanager.docs.rancher.com/sitemap.xml"],
- "start_urls": ["http://ranchermanager.docs.rancher.com/"],
- "selectors": {
- "lvl0": "",
- "lvl1": "article h1",
- "lvl2": "article h2",
- "lvl3": "article h3",
- "lvl4": "article h4",
- "lvl5": "article h5"
- },
- "custom_settings": {
- "attributesForFaceting": [
- "language",
- "version",
- "type",
- "docusaurus_tag"
- ]
- }
+ "index_name": "docs_ranchermanager_rancher_io",
+ "sitemap_urls": ["http://ranchermanager.docs.rancher.com/sitemap.xml"],
+ "start_urls": ["http://ranchermanager.docs.rancher.com/"],
+ "selectors": {
+ "lvl0": "",
+ "lvl1": "article h1",
+ "lvl2": "article h2",
+ "lvl3": "article h3",
+ "lvl4": "article h4",
+ "lvl5": "article h5"
+ },
+ "custom_settings": {
+ "attributesForFaceting": [
+ "language",
+ "version",
+ "type",
+ "docusaurus_tag"
+ ]
}
+}
diff --git a/docs/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md b/docs/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
index c995eea8a41..d502a2d50ca 100644
--- a/docs/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
+++ b/docs/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
@@ -2,6 +2,10 @@
title: RKE Cluster Configuration Reference
---
+
+
+
+
When Rancher installs Kubernetes, it uses [RKE](../../../pages-for-subheaders/launch-kubernetes-with-rancher.md) or [RKE2](https://docs.rke2.io/) as the Kubernetes distribution.
This section covers the configuration options that are available in Rancher for a new or existing RKE Kubernetes cluster.
@@ -183,6 +187,19 @@ Clusters that were created before Kubernetes 1.16 will have an `ingress-nginx` `
If the `updateStrategy` of `ingress-nginx` is `OnDelete`, you will need to delete these pods to get the correct version for your deployment.
+### Cluster Agent Configuration and Fleet Agent Configuration
+
+You can configure the scheduling fields and resource limits for the Cluster Agent and the cluster's Fleet Agent. You can use these fields to customize tolerations, affinity rules, and resource requirements. Additional tolerations are appended to a list of default tolerations and control plane node taints. If you define custom affinity rules, they override the global default affinity setting. Defining resource requirements sets requests or limits where there previously were none.
+
+:::note
+With this option, it's possible to override or remove rules that are required for the functioning of the cluster. We strongly recommend against removing or overriding these and any other affinity rules, as this may cause unwanted side effects:
+
+- `affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution` for `cattle-cluster-agent`
+- `cluster-agent-default-affinity` for `cattle-cluster-agent`
+- `fleet-agent-default-affinity` for `fleet-agent`
+:::
+
+If you downgrade Rancher to v2.7.4 or below, your changes will be lost and the agents will re-deploy without your customizations. The Fleet agent will fallback to using its built-in default values when it re-deploys. If the Fleet version doesn't change during the downgrade, the re-deploy won't be immediate.
## RKE Cluster Config File Reference
@@ -343,4 +360,4 @@ There are two ways that you can specify an add-on:
- [In-line Add-ons](https://rancher.com/docs/rke/latest/en/config-options/add-ons/user-defined-add-ons/#in-line-add-ons)
- [Referencing YAML Files for Add-ons](https://rancher.com/docs/rke/latest/en/config-options/add-ons/user-defined-add-ons/#referencing-yaml-files-for-add-ons)
-For an example of how to configure a custom network plug-in by editing the `cluster.yml`, refer to the [RKE documentation.](https://rancher.com/docs/rke/latest/en/config-options/add-ons/network-plugins/custom-network-plugin-example)
+For an example of how to configure a custom network plug-in by editing the `cluster.yml`, refer to the [RKE documentation.](https://rancher.com/docs/rke/latest/en/config-options/add-ons/network-plugins/custom-network-plugin-example)
\ No newline at end of file
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 10a092136e5..d9a7b0d97ec 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -96,7 +96,7 @@ module.exports = {
className: 'navbar__github',
},
{
- href: 'https://rancher.com',
+ href: 'https://www.rancher.com',
label: 'Rancher Home',
position: 'right',
},
diff --git a/versioned_docs/version-2.0-2.4/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md b/versioned_docs/version-2.0-2.4/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
index 3fdc50d028c..2a7f56bebaa 100644
--- a/versioned_docs/version-2.0-2.4/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
+++ b/versioned_docs/version-2.0-2.4/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
@@ -2,6 +2,10 @@
title: RKE Cluster Configuration Reference
---
+
+
+
+
When Rancher installs Kubernetes, it uses [RKE](../../../pages-for-subheaders/launch-kubernetes-with-rancher.md) as the Kubernetes distribution.
This section covers the configuration options that are available in Rancher for a new or existing RKE Kubernetes cluster.
diff --git a/versioned_docs/version-2.5/cluster-provisioning/rke-clusters/options/options.md b/versioned_docs/version-2.5/cluster-provisioning/rke-clusters/options/options.md
index 7782a54c870..9fc981415b2 100644
--- a/versioned_docs/version-2.5/cluster-provisioning/rke-clusters/options/options.md
+++ b/versioned_docs/version-2.5/cluster-provisioning/rke-clusters/options/options.md
@@ -2,6 +2,10 @@
title: RKE Cluster Configuration Reference
---
+
+
+
+
When Rancher installs Kubernetes, it uses [RKE](../../../pages-for-subheaders/launch-kubernetes-with-rancher.md) as the Kubernetes distribution.
This section covers the configuration options that are available in Rancher for a new or existing RKE Kubernetes cluster.
diff --git a/versioned_docs/version-2.6/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md b/versioned_docs/version-2.6/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
index bb399ae75e9..3e66b99e6f8 100644
--- a/versioned_docs/version-2.6/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
+++ b/versioned_docs/version-2.6/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
@@ -2,6 +2,10 @@
title: RKE Cluster Configuration Reference
---
+
+
+
+
When Rancher installs Kubernetes, it uses [RKE](../../../pages-for-subheaders/launch-kubernetes-with-rancher.md) or [RKE2](https://docs.rke2.io/) as the Kubernetes distribution.
This section covers the configuration options that are available in Rancher for a new or existing RKE Kubernetes cluster.
diff --git a/versioned_docs/version-2.7/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md b/versioned_docs/version-2.7/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
index c995eea8a41..d502a2d50ca 100644
--- a/versioned_docs/version-2.7/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
+++ b/versioned_docs/version-2.7/reference-guides/cluster-configuration/rancher-server-configuration/rke1-cluster-configuration.md
@@ -2,6 +2,10 @@
title: RKE Cluster Configuration Reference
---
+
+
+
+
When Rancher installs Kubernetes, it uses [RKE](../../../pages-for-subheaders/launch-kubernetes-with-rancher.md) or [RKE2](https://docs.rke2.io/) as the Kubernetes distribution.
This section covers the configuration options that are available in Rancher for a new or existing RKE Kubernetes cluster.
@@ -183,6 +187,19 @@ Clusters that were created before Kubernetes 1.16 will have an `ingress-nginx` `
If the `updateStrategy` of `ingress-nginx` is `OnDelete`, you will need to delete these pods to get the correct version for your deployment.
+### Cluster Agent Configuration and Fleet Agent Configuration
+
+You can configure the scheduling fields and resource limits for the Cluster Agent and the cluster's Fleet Agent. You can use these fields to customize tolerations, affinity rules, and resource requirements. Additional tolerations are appended to a list of default tolerations and control plane node taints. If you define custom affinity rules, they override the global default affinity setting. Defining resource requirements sets requests or limits where there previously were none.
+
+:::note
+With this option, it's possible to override or remove rules that are required for the functioning of the cluster. We strongly recommend against removing or overriding these and any other affinity rules, as this may cause unwanted side effects:
+
+- `affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution` for `cattle-cluster-agent`
+- `cluster-agent-default-affinity` for `cattle-cluster-agent`
+- `fleet-agent-default-affinity` for `fleet-agent`
+:::
+
+If you downgrade Rancher to v2.7.4 or below, your changes will be lost and the agents will re-deploy without your customizations. The Fleet agent will fallback to using its built-in default values when it re-deploys. If the Fleet version doesn't change during the downgrade, the re-deploy won't be immediate.
## RKE Cluster Config File Reference
@@ -343,4 +360,4 @@ There are two ways that you can specify an add-on:
- [In-line Add-ons](https://rancher.com/docs/rke/latest/en/config-options/add-ons/user-defined-add-ons/#in-line-add-ons)
- [Referencing YAML Files for Add-ons](https://rancher.com/docs/rke/latest/en/config-options/add-ons/user-defined-add-ons/#referencing-yaml-files-for-add-ons)
-For an example of how to configure a custom network plug-in by editing the `cluster.yml`, refer to the [RKE documentation.](https://rancher.com/docs/rke/latest/en/config-options/add-ons/network-plugins/custom-network-plugin-example)
+For an example of how to configure a custom network plug-in by editing the `cluster.yml`, refer to the [RKE documentation.](https://rancher.com/docs/rke/latest/en/config-options/add-ons/network-plugins/custom-network-plugin-example)
\ No newline at end of file