public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-09-28 22:18:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

updating ha install/upgrade command

Browse Source
This commit is contained in:
Mark Bishop
2018-10-16 17:33:45 -07:00
parent 3e26bfff1e
commit e1c94619f4
4 changed files with 18 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/rancher/v2.x/en/installation/air-gap-installation/install-rancher/_index.md
+2 -2
View File
@@ -104,10 +104,10 @@ Install the Rancher chart repo.
helm repo add rancher-stable https://releases.rancher.com/server-charts/stable helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
``` ```
Fetch the latest `rancher-stable/rancher` chart. This will pull down the chart and save it in the current directory as a `.tgz` file. Fetch the latest `rancher-latest/rancher` chart. This will pull down the chart and save it in the current directory as a `.tgz` file.
```plain ```plain
helm fetch rancher-stable/rancher helm fetch rancher-latest/rancher
``` ```
Render the template with the options you would use to install the chart. See [Install Rancher]({{< baseurl >}}/rancher/v2.x/en/installation/ha/helm-rancher/) for details on the various options. Remember to set the `rancherImage` option to pull the image from your private registry. This will create a `rancher` directory with the Kubernetes manifest files. Render the template with the options you would use to install the chart. See [Install Rancher]({{< baseurl >}}/rancher/v2.x/en/installation/ha/helm-rancher/) for details on the various options. Remember to set the `rancherImage` option to pull the image from your private registry. This will create a `rancher` directory with the Kubernetes manifest files.
content/rancher/v2.x/en/installation/ha/helm-rancher/_index.md
+8 -5
View File
@@ -11,10 +11,13 @@ Rancher installation is now managed using the Helm package manager for Kubernete
Use `helm repo add` to add the Rancher chart repository. Use `helm repo add` to add the Rancher chart repository.
>**Note:** We recommend adding the `latest` Rancher chart repository used in the command below, but you also have the option of using our `stable` repository. For more information, see [Server Tags]({{< baseurl >}}/rancher/v2.x/en/installation/server-tags/).
``` ```
helm repo add rancher-stable https://releases.rancher.com/server-charts/stable helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
``` ```
## Chart Versioning Notes ## Chart Versioning Notes
Up until the initial helm chart release for v2.1.0, the helm chart version matched the Rancher version (i.e `appVersion`). Up until the initial helm chart release for v2.1.0, the helm chart version matched the Rancher version (i.e `appVersion`).
@@ -25,7 +28,7 @@ Run `helm search rancher` to view which Rancher version will be launched for the
``` ```
NAME CHART VERSION APP VERSION DESCRIPTION NAME CHART VERSION APP VERSION DESCRIPTION
rancher-stable/rancher 2018.10.1 v2.1.0 Install Rancher Server to manage Kubernetes clusters acro... rancher-latest/rancher 2018.10.1 v2.1.0 Install Rancher Server to manage Kubernetes clusters acro...
``` ```
### Install cert-manager ### Install cert-manager
@@ -63,7 +66,7 @@ The only requirement is to set the `hostname` to the DNS name you pointed at you
>**Using Air Gap?** [Set the `rancherImage` option]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/install-rancher/#install-rancher-using-private-registry) in your command, pointing toward your private registry. >**Using Air Gap?** [Set the `rancherImage` option]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/install-rancher/#install-rancher-using-private-registry) in your command, pointing toward your private registry.
``` ```
helm install rancher-stable/rancher \ helm install rancher-latest/rancher \
--name rancher \ --name rancher \
--namespace cattle-system \ --namespace cattle-system \
--set hostname=rancher.my.org --set hostname=rancher.my.org
@@ -78,7 +81,7 @@ Set `hostname`, `ingress.tls.source=letsEncrypt` and LetsEncrypt options.
>**Using Air Gap?** [Set the `rancherImage` option]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/install-rancher/#install-rancher-using-private-registry) in your command, pointing toward your private registry. >**Using Air Gap?** [Set the `rancherImage` option]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/install-rancher/#install-rancher-using-private-registry) in your command, pointing toward your private registry.
``` ```
helm install rancher-stable/rancher \ helm install rancher-latest/rancher \
--name rancher \ --name rancher \
--namespace cattle-system \ --namespace cattle-system \
--set hostname=rancher.my.org \ --set hostname=rancher.my.org \
@@ -97,7 +100,7 @@ Set `hostname` and `ingress.tls.source=secret`.
> **Note:** If you are using a Private CA signed cert, add `--set privateCA=true` > **Note:** If you are using a Private CA signed cert, add `--set privateCA=true`
``` ```
helm install rancher-stable/rancher \ helm install rancher-latest/rancher \
--name rancher \ --name rancher \
--namespace cattle-system \ --namespace cattle-system \
--set hostname=rancher.my.org \ --set hostname=rancher.my.org \
content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm-airgap/_index.md
+3 -3
View File
@@ -34,7 +34,7 @@ Run `helm search rancher` to view which Rancher version will be launched for the
``` ```
NAME CHART VERSION APP VERSION DESCRIPTION NAME CHART VERSION APP VERSION DESCRIPTION
rancher-stable/rancher 2018.10.1 v2.1.0 Install Rancher Server to manage Kubernetes clusters acro... rancher-latest/rancher 2018.10.1 v2.1.0 Install Rancher Server to manage Kubernetes clusters acro...
``` ```
## Upgrade Rancher ## Upgrade Rancher
@@ -45,12 +45,12 @@ rancher-stable/rancher 2018.10.1 v2.1.0 Install Rancher Serve
helm repo update helm repo update
``` ```
1. Fetch the latest `rancher-stable/rancher` chart. 1. Fetch the latest `rancher-latest/rancher` chart.
This will pull down the chart and save it in the current directory as a `.tgz` file. This will pull down the chart and save it in the current directory as a `.tgz` file.
```plain ```plain
helm fetch rancher-stable/rancher helm fetch rancher-latest/rancher
``` ```
1. Render the upgrade template. 1. Render the upgrade template.
content/rancher/v2.x/en/upgrades/upgrades/ha-server-upgrade-helm/_index.md
+5 -3
View File
@@ -48,7 +48,7 @@ Run `helm search rancher` to view which Rancher version will be launched for the
``` ```
NAME CHART VERSION APP VERSION DESCRIPTION NAME CHART VERSION APP VERSION DESCRIPTION
rancher-stable/rancher 2018.10.1 v2.1.0 Install Rancher Server to manage Kubernetes clusters acro... rancher-latest/rancher 2018.10.1 v2.1.0 Install Rancher Server to manage Kubernetes clusters acro...
``` ```
## Upgrade Rancher ## Upgrade Rancher
@@ -74,10 +74,12 @@ rancher-stable/rancher 2018.10.1 v2.1.0 Install Rancher Serve
3. Take all values from the previous command and use `helm` with `--set` options to upgrade Rancher to the latest version. 3. Take all values from the previous command and use `helm` with `--set` options to upgrade Rancher to the latest version.
``` ```
helm upgrade rancher rancher-stable/rancher --set hostname=rancher.my.org helm upgrade rancher rancher-latest/rancher --set hostname=rancher.my.org
``` ```
> **Important:** For any values listed from Step 2, you must use `--set key=value` to apply the same values to the helm chart. > **Important:**
>- For any values listed from Step 2, you must use `--set key=value` to apply the same values to the helm chart.
>- During upgrade, you must use the Rancher chart repository that you used during initial install (the `latest` repository by default). For more information, see [Server Tags]({{< baseurl >}}/rancher/v2.x/en/installation/server-tags/)
## Rolling Back ## Rolling Back