From ca7646fb126c28aa61609d94b577cc4b5ccda393 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Mon, 5 Oct 2020 12:32:18 -0700 Subject: [PATCH 1/2] Say Helm v3.2.x or higher is required to install or upgrade Rancher v2.5 --- .../v2.x/en/installation/resources/helm-version/_index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/rancher/v2.x/en/installation/resources/helm-version/_index.md b/content/rancher/v2.x/en/installation/resources/helm-version/_index.md index 3a91781871a..c4e66f92849 100644 --- a/content/rancher/v2.x/en/installation/resources/helm-version/_index.md +++ b/content/rancher/v2.x/en/installation/resources/helm-version/_index.md @@ -7,6 +7,7 @@ This section contains the requirements for Helm, which is the tool used to insta > The installation instructions have been updated for Helm 3. For migration of installs started with Helm 2, refer to the official [Helm 2 to 3 Migration Docs.](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/) [This section]({{}}/rancher/v2.x/en/installation/options/helm2) provides a copy of the older high-availability Rancher installation instructions that used Helm 2, and it is intended to be used if upgrading to Helm 3 is not feasible. +- Helm v3.2.x or higher is required to install or upgrade Rancher v2.5. - Helm v2.16.0 or higher is required for Kubernetes v1.16. For the default Kubernetes version, refer to the [release notes](https://github.com/rancher/rke/releases) for the version of RKE that you are using. - Helm v2.15.0 should not be used, because of an issue with converting/comparing numbers. - Helm v2.12.0 should not be used, because of an issue with `cert-manager`. From 092e2d4761686310bcb6d023ed9183f46aafe66a Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Mon, 5 Oct 2020 13:03:05 -0700 Subject: [PATCH 2/2] Remove installation docs not applicable to Rancher v2.5 --- .../install/aks/_index.md | 7 ----- .../install/any-k8s/_index.md | 7 ----- .../install/eks/_index.md | 7 ----- .../install/gke/_index.md | 7 ----- .../install-rancher-on-linux/_index.md | 17 ----------- .../install/_index.md | 10 ------- .../upgrades-rollbacks/_index.md | 28 ------------------- .../cluster-upgrade/_index.md | 8 ------ .../woker-node-upgrade/_index.md | 8 ------ .../image-upgrade/_index.md | 6 ---- .../upgrades-rollbacks/rollbacks/_index.md | 4 --- 11 files changed, 109 deletions(-) delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/aks/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/any-k8s/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/eks/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/gke/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/install/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/woker-node-upgrade/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/image-upgrade/_index.md delete mode 100644 content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/rollbacks/_index.md diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/aks/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/aks/_index.md deleted file mode 100644 index 319965a7229..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/aks/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Installing Rancher on an AKS Kubernetes Cluster -shortTitle: AKS -weight: 2 ---- - -> This section is under construction. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/any-k8s/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/any-k8s/_index.md deleted file mode 100644 index 46a6a887dbb..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/any-k8s/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Installing Rancher on Any Kubernetes Cluster -shortTitle: Any Kubernetes Cluster -weight: 4 ---- - -> This section is under construction. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/eks/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/eks/_index.md deleted file mode 100644 index 97c254dd05a..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/eks/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Installing Rancher on an EKS Kubernetes Cluster -shortTitle: EKS -weight: 1 ---- - -> This section is under construction. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/gke/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/gke/_index.md deleted file mode 100644 index 241a7d0822a..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-k8s/install/gke/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Installing Rancher on a GKE Kubernetes Cluster -shortTitle: GKE -weight: 3 ---- - -> This section is under construction. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/_index.md deleted file mode 100644 index 993ad916a60..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/_index.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Install Rancher on a Linux OS -weight: 2 ---- - -> This section is under construction. - -Rancher is both a platform and a Kubernetes distribution. In this section you'll learn how to install the Rancher binary. You will use the Rancher CLI to set up a Rancher Kubernetes cluster that has the Rancher server Helm chart preinstalled. - -There are two main ways that Rancher can be installed: - -1. You can use Helm to install the Rancher Helm chart on any Kubernetes cluster. -2. You can use the Rancher CLI to install a Rancher Kubernetes cluster. This cluster comes with the Rancher Helm chart built in. - -The installation path that you choose will affect the way that you upgrade Rancher, but not the way that Rancher is backed up and restored. - -This section focuses on the installation path in which the Rancher Helm chart is installed on an existing Kubernetes cluster. diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/install/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/install/_index.md deleted file mode 100644 index 1bb080bd47f..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/install/_index.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Install -weight: 1 ---- - -> This page is under construction. - -In this section, you'll learn how to create a Rancher Kubernetes cluster that comes with the Rancher Helm chart built in. - -> To install Rancher on an existing Kubernetes cluster, refer to the instructions on [installing the Rancher Helm chart.](../../rancher-helm-install-upgrade/installation) \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/_index.md deleted file mode 100644 index a171755b27a..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/_index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Upgrades and Rollbacks -weight: 2 ---- - -> This page is under construction. - -This page is about how to upgrade the local Kubernetes cluster that Rancher is installed on, as well as the Rancher Helm chart. - -This information applies if you set up the local Rancher server cluster using the Rancher CLI. - -To upgrade the Rancher server's local Kubernetes cluster using the Rancher CLI, you will first upgrade the master nodes of the cluster, and then the worker nodes. - -### About Rancher Kubernetes - -Rancher is intended to be installed on any Kubernetes cluster. - -The Rancher CLI comes with a Kubernetes distribution called Rancher Kubernetes, which allows you to install Kubernetes more easily as a prerequisite to installing Rancher. - -Rancher Kubernetes clusters can also be imported into Rancher. - - -### Known Upgrade Issues - -A list of known issues for each Rancher version can be found in the release notes on [GitHub](https://github.com/rancher/rancher/releases) and on the [Rancher forums.](https://forums.rancher.com/c/announcements/12) - -### Caveats -Upgrades _to_ or _from_ any chart in the [rancher-alpha repository]({{}}/rancher/v2.x/en/installation/options/server-tags/#helm-chart-repositories/) aren't supported. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/_index.md deleted file mode 100644 index f33386702a1..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/_index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Cluster Upgrade -weight: 2 ---- - -> This section is under construction. - -In this section, you'll learn how to upgrade the Rancher Helm chart and the master nodes of the Rancher Kubernetes cluster, if applicable. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/woker-node-upgrade/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/woker-node-upgrade/_index.md deleted file mode 100644 index 76f04a09ac2..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/cluster-upgrade/woker-node-upgrade/_index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Worker Node Upgrade -weight: 1 ---- - -> This page is under construction. - -In this section, you'll learn how to upgrade the worker nodes of the Rancher Kubernetes cluster, if applicable. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/image-upgrade/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/image-upgrade/_index.md deleted file mode 100644 index c68c3d159e7..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/image-upgrade/_index.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Upgrade the Rancher Image -weight: 1 ---- - -> This page is under construction. \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/rollbacks/_index.md b/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/rollbacks/_index.md deleted file mode 100644 index 04d894708a2..00000000000 --- a/content/rancher/v2.x/en/installation/install-rancher-on-linux/upgrades-rollbacks/rollbacks/_index.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -title: Rollbacks -weight: 3 ---- \ No newline at end of file