public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-05-22 04:45:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Link to RKE upgrade docs in Rancher HA upgrade doc

Browse Source
This commit is contained in:
Catherine Luse
2019-10-11 12:05:24 -07:00
committed by Denise
parent f73512af39
commit beddcbc999
2 changed files with 12 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/rancher/v2.x/en/upgrades/upgrades/_index.md
+1 -1
View File
@@ -2,7 +2,7 @@
title: Upgrades
weight: 1005
---
This section contains information about how to upgrade your Rancher server to a newer version. Regardless if you installed in an air gap environment or not, the upgrade steps will be based on what type of install you chosen. Select from the following options:
This section contains information about how to upgrade your Rancher server to a newer version. Regardless if you installed in an air gap environment or not, the upgrade steps mainly depend on whether you have a single node or high-availability installation of Rancher. Select from the following options:
- [Upgrading a Single Node Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/single-node/)
- [Upgrading an HA Install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/ha/)
content/rancher/v2.x/en/upgrades/upgrades/ha/_index.md
+11 -14
View File
@@ -7,32 +7,32 @@ aliases:
- /rancher/v2.x/en/upgrades/air-gap-upgrade/
---
The following instructions will guide you through upgrading a high-availability (HA) Rancher server installation.
The following instructions will guide you through using Helm to upgrade a high-availability (HA) Rancher server installation.
>**Note:** If you installed Rancher using the RKE Add-on yaml, following the directions to [migrate or upgrade]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on).
To upgrade the components in your Kubernetes cluster, or the definition of the [Kubernetes services]({{<baseurl>}}/rke/latest/en/config-options/services/) or [add-ons]({{< baseurl >}}/rke/latest/en/config-options/add-ons/), refer to the [upgrade documentation for RKE]({{<baseurl>}}/rke/latest/en/upgrades/), the Rancher Kubernetes Engine.
If you installed Rancher using the RKE Add-on yaml, follow the directions to [migrate or upgrade]({{<baseurl>}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on).
>**Note:** [Let's Encrypt will be blocking cert-manager instances older than 0.8.0 starting November 1st 2019.](https://community.letsencrypt.org/t/blocking-old-cert-manager-versions/98753) Upgrade cert-manager to the latest version by following [these instructions.]({{<baseurl>}}/rancher/v2.x/en/installation/options/upgrading-cert-manager)
## Prerequisites
# Prerequisites
- **Review the [Known Upgrade Issues]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/#known-upgrade-issues) and [Caveats]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/#caveats)**
- **[Air Gap Installs Only:]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap/) Collect and Populate Images for the new Rancher server version**
Follow the guide to [populate your private registry]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap/populate-private-registry/) with the images for the Rancher version that you want to upgrade to.
## Upgrade Outline
# Upgrade Outline
Follow the steps to upgrade Rancher server:
- A. Backup your Kubernetes Cluster that is running Rancher server
- B. Update the Helm chart repository
- C. Upgrade Rancher
- D. Verify the Upgrade
- [A. Back up your Kubernetes cluster that is running Rancher server](#a-backup-your-kubernetes-cluster-that-is-running-rancher-server)
- [B. Update the Helm chart repository](#b-update-the-helm-chart-repository)
- [C. Upgrade Rancher](#c-upgrade-rancher)
- [D. Verify the Upgrade](#d-verify-the-upgrade)
### A. Backup your Kubernetes Cluster that is running Rancher server
### A. Back up Your Kubernetes Cluster that is Running Rancher Server
[Take a one-time snapshot]({{< baseurl >}}/rancher/v2.x/en/backups/backups/ha-backups/#option-b-one-time-snapshots)
of your Kubernetes cluster running Rancher server. You'll use the snapshot as a restoration point if something goes wrong during upgrade.
@@ -72,10 +72,7 @@ of your Kubernetes cluster running Rancher server. You'll use the snapshot as a
### C. Upgrade Rancher
Choose from the following options:
* HA Upgrade
* HA Upgrade for Air Gap Installs
This section describes how to upgrade normal (Internet-connected) or air gap installations of Rancher with Helm.
{{% tabs %}}
{{% tab "HA Upgrade" %}}