How to install or upgrade to a specific Rancher v2.x version
This document (000020217) is provided subject to the disclaimer at the end of this document.
Environment
Situation
Issue
By default the installation and upgrade documentation references the installation of, or upgrade to, the most recently released latest or stable tagged version of Rancher. This article details how to install a specific version, both in a single node and high availability installation.
For details on the difference between the latest and stable releases please see the documentation on 'Choosing a Version' .
N.B. We strongly recommend you only run product releases tagged “Stable” in your production and any other business-critical environments. Any product release with the “Latest” tag should only be used for testing the latest releases."
Resolution
Single Node Install
To install or upgrade to a specific Rancher version in a single node install, you can specify the exact version number of the image to run, rancher/rancher:vX.X.X
, i.e.:
docker run -d --restart=unless-stopped \ -p 80:80 -p 443:443 \ --privileged \ rancher/rancher:latest or rancher/rancher:v2.7.0
High Availability (HA) Install
To install or upgrade to a specific version in a High Availability install, you can specify the --version X.X.X
parameter when running the helm install
or helm upgrade
command, i.e.:
helm install rancher rancher-<CHART_REPO>/rancher \ --namespace cattle-system \ --set hostname=rancher.my.org \ --set bootstrapPassword=admin \ --version 2.7.0
Disclaimer
This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.
- Document ID:000020217
- Creation Date: 06-May-2021
- Modified Date:03-Apr-2024
-
- SUSE Rancher
For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]suse.com