From e440b860cd73e8b15cbca4282d97eb5539470761 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Thu, 11 Feb 2021 11:17:57 -0700 Subject: [PATCH] Add 2.5.6 Fleet upgrade workflow for Windows PR #3014 --- .../en/deploy-across-clusters/fleet/_index.md | 22 +++++++++++++++++++ .../en/deploy-across-clusters/fleet/_index.md | 22 ++++++++++++++++++- 2 files changed, 43 insertions(+), 1 deletion(-) diff --git a/content/rancher/v2.5/en/deploy-across-clusters/fleet/_index.md b/content/rancher/v2.5/en/deploy-across-clusters/fleet/_index.md index 6cf0f98eeb0..9af4a260e3d 100644 --- a/content/rancher/v2.5/en/deploy-across-clusters/fleet/_index.md +++ b/content/rancher/v2.5/en/deploy-across-clusters/fleet/_index.md @@ -3,6 +3,8 @@ title: Fleet - GitOps at Scale weight: 1 --- +_Available as of Rancher v2.5_ + Fleet is GitOps at scale. Fleet is designed to manage up to a million clusters. It's also lightweight enough that is works great for a [single cluster](https://fleet.rancher.io/single-cluster-install/) too, but it really shines when you get to a [large scale.](https://fleet.rancher.io/multi-cluster-install/) By large scale we mean either a lot of clusters, a lot of deployments, or a lot of teams in a single organization. Fleet is a separate project from Rancher, and can be installed on any Kubernetes cluster with Helm. @@ -15,6 +17,26 @@ Fleet can manage deployments from git of raw Kubernetes YAML, Helm charts, or Ku Fleet comes preinstalled in Rancher v2.5. To access it, go to the **Cluster Explorer** in the Rancher UI. In the top left dropdown menu, click **Cluster Explorer > Continuous Delivery.** On this page, you can edit Kubernetes resources and cluster groups managed by Fleet. +### Windows Support + +Prior to Rancher v2.5.6, the `agent` did not have native Windows manifests on downstream clusters with Windows nodes. +This would result in a failing `agent` pod for the cluster. +If you are upgrading from an older version of Rancher to v2.5.6+, you can deploy a working `agent` with the following workflow *in the downstream cluster*: + +1. Cordon all Windows nodes. +1. Apply the below toleration to the `agent` workload. +1. Uncordon all Windows nodes. +1. Delete all `agent` pods. New pods should be created with the new toleration. +1. Once the `agent` pods are running, and auto-update is enabled for Fleet, they should be updated to a Windows-compatible `agent` version. + +```yaml +tolerations: +- effect: NoSchedule + key: cattle.io/os + operator: Equal + value: linux +``` + ### GitHub Repository The Fleet Helm charts are available [here.](https://github.com/rancher/fleet/releases/latest) diff --git a/content/rancher/v2.x/en/deploy-across-clusters/fleet/_index.md b/content/rancher/v2.x/en/deploy-across-clusters/fleet/_index.md index a794ffbe459..2bfe608fa13 100644 --- a/content/rancher/v2.x/en/deploy-across-clusters/fleet/_index.md +++ b/content/rancher/v2.x/en/deploy-across-clusters/fleet/_index.md @@ -19,10 +19,30 @@ deploy everything in the cluster. This give a high degree of control, consistenc Fleet comes preinstalled in Rancher v2.5. To access it, go to the **Cluster Explorer** in the Rancher UI. In the top left dropdown menu, click **Cluster Explorer > Continuous Delivery.** On this page, you can edit Kubernetes resources and cluster groups managed by Fleet. +### Windows Support + +Prior to Rancher v2.5.6, the `agent` did not have native Windows manifests on downstream clusters with Windows nodes. +This would result in a failing `agent` pod for the cluster. +If you are upgrading from an older version of Rancher to v2.5.6+, you can deploy a working `agent` with the following workflow *in the downstream cluster*: + +1. Cordon all Windows nodes. +1. Apply the below toleration to the `agent` workload. +1. Uncordon all Windows nodes. +1. Delete all `agent` pods. New pods should be created with the new toleration. +1. Once the `agent` pods are running, and auto-update is enabled for Fleet, they should be updated to a Windows-compatible `agent` version. + +```yaml +tolerations: +- effect: NoSchedule + key: cattle.io/os + operator: Equal + value: linux +``` + ### GitHub Repository The Fleet Helm charts are available [here.](https://github.com/rancher/fleet/releases/latest) ### Documentation -The Fleet documentation is at [https://fleet.rancher.io/.](https://fleet.rancher.io/) \ No newline at end of file +The Fleet documentation is at [https://fleet.rancher.io/.](https://fleet.rancher.io/)