Add section and diagram about HA vs. single node architecture

This commit is contained in:
Catherine Luse committed 2019-12-11 14:15:14 -07:00
1 parent 9a70cc9791
commit 2e1ae133e5
2 files changed
+21 -2

No files matched your search

@@ -39,6 +39,22 @@ The figure below illustrates the high-level architecture of Rancher 2.x. The fig
In this section we describe the functionalities of each Rancher server components.
#### Single Node and High-Availability Installations of Rancher
You can install Rancher on a single node, or on a high-availability Kubernetes cluster.
A single-node installation is recommended for development and testing purposes, and a high-availability installation is recommended for production.
In a single-node installation of Rancher, the node running the Rancher server should be separate from your Kubernetes clusters.
In high-availability installations of Rancher, it is important to note the following:
- The Rancher server cluster should be separate from user clusters. A user cluster is a Kubernetes cluster that runs your apps and services.
- The Rancher server cluster and user clusters have separate requirements for hardware and networking. The requirements for the Rancher server can be found [here]({{<baseurl>}}/rancher/v2.x/en/installation/requirements) and the requirements for user clusters can be found [here.]({{<baseurl>}}/rancher/v2.x/en/cluster-provisioning/requirements})
- We recommend installing Rancher on a Kubernetes cluster in which each node has all three Kubernetes roles: etcd, controlplane, and worker. However, when you set up the clusters that run your apps and services, we recommend that each node in the cluster should have a single role for stability and scalability. For details on the recommended best practices for user clusters, refer to the [production checklist]({{<baseurl>}}/rancher/v2.x/en/cluster-provisioning/production) or our [best practices guide.]({{<baseurl>}}/rancher/v2.x/en/best-practices/management/#tips-for-scaling-and-reliability)
![Single Node vs. High-Availability Architecture]({{<baseurl>}}/img/rancher/rancher-single-node-and-ha-installations.svg)
#### Rancher API Server
Rancher API server is built on top of an embedded Kubernetes API server and etcd database. It implements the following functionalities:
@@ -51,11 +67,11 @@ Rancher API server is built on top of an embedded Kubernetes API server and etcd
Rancher API server manages access control and security policies.
- **Projects**
- **Managing Projects**
A _project_ is a group of multiple namespaces and access control policies within a cluster.
- **Nodes**
- **Tracking Nodes**
Rancher API server tracks identities of all the nodes in all clusters.
@@ -0,0 +1,3 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="832px" height="981px" viewBox="-0.5 -0.5 832 981" content="&lt;mxfile modified=&quot;2019-11-01T00:45:36.741Z&quot; host=&quot;www.draw.io&quot; agent=&quot;Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:69.0) Gecko/20100101 Firefox/69.0&quot; etag=&quot;Klj5mcDytWhPZJrjm053&quot; version=&quot;12.1.9&quot; type=&quot;device&quot; pages=&quot;2&quot;&gt;&lt;diagram id=&quot;0zUlRVDwpwrQQcOHNmZT&quot; name=&quot;rancher-api-server&quot;&gt;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&lt;/diagram&gt;&lt;diagram id=&quot;KWsfMyI1_liM6WYqyV4y&quot; name=&quot;two-architectures&quot;&gt;7V1rd5u4Fv01+ehZvB8fmzS9vTNtb+fmtjPTL3cRQ2wmBFyM06S/foQRNhgJZGOkY1CzVmNkXjn7SNra50i60m+eXv6Veqvlx8QPoitN8V+u9LdXmmbZCvo/L3gtCgzHLgoWaegXReq+4C78GeBCfN1iE/rBunZiliRRFq7qhfMkjoN5Vivz0jT5UT/tIYnqT115i6BRcDf3ombpH6GfLYtSx1T25e+DcLEsn6wq+JsnrzwZF6yXnp/8qBTpt1f6TZokWfHp6eUmiHLblXZJ7B/R+nZ9ffftP+7Pn9/+/Pr1j3ez4mbvjrlk9yekQZydfOv/b3592MzfrtTvXz5/+fb+vfmbeztTNYzmsxdtsMXwX5u9liZcpMlmhU8L0ix4IQHn3ZenK4yvq+5siHwvSJ6CLH1F1+G76/j22O308rY/9iDqLi5bVgDcnehhx1nsbr03DvqA7XOUrZxuW/1Yhllwt/Lm+fEPVKOu9Otl9oQe9FZFHx+SOLtJoiRFx3ESo5OuI+8+iK69+WNu5tg/+DZOPuTf48vXWZo8BuUpV5quKBb6l984jKJK+a2V/6ByKmxVeNpcowmQSARcAgJWlGHL1qCwvm+S8ovZetsuvUEnqNbqZf8l+rTIf9++eE8rdKGmfFkHKfr12+Y+SOMgQ02XptxEm3WWFxePuk/Ly8oS9NcUzy+LD7wCGT+rO0IdSQx2FURc5EXhIkaHcwQWegP9OocyRM3bG/zFU+j7+WOuSZ639aggN6kyjC/g+5RNVMU1NEtruoah9fcMYlui9fYLZAWCX9yF8WLrFp9Qv4h+/TteZ14UeVmYxOgweUD//deL58u9d4zIF05ott16s602W22N1GaYZ2gyiG+rD+QY79G7z948eyFqvsMozF6lc3Q7h6mJ8457P3rw1btH/3mmPS4/bX73PX2m6g0EAh/RR3yYpNkyWSSxF93uSw9stT/nQ5KsMGh/B1n2irmwt8mSOqTIhOnrn/n1v5jl4V/4dtuDty+1o9caLPkLngAK+iOTTToPWqxhFedlXroIspbzFDLIaZC7/nP95c4OmdXNwRBRX20tP8/yGkJ0+AocQ3m7plh1bye4u8HT26FSfbUcY76WhmsaSlUJdMIZylJKt6UukujT3aKV5vM1vtq7yyZz/F1XrNwF6fMo++Rj8C3H2TrqhGq1z2y2UmYTfn0o+BkG2UJaKUutt1KqK7qVIg2GR9tKOdBaKVIfcY5m6kPi+ehL1Hig9moiosMxiENtt1Sj4RD7HidXldaXjNAZ+K/DRn+HUw9Vs4HANEZ7m+9O/HOlWPPZ1/iD6X/569fHpJTMqqO9a+Pl7+/x98V8pt99/K7GdvAnFeSzj/YomFmCMbMlaMeDZkvQTgCNl65CAc2RrWMrZmSzKYZQ1HbBaVGoqbZaxW2m/KJYdgd426PPQRoiI+TsBRSiNi9A297yjKMKNB4ux2H7Qv3d9l9z9FGLe370+oU9936mdsuwu/SK/GCePIVz7BiNUabt3Lg373bflGkdWnPc6bqe7jnYRu+8pzDKXTBN7pOtR1eHv+hsXc1/SOx6kXp+GBw5Vh6KV+c1rsqrdZskRBCYtWUP1AoZDEqEGM2mLtkYLine truncated

After

Width:  |  Height:  |  Size: 84 KiB