clean up dir names, add ports shortcode, typos and fixes

This commit is contained in:
Jason Greathouse
2018-07-18 11:23:39 +10:00
parent 3ccff9007a
commit dda6aa5145
23 changed files with 80 additions and 35 deletions
@@ -6,16 +6,16 @@ draft: true
When installed as a Deployment in a Kubernetes cluster, Rancher will take integrate with the cluster's etcd database and Kubernetes scheduling for High-Availability.
This procedure walks you through setting up a 3-node cluster with RKE and installing the Rancher chart the Helm package manager.
This procedure walks you through setting up a 3-node cluster with RKE and installing the Rancher chart with the Helm package manager.
> NOTE: For the best performance, we recommend this Kubernetes cluster be dedicated only the Rancher workload.
> NOTE: For the best performance, we recommend this Kubernetes cluster is dedicated to only the Rancher workload.
## Recommended Architecture
* DNS for Rancher should resolve to a Layer 4 Load Balancer
* The Load Balancer should forward ports 80 and 443 TCP to all 3 nodes in the Kubernetes cluster.
* The ingress controller will redirect http port 80 to https and terminate SSL/TLS on port 443.
* The ingress controller will forward traffic to port 80 on the Pod in the Rancher Deployment.
* The Ingress controller will redirect http port 80 to https and terminate SSL/TLS on port 443.
* The Ingress controller will forward traffic to port 80 on the Pod in the Rancher Deployment.
![Rancher HA]({{< baseurl >}}/img/rancher/ha/rancher2ha.svg)
@@ -29,7 +29,12 @@ The following CLI tools are required for this install. Please make sure these to
## Installation Outline
1. [Create Nodes and Load Balancer](create-nodes-and-load-balancer/)
1. [Create Nodes and Load Balancer](create-nodes-lb/)
1. [Install Kubernetes with RKE](install-kubernetes-rke/)
1. [Initialize Helm (tiller)](helm-install/)
1. [Install Rancher](rancher-install/)
1. [Initialize Helm (tiller)](helm-init/)
1. [Install Rancher](helm-rancher-install/)
## Additional Install Options
* [Migrating from RKE all-in-one install](migrating-from-rke-all-in-one/)
* [RKE all-in-one install](rke-all-in-one/)
@@ -27,30 +27,11 @@ Collect the SSH credentials and DNS or IP addresses for your nodes to provide to
#### Ports
##### Cluster External Ports
These are ports that should be open between nodes and the external network for communication and management of Rancher.
| Protocol | Ports | Description |
| --- | --- | --- |
| tcp | 22 | SSH for RKE install |
| tcp | 80 | ingress controller - redirect to https |
| tcp | 443 | ingress controller - https traffic to Rancher |
| tcp | 6443 | https to kube-api, used by kubectl and helm |
| tcp | 30000 - 32767 | Kubernetes NodePorts for k8s workloads |
{{< requirements_ports_rancher_rke >}}
<br/>
##### Additional Ports Required Between Rancher Cluster Nodes
In addition to the ports listed above these ports must be open between nodes.
| Protocol | Ports | Description |
| --- | --- | --- |
| tcp | 2379-2380 | etcd |
| udp | 8472 | overlay networking |
| tcp | 10250 | kubelet |
<br/>
If you block ports internally on the nodes see the full [ports list]({{< baseurl >}}/rancher/v2.x/en/installation/references/) for all the communication details.
### Load Balancer
@@ -65,4 +65,4 @@ helm init --service-account tiller
> NOTE: This `tiller` install has full cluster access, which should be acceptable if the cluster is dedicated to Rancher server. Check out the [helm docs](https://docs.helm.sh/using_helm/#role-based-access-control) for restricting `tiller` access to suit your security requirements.
### [Next: Install Rancher](../rancher-install/)
### [Next: Install Rancher](../helm-rancher-install/)
@@ -21,6 +21,8 @@ weight: 276
| --- | --- | --- |
| `debug` | false | `bool` - set debug flag on rancher server |
| `imagePullSecrets` | [] | `list` - list of names of Secret resource containing private registry credentials |
| `proxy` | "" | `string` - string - HTTP[S] proxy server for Rancher |
| `noProxy` | "localhost,127.0.0.1" | `string` - comma seperated list of hostnames or ip address not to use the proxy |
| `resources` | {} | `map` - rancher pod resource requests & limits |
| `rancherImage` | "rancher/rancher" | `string` - rancher image source |
| `rancherImageTag` | same as chart version | `string` - rancher/rancher image tag |
@@ -81,4 +81,4 @@ You will need to save a copy of the `kube_config_rancher-cluster.yml` and `ranch
See the [Troubleshooting](troubleshooting/) page.
### [Next: Initialize Helm](../helm-install/)
### [Next: Initialize Helm](../helm-init/)
@@ -52,5 +52,5 @@ kubectl -n cattle-system delete serviceaccount cattle-admin
From here follow the standard install steps.
* [3 - Initialize Helm (Install tiller)](../3-helm-install/)
* [4 - Install Rancher](../4-rancher-install/)
* [3 - Initialize Helm (Install tiller)](../helm-init/)
* [4 - Install Rancher](../helm-rancher-install/)
@@ -5,6 +5,6 @@ weight: 276
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.
* [High Availability Installation with External Load Balancer (TCP/Layer 4)](./ha-server-install/)
* [High Availability Installation with External Load Balancer (HTTPS/Layer 7)](./ha-server-install-external-lb)
* [Troubleshooting RKE All-In-One Installs](./troubleshooting-ha)
* [High Availability Installation with External Load Balancer (TCP/Layer 4)](install-layer-4-lb/)
* [High Availability Installation with External Load Balancer (HTTPS/Layer 7)](install-layer-7-lb/)
* [Troubleshooting RKE All-In-One Installs](troubleshooting/)
@@ -0,0 +1,57 @@
<div>
<h5>Cluster External Ports</h5>
<p>These ports should be open between nodes and the external network for communication and management of Rancher.</p>
<table>
<tr>
<th>Protocol</th>
<th>Port</th>
<th>Description</th>
</tr>
<tr>
<td>TCP</td>
<td>22</td>
<td>SSH for RKE</td>
</tr>
<tr>
<td>TCP</td>
<td>80</td>
<td>Ingress controller - redirect to HTTPS</td>
</tr>
<tr>
<td>TCP</td>
<td>443</td>
<td>Ingress controller - HTTPS traffic to Rancher</td>
</tr>
<tr>
<td>TCP</td>
<td>6443</td>
<td>HTTPS to kube-api, used by kubectl and helm</td>
</tr>
</tr>
</table>
<br/><br/>
<h5>Additional Ports Required Between Rancher Cluster Nodes</h5>
<p>In addition to the ports listed above these ports must be open between nodes.</p>
<table>
<tr>
<th>Protocol</th>
<th>Port</th>
<th>Description</th>
</tr>
<tr>
<td>TCP</td>
<td>2379-2380</td>
<td>etcd</td>
</tr>
<tr>
<td>udp</td>
<td>8472</td>
<td>Overlay networking</td>
</tr>
<tr>
<td>TCP</td>
<td>10250</td>
<td>kubelet</td>
</tr>
</table>
</div>