From 3fd93fe9b73054408e6de705af2b6b2c2817c516 Mon Sep 17 00:00:00 2001 From: Billy Tat Date: Thu, 19 Oct 2023 13:22:05 -0700 Subject: [PATCH] Add/update Fleet landing page --- .../version-2.8/getting-started/overview.md | 2 +- .../deploy-apps-across-clusters/fleet.md | 6 ++--- .../architecture.md | 0 .../integrations-in-rancher/fleet/fleet.md | 23 ++++++++++++++++ .../fleet/overview.md} | 14 ++++------ .../use-fleet-behind-a-proxy.md | 0 .../windows-support.md | 0 .../backup-restore-and-disaster-recovery.md | 2 +- versioned_sidebars/version-2.8-sidebars.json | 27 ++++++++++--------- 9 files changed, 47 insertions(+), 27 deletions(-) rename versioned_docs/version-2.8/integrations-in-rancher/{fleet-gitops-at-scale => fleet}/architecture.md (100%) create mode 100644 versioned_docs/version-2.8/integrations-in-rancher/fleet/fleet.md rename versioned_docs/version-2.8/{pages-for-subheaders/fleet-gitops-at-scale.md => integrations-in-rancher/fleet/overview.md} (81%) rename versioned_docs/version-2.8/integrations-in-rancher/{fleet-gitops-at-scale => fleet}/use-fleet-behind-a-proxy.md (100%) rename versioned_docs/version-2.8/integrations-in-rancher/{fleet-gitops-at-scale => fleet}/windows-support.md (100%) diff --git a/versioned_docs/version-2.8/getting-started/overview.md b/versioned_docs/version-2.8/getting-started/overview.md index b7f35276bc6..cafca0a14af 100644 --- a/versioned_docs/version-2.8/getting-started/overview.md +++ b/versioned_docs/version-2.8/getting-started/overview.md @@ -42,7 +42,7 @@ The Rancher API server is built on top of an embedded Kubernetes API server and - **Provisioning Kubernetes clusters:** The Rancher API server can [provision Kubernetes](../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md) on existing nodes, or perform [Kubernetes upgrades.](installation-and-upgrade/upgrade-and-roll-back-kubernetes.md) - **Catalog management:** Rancher provides the ability to use a [catalog of Helm charts](../pages-for-subheaders/helm-charts-in-rancher.md) that make it easy to repeatedly deploy applications. - **Managing projects:** A project is a group of multiple namespaces and access control policies within a cluster. A project is a Rancher concept, not a Kubernetes concept, which allows you to manage multiple namespaces as a group and perform Kubernetes operations in them. The Rancher UI provides features for [project administration](../pages-for-subheaders/manage-projects.md) and for [managing applications within projects.](../pages-for-subheaders/kubernetes-resources-setup.md) -- **Fleet Continuous Delivery:** Within Rancher, you can leverage [Fleet Continuous Delivery](../pages-for-subheaders/fleet-gitops-at-scale.md) to deploy applications from git repositories, without any manual operation, to targeted downstream Kubernetes clusters. +- **Fleet Continuous Delivery:** Within Rancher, you can leverage [Fleet Continuous Delivery](../integrations-in-rancher/fleet/fleet.md) to deploy applications from git repositories, without any manual operation, to targeted downstream Kubernetes clusters. - **Istio:** Our [integration with Istio](../pages-for-subheaders/istio.md) is designed so that a Rancher operator, such as an administrator or cluster owner, can deliver Istio to developers. Then developers can use Istio to enforce security policies, troubleshoot problems, or manage traffic for green/blue deployments, canary deployments, or A/B testing. ### Working with Cloud Infrastructure diff --git a/versioned_docs/version-2.8/how-to-guides/new-user-guides/deploy-apps-across-clusters/fleet.md b/versioned_docs/version-2.8/how-to-guides/new-user-guides/deploy-apps-across-clusters/fleet.md index 8ff8e4cd5be..e9d4dec7faa 100644 --- a/versioned_docs/version-2.8/how-to-guides/new-user-guides/deploy-apps-across-clusters/fleet.md +++ b/versioned_docs/version-2.8/how-to-guides/new-user-guides/deploy-apps-across-clusters/fleet.md @@ -13,7 +13,7 @@ Fleet is a separate project from Rancher, and can be installed on any Kubernetes ## Architecture -For information about how Fleet works, see [this page.](../../../integrations-in-rancher/fleet-gitops-at-scale/architecture.md) +For information about how Fleet works, see [this page.](../../../integrations-in-rancher/fleet/architecture.md) ## Accessing Fleet in the Rancher UI @@ -38,7 +38,7 @@ Follow the steps below to access Continuous Delivery in the Rancher UI: ## Windows Support -For details on support for clusters with Windows nodes, see [this page.](../../../integrations-in-rancher/fleet-gitops-at-scale/windows-support.md) +For details on support for clusters with Windows nodes, see [this page.](../../../integrations-in-rancher/fleet/windows-support.md) ## GitHub Repository @@ -48,7 +48,7 @@ The Fleet Helm charts are available [here.](https://github.com/rancher/fleet/rel ## Using Fleet Behind a Proxy -For details on using Fleet behind a proxy, see [this page.](../../../integrations-in-rancher/fleet-gitops-at-scale/use-fleet-behind-a-proxy.md) +For details on using Fleet behind a proxy, see [this page.](../../../integrations-in-rancher/fleet/use-fleet-behind-a-proxy.md) ## Helm Chart Dependencies diff --git a/versioned_docs/version-2.8/integrations-in-rancher/fleet-gitops-at-scale/architecture.md b/versioned_docs/version-2.8/integrations-in-rancher/fleet/architecture.md similarity index 100% rename from versioned_docs/version-2.8/integrations-in-rancher/fleet-gitops-at-scale/architecture.md rename to versioned_docs/version-2.8/integrations-in-rancher/fleet/architecture.md diff --git a/versioned_docs/version-2.8/integrations-in-rancher/fleet/fleet.md b/versioned_docs/version-2.8/integrations-in-rancher/fleet/fleet.md new file mode 100644 index 00000000000..0db52a7e9e1 --- /dev/null +++ b/versioned_docs/version-2.8/integrations-in-rancher/fleet/fleet.md @@ -0,0 +1,23 @@ +--- +title: Continuous Delivery with Fleet +--- + +Fleet orchestrates and manages the continuous delivery of applications through the supply chain for fleets of clusters. Fleet organizes the supply chain to help teams deliver with confidence and trust in a timely manner using GitOps as a safe operating model. + +## Fleet with Rancher + +Many users often manage over 10 clusters at a time. Given the proliferation of clusters, continuous delivery is an important part of Rancher. Fleet ensures a reliable continuous delivery experience using GitOps, which is a safe and increasingly common operating model. + +### When should I use Fleet? + +- I need to deploy my monitoring stack (e.g., Grafana, Prometheus) across geographical regions, each with different retention policies. +- I am a platform operator and want to provision clusters with all components using a scalable and safe operating model (GitOps). +- I am an application developer and want to get my latest changes to automatically into my development environment. + +## Fleet with Rancher Prime + +Fleet is already deeply integrated as the Continuous Delivery tool and GitOps Engine in Rancher. + + diff --git a/versioned_docs/version-2.8/pages-for-subheaders/fleet-gitops-at-scale.md b/versioned_docs/version-2.8/integrations-in-rancher/fleet/overview.md similarity index 81% rename from versioned_docs/version-2.8/pages-for-subheaders/fleet-gitops-at-scale.md rename to versioned_docs/version-2.8/integrations-in-rancher/fleet/overview.md index 54e38cc48eb..b7e1806fb58 100644 --- a/versioned_docs/version-2.8/pages-for-subheaders/fleet-gitops-at-scale.md +++ b/versioned_docs/version-2.8/integrations-in-rancher/fleet/overview.md @@ -1,11 +1,7 @@ --- -title: Continuous Delivery with Fleet +title: Overview --- - - - - Continuous Delivery with Fleet is GitOps at scale. Fleet is designed to manage up to a million clusters. It’s also lightweight enough that it works great for a [single cluster](https://fleet.rancher.io/installation#default-install) too, but it really shines when you get to a [large scale](https://fleet.rancher.io/installation#configuration-for-multi-cluster). 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. @@ -13,7 +9,7 @@ Fleet is a separate project from Rancher, and can be installed on any Kubernetes ## Architecture -For information about how Fleet works, see [this page](../integrations-in-rancher/fleet-gitops-at-scale/architecture.md). +For information about how Fleet works, see the [Architecture](./architecture.md) page. ## Accessing Fleet in the Rancher UI @@ -41,7 +37,7 @@ Follow the steps below to access Continuous Delivery in the Rancher UI: ## Windows Support -For details on support for clusters with Windows nodes, see [this page](../integrations-in-rancher/fleet-gitops-at-scale/windows-support.md). +For details on support for clusters with Windows nodes, see the [Windows Support](./windows-support.md) page. ## GitHub Repository @@ -49,7 +45,7 @@ The Fleet Helm charts are available [here](https://github.com/rancher/fleet/rele ## Using Fleet Behind a Proxy -For details on using Fleet behind a proxy, see [this page](../integrations-in-rancher/fleet-gitops-at-scale/use-fleet-behind-a-proxy.md). +For details on using Fleet behind a proxy, see the [Using Fleet Behind a Proxy](./use-fleet-behind-a-proxy.md) page. ## Helm Chart Dependencies @@ -59,7 +55,7 @@ The Helm chart in the git repository must include its dependencies in the charts ## Troubleshooting -- **Known Issue**: clientSecretName and helmSecretName secrets for Fleet gitrepos are not included in the backup nor restore created by the [backup-restore-operator](../how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/back-up-rancher.md#1-install-the-rancher-backup-operator). We will update the community once a permanent solution is in place. +- **Known Issue**: clientSecretName and helmSecretName secrets for Fleet gitrepos are not included in the backup nor restore created by the [backup-restore-operator](../../how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/back-up-rancher.md#1-install-the-rancher-backup-operator). We will update the community once a permanent solution is in place. - **Temporary Workaround**: By default, user-defined secrets are not backed up in Fleet. It is necessary to recreate secrets if performing a disaster recovery restore or migration of Rancher into a fresh cluster. To modify resourceSet to include extra resources you want to backup, refer to docs [here](https://github.com/rancher/backup-restore-operator#user-flow). diff --git a/versioned_docs/version-2.8/integrations-in-rancher/fleet-gitops-at-scale/use-fleet-behind-a-proxy.md b/versioned_docs/version-2.8/integrations-in-rancher/fleet/use-fleet-behind-a-proxy.md similarity index 100% rename from versioned_docs/version-2.8/integrations-in-rancher/fleet-gitops-at-scale/use-fleet-behind-a-proxy.md rename to versioned_docs/version-2.8/integrations-in-rancher/fleet/use-fleet-behind-a-proxy.md diff --git a/versioned_docs/version-2.8/integrations-in-rancher/fleet-gitops-at-scale/windows-support.md b/versioned_docs/version-2.8/integrations-in-rancher/fleet/windows-support.md similarity index 100% rename from versioned_docs/version-2.8/integrations-in-rancher/fleet-gitops-at-scale/windows-support.md rename to versioned_docs/version-2.8/integrations-in-rancher/fleet/windows-support.md diff --git a/versioned_docs/version-2.8/pages-for-subheaders/backup-restore-and-disaster-recovery.md b/versioned_docs/version-2.8/pages-for-subheaders/backup-restore-and-disaster-recovery.md index 19feeb770d0..912bd19264e 100644 --- a/versioned_docs/version-2.8/pages-for-subheaders/backup-restore-and-disaster-recovery.md +++ b/versioned_docs/version-2.8/pages-for-subheaders/backup-restore-and-disaster-recovery.md @@ -48,7 +48,7 @@ The `rancher-backup` operator can be installed from the Rancher UI, or with the :::note -There is a known issue in Fleet that occurs after performing a restoration using the backup-restore-operator: Secrets used for clientSecretName and helmSecretName are not included in Fleet gitrepos. Refer [here](./fleet-gitops-at-scale.md#troubleshooting) for a workaround. +There is a known issue in Fleet that occurs after performing a restoration using the backup-restore-operator: Secrets used for clientSecretName and helmSecretName are not included in Fleet gitrepos. Refer to the [Fleet Troubleshooting](../integrations-in-rancher/fleet/overview.md#troubleshooting) section for a workaround. ::: diff --git a/versioned_sidebars/version-2.8-sidebars.json b/versioned_sidebars/version-2.8-sidebars.json index cf33cef7fe6..d416b756392 100644 --- a/versioned_sidebars/version-2.8-sidebars.json +++ b/versioned_sidebars/version-2.8-sidebars.json @@ -1126,6 +1126,20 @@ }, "integrations-in-rancher/kubewarden/kubewarden", "integrations-in-rancher/opni/opni", + { + "type": "category", + "label": "Continuous Delivery with Fleet", + "link": { + "type": "doc", + "id": "integrations-in-rancher/fleet/fleet" + }, + "items": [ + "integrations-in-rancher/fleet/overview", + "integrations-in-rancher/fleet/architecture", + "integrations-in-rancher/fleet/windows-support", + "integrations-in-rancher/fleet/use-fleet-behind-a-proxy" + ] + }, "integrations-in-rancher/rancher-desktop", "integrations-in-rancher/epinio/epinio", { @@ -1167,19 +1181,6 @@ "integrations-in-rancher/cis-scans/custom-benchmark" ] }, - { - "type": "category", - "label": "Continuous Delivery with Fleet", - "link": { - "type": "doc", - "id": "pages-for-subheaders/fleet-gitops-at-scale" - }, - "items": [ - "integrations-in-rancher/fleet-gitops-at-scale/architecture", - "integrations-in-rancher/fleet-gitops-at-scale/windows-support", - "integrations-in-rancher/fleet-gitops-at-scale/use-fleet-behind-a-proxy" - ] - }, { "type": "category", "label": "Istio",