You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/rancher/v2.x/en/installation/ha/_index.md
+9Lines changed: 9 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,4 +37,13 @@ The following CLI tools are required for this install. Please make sure these to
37
37
## Additional Install Options
38
38
39
39
*[Migrating from RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/)
40
+
41
+
## Previous Methods
42
+
43
+
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
44
+
>
45
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
46
+
>
47
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
Copy file name to clipboardExpand all lines: content/rancher/v2.x/en/installation/ha/rke-add-on/_index.md
+7-2Lines changed: 7 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,14 @@
1
1
---
2
-
title: Advanced Install - RKE Add-on
2
+
title: RKE Add-On Install
3
3
weight: 276
4
4
---
5
5
6
-
Rancher can be installed by providing the appropriate Kubernetes manifest configurations to RKE's `addons` feature. See the following instructions for examples appropriate to your environment.
6
+
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
7
+
>
8
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
9
+
>
10
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
6
14
If you're using RKE to install Rancher, you can use directives to enable API Auditing for your Rancher install. You can know what happened, when it happened, who initiated it, and what cluster it affected. API auditing records all requests and responses to and from the Rancher API, which includes use of the Rancher UI and any other use of the Rancher API through programmatic use.
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
7
14
This procedure walks you through setting up a 3-node cluster using the Rancher Kubernetes Engine (RKE). The cluster's sole purpose is running pods for Rancher. The setup is based on:
8
15
9
16
- Layer 4 load balancer (TCP)
10
17
-[NGINX ingress controller with SSL termination (HTTPS)](https://kubernetes.github.io/ingress-nginx/)
11
-
18
+
12
19
In a HA setup that uses a layer 4 load balancer, the load balancer accepts Rancher client connections over the TCP/UDP protocols (i.e., the transport level). The load balancer then forwards these connections to individual cluster nodes without reading the request itself. Because the load balancer cannot read the packets it's forwarding, the routing decisions it can make are limited.
13
20
14
21
<sup>HA Rancher install with layer 4 load balancer, depicting SSL termination at ingress controllers</sup>
@@ -160,9 +167,9 @@ RKE uses a `.yml` config file to install and configure your Kubernetes cluster.
160
167
- [Template for self-signed certificate<br/> `3-node-certificate.yml`](https://raw.githubusercontent.com/rancher/rancher/master/rke-templates/3-node-certificate.yml)
161
168
- [Template for certificate signed by recognized CA<br/> `3-node-certificate-recognizedca.yml`](https://raw.githubusercontent.com/rancher/rancher/master/rke-templates/3-node-certificate-recognizedca.yml)
162
169
163
-
>**Advanced Config Options:**
170
+
>**Advanced Config Options:**
164
171
>
165
-
>- Want records of all transactions with the Rancher API? Enable the [API Auditing]({{< baseurl >}}/rancher/v2.x/en/installation/api-auditing) feature by editing your RKE config file. For more information, see [RKE Documentation: API Auditing]({{< baseurl >}}/rke/v0.1.x/en/config-options/add-ons/api-auditing).
172
+
>- Want records of all transactions with the Rancher API? Enable the [API Auditing]({{< baseurl >}}/rancher/v2.x/en/installation/api-auditing) feature by editing your RKE config file. For more information, see how to enable it in [your RKE config file]({{< baseurl >}}/rancher/v2.x/en/installation/ha/rke-add-on/api-auditing/).
166
173
>- Want to know the other config options available for your RKE template? See the [RKE Documentation: Config Options]({{< baseurl >}}/rke/v0.1.x/en/config-options/).
167
174
168
175
@@ -200,7 +207,7 @@ Once you have the `rancher-cluster.yml` config file template, edit the nodes sec
200
207
ssh_key_path: ~/.ssh/id_rsa
201
208
202
209
1. **Optional:** By default, `rancher-cluster.yml` is configured to take backup snapshots of your data. To disable these snapshots, change the `backup` directive setting to `false`, as depicted below.
203
-
210
+
204
211
services:
205
212
etcd:
206
213
backup: false
@@ -251,7 +258,7 @@ Choose from the following options:
251
258
252
259
253
260
**Step Result:** The file should look like the example below (the base64 encoded string should be different):
254
-
261
+
255
262
```yaml
256
263
---
257
264
apiVersion: v1
@@ -262,7 +269,7 @@ Choose from the following options:
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
7
14
## Objectives
8
15
9
16
Configuring an Amazon NLB is a multistage process. We've broken it down into multiple tasks so that it's easy to follow.
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
7
14
This procedure walks you through setting up a 3-node cluster using the Rancher Kubernetes Engine (RKE). The cluster's sole purpose is running pods for Rancher. The setup is based on:
8
15
9
16
- Layer 7 Loadbalancer with SSL termination (HTTPS)
@@ -108,9 +115,9 @@ RKE uses a YAML config file to install and configure your Kubernetes cluster. Th
108
115
- [Template for self-signed certificate<br/> `3-node-externalssl-certificate.yml`](https://raw.githubusercontent.com/rancher/rancher/master/rke-templates/3-node-externalssl-certificate.yml)
109
116
- [Template for certificate signed by recognized CA<br/> `3-node-externalssl-recognizedca.yml`](https://raw.githubusercontent.com/rancher/rancher/master/rke-templates/3-node-externalssl-recognizedca.yml)
110
117
111
-
>**Advanced Config Options:**
118
+
>**Advanced Config Options:**
112
119
>
113
-
>- Want records of all transactions with the Rancher API? Enable the [API Auditing]({{< baseurl >}}/rancher/v2.x/en/installation/api-auditing) feature by editing your RKE config file. For more information, see [RKE Documentation: API Auditing]({{< baseurl >}}/rke/v0.1.x/en/config-options/add-ons/api-auditing).
120
+
>- Want records of all transactions with the Rancher API? Enable the [API Auditing]({{< baseurl >}}/rancher/v2.x/en/installation/api-auditing) feature by editing your RKE config file. For more information, see how to enable it in [your RKE config file]({{< baseurl >}}/rancher/v2.x/en/installation/ha/rke-add-on/api-auditing/).
114
121
>- Want to know the other config options available for your RKE template? See the [RKE Documentation: Config Options]({{< baseurl >}}/rke/v0.1.x/en/config-options/).
115
122
116
123
@@ -149,7 +156,7 @@ Once you have the `rancher-cluster.yml` config file template, edit the nodes sec
149
156
ssh_key_path: ~/.ssh/id_rsa
150
157
151
158
1. **Optional:** By default, `rancher-cluster.yml` is configured to take backup snapshots of your data. To disable these snapshots, change the `backup` directive setting to `false`, as depicted below.
152
-
159
+
153
160
services:
154
161
etcd:
155
162
backup: false
@@ -186,7 +193,7 @@ After replacing the values, the file should look like the example below (the bas
186
193
187
194
{{% /accordion %}}
188
195
{{% accordion id="option-b" label="Option B—Bring Your Own Certificate: Signed by Recognized CA" %}}
189
-
If you are using a Certificate Signed By A Recognized Certificate Authority, you don't need to perform any step in this part.
196
+
If you are using a Certificate Signed By A Recognized Certificate Authority, you don't need to perform any step in this part.
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
7
14
## Objectives
8
15
9
16
Configuring an Amazon ALB is a multistage process. We've broken it down into multiple tasks so that it's easy to follow.
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
7
14
## Install NGINX
8
15
9
16
Start by installing NGINX on your load balancer host. NGINX has packages available for all known operating systems.
Copy file name to clipboardExpand all lines: content/rancher/v2.x/en/installation/ha/rke-add-on/proxy/_index.md
+7Lines changed: 7 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,13 @@
2
2
title: HTTP Proxy Configuration
3
3
weight: 277
4
4
---
5
+
6
+
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
7
+
>
8
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
9
+
>
10
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
11
+
5
12
If you operate Rancher behind a proxy and you want to access services through the proxy (such as retrieving catalogs), you must provide Rancher information about your proxy. As Rancher is written in Go, it uses the common proxy environment variables as shown below.
6
13
7
14
Make sure `NO_PROXY` contains the network addresses, network address ranges and domains that should be excluded from using the proxy.
> #### **Important: RKE add-on install is only supported up to Rancher v2.0.8**
9
+
>
10
+
>Please use the Rancher helm chart to install HA Rancher. For details, see the [HA Install - Installation Outline]({{< baseurl >}}/rancher/v2.x/en/installation/ha/#installation-outline).
11
+
>
12
+
>If you are currently using the RKE add-on install method, see [Migrating from a RKE add-on install]({{< baseurl >}}/rancher/v2.x/en/upgrades/upgrades/migrating-from-rke-add-on/) for details on how to move to using the helm chart.
13
+
8
14
To debug issues around this error, you will need to download the command-line tool `kubectl`. See [Install and Set Up kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) how to download `kubectl` for your platform.
9
15
10
16
When you have made changes to `rancher-cluster.yml`, you will have to run `rke remove --config rancher-cluster.yml` to clean the nodes, so it cannot conflict with previous configuration errors.
0 commit comments