public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-05-30 08:35:32 +00:00
Code Issues Packages Projects Releases Wiki Activity

Reorganize node requirements

Browse Source
This commit is contained in:
Catherine Luse
2021-01-07 09:32:49 -07:00
parent 86671f4d2b 1e119cfad0
commit 5e12d039f3
2 changed files with 26 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/rancher/v2.x/en/installation/requirements/_index.md
+23 -27
View File
@@ -25,38 +25,12 @@ The Rancher UI works best in Firefox or Chrome.
# Operating Systems and Container Runtime Requirements
The node requirements depend on how Rancher is installed.
### Requirements for Installing Rancher on an RKE Kubernetes Cluster with the Helm CLI
Rancher should work with any modern Linux distribution.
For details on which OS and Docker versions were tested with each Rancher version, refer to the [support maintenance terms.](https://rancher.com/support-maintenance-terms/)
RKE should work with any modern Docker version, while K3s should work with any modern version of Docker or containerd.
### Requirements for Installing Rancher with RancherD
_The RancherD install is available as of v2.5.4. It is an experimental feature._
At this time, only Linux OSes that leverage systemd are supported.
To install RancherD on SELinux Enforcing CentOS 8 or RHEL 8 nodes, some [additional steps](#rancherd-on-selinux-enforcing-centos-8-or-rhel-8-nodes) are required.
Docker is not required for RancherD installs.
### Requirements for Installing Rancher on a K3s Kubernetes Cluster
K3s should run on just about any flavor of Linux.
Docker is required for nodes that will run K3s or RKE Kubernetes clusters. It is not required for RancherD installs.
For details on which OS and Docker versions were tested with each Rancher version, refer to the [support maintenance terms.](https://rancher.com/support-maintenance-terms/)
If you are installing Rancher on a K3s cluster with **Raspbian Buster**, follow [these steps]({{<baseurl>}}/k3s/latest/en/advanced/#enabling-legacy-iptables-on-raspbian-buster) to switch to legacy iptables.
If you are installing Rancher on a K3s cluster with Alpine Linux, follow [these steps]({{<baseurl>}}/k3s/latest/en/advanced/#additional-preparation-for-alpine-linux-setup) for additional setup.
### General Linux Requirements
All supported operating systems are 64-bit x86.
The `ntp` (Network Time Protocol) package should be installed. This prevents errors with certificate validation that can occur when the time is not synchronized between the client and server.
@@ -65,6 +39,28 @@ Some distributions of Linux may have default firewall rules that block communica
If you plan to run Rancher on ARM64, see [Running on ARM64 (Experimental).]({{<baseurl>}}/rancher/v2.x/en/installation/options/arm64-platform/)
### RKE Specific Requirements
For the container runtime, RKE should work with any modern Docker version.
### K3s Specific Requirements
For the container runtime, K3s should work with any modern version of Docker or containerd.
If you are installing Rancher on a K3s cluster with **Raspbian Buster**, follow [these steps]({{<baseurl>}}/k3s/latest/en/advanced/#enabling-legacy-iptables-on-raspbian-buster) to switch to legacy iptables.
If you are installing Rancher on a K3s cluster with Alpine Linux, follow [these steps]({{<baseurl>}}/k3s/latest/en/advanced/#additional-preparation-for-alpine-linux-setup) for additional setup.
### RancherD Specific Requirements
_The RancherD install is available as of v2.5.4. It is an experimental feature._
At this time, only Linux OSes that leverage systemd are supported.
To install RancherD on SELinux Enforcing CentOS 8 or RHEL 8 nodes, some [additional steps](#rancherd-on-selinux-enforcing-centos-8-or-rhel-8-nodes) are required.
Docker is not required for RancherD installs.
### Installing Docker
Docker is required for Helm chart installs, and it can be installed by following the steps in the official [Docker documentation.](https://docs.docker.com/) Rancher also provides [scripts]({{<baseurl>}}/rancher/v2.x/en/installation/requirements/installing-docker) to install Docker with one command.
scripts/dev
+3 -1
View File
@@ -5,6 +5,7 @@ PORT=9001
IMAGE=rancher/docs
TAG=dev
THEME=
WEBSITE=
BUILD_BUILD=
BUILD_DEV=
SKIP_PULL=
@@ -29,7 +30,8 @@ Usage:
-d - Build the dev image instead of pulling from the registry
-p PORT - Port to listen on
-s - Skip pulling build/dev images
-t DIR - Use DIR to for the theme, to devlop the theme at the same time
-t DIR - Use DIR to for the theme, to develop the theme at the same time
-w DIR - Use DIR to for the website, to set enableRobotsTXT to false locally in order to scan for broken links on local build
-u - Upload/push the build image after building
EOF