From b14f0b0421fb8c0fded4537fdfdbf86e6fe323b5 Mon Sep 17 00:00:00 2001 From: catherineluse Date: Tue, 10 Dec 2019 15:47:27 -0700 Subject: [PATCH] Remove specific OS/Docker versions from Rancher installation docs --- .../node-requirements/_index.md | 30 +++++++++---------- .../en/installation/requirements/_index.md | 15 +++------- 2 files changed, 19 insertions(+), 26 deletions(-) diff --git a/content/rancher/v2.x/en/cluster-provisioning/node-requirements/_index.md b/content/rancher/v2.x/en/cluster-provisioning/node-requirements/_index.md index ec4b79da8b9..be5fdfe6cf5 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/node-requirements/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/node-requirements/_index.md @@ -17,28 +17,28 @@ Make sure the nodes for the Rancher server fulfill the following requirements: # Operating Systems and Docker Requirements -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/all-supported-versions/rancher-v2.3.0/) +Rancher should work with any modern Linux distribution and any modern Docker version. Linux is required for the etcd and controlplane nodes of all downstream clusters. Worker nodes may run Linux or [Windows Server.](#requirements-for-windows-nodes) The capability to use Windows worker nodes in downstream clusters was added in Rancher v2.3.0. + +Rancher works has been tested with downstream clusters running Ubuntu, CentOS, Oracle Linux, RancherOS, and RedHat Enterprise Linux. 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/all-supported-versions/rancher-v2.3.0/) All supported operating systems are 64-bit x86. -Operating System | Version | Tested Docker Versions ----------------------|----------|---------------- -**CentOS** | 7.5, 7.6, 7.7 | Docker 17.03.2, 18.06.2, 18.09.x, 19.03.x -**Oracle Linux*** | 7.7 | Docker 19.03.x -**RancherOS** | 1.5.4 | Docker 17.03.2, 18.06.2, 18.09.x (up to 18.09.8), 19.03.x -**Red Hat Enterprise Linux (RHEL)*** | 7.7 | RHEL Docker 1.13.x, Docker 17.03.2, 18.06.2, 18.09.x, 19.03.x -**Ubuntu** | 16.04 | Docker 17.03.x, 18.06.x, 18.09.x, 19.03.x -**Ubuntu** | 18.04 | Docker 18.06.x, 18.09.x, 19.03.x -**Windows Server** | 1809, 1903 | Docker 18.09.x (1809), 19.03.x (1903). Requires Docker Engine - Enterprise Edition (EE).** - -\* Some distributions of Linux derived from RHEL, including Oracle Linux, may have default firewall rules that block communication with Helm. This [how-to guide]({{}}/rancher/v2.x/en/installation/options/firewall) shows how to check the default firewall rules and how to open the ports with `firewalld` if necessary. - -\** Nodes with Windows Server core version 1809 should use Docker EE-basic 18.09 (1809) or Docker EE-basic 19.03 (1903). Nodes with Windows Server core version 1903 should use Docker EE-basic 19.03. Supported for worker nodes only. See [Configuring Custom Clusters for Windows]({{}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/windows-clusters/) - If you plan to use ARM64, see [Running on ARM64 (Experimental).]({{}}/rancher/v2.x/en/installation/arm64-platform/) For information on how to install Docker, refer to the offical [Docker documentation.](https://docs.docker.com/) +> **Note:** Some distributions of Linux derived from RHEL, including Oracle Linux, may have default firewall rules that block communication with Helm. This [how-to guide]({{}}/rancher/v2.x/en/installation/options/firewall) shows how to check the default firewall rules and how to open the ports with `firewalld` if necessary. + +### Requirements for Windows Nodes + +_Windows worker nodes can be used as of Rancher v2.3.0_ + +Nodes with Windows Server core version 1809 should use Docker EE-basic 18.09 (1809) or Docker EE-basic 19.03 (1903). + +Nodes with Windows Server core version 1903 should use Docker EE-basic 19.03. + +Windows nodes can be used for worker nodes only. See [Configuring Custom Clusters for Windows]({{}}/rancher/v2.x/en/cluster-provisioning/rke-clusters/windows-clusters/) + # Hardware Requirements The hardware requirements for nodes with the `worker` role mostly depend on your workloads. The minimum to run the Kubernetes node components is 1 CPU (core) and 1GB of memory. diff --git a/content/rancher/v2.x/en/installation/requirements/_index.md b/content/rancher/v2.x/en/installation/requirements/_index.md index a2ebb9956ba..c31ed07a256 100644 --- a/content/rancher/v2.x/en/installation/requirements/_index.md +++ b/content/rancher/v2.x/en/installation/requirements/_index.md @@ -24,22 +24,15 @@ For a list of best practices that we recommend for running the Rancher server in # Operating Systems and Docker Requirements -The Rancher server is tested on the following operating systems and their subsequent non-major releases with a supported version of [Docker](https://www.docker.com/). +Rancher should work with any modern Linux distribution and any modern Docker version. + +Rancher has been tested with Ubuntu, CentOS, Oracle Linux, RancherOS, and RedHat Enterprise Linux. 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/all-supported-versions/rancher-v2.3.0/) All supported operating systems are 64-bit x86. -Operating System | Version | Tested Docker Versions ----------------------|----------|---------------- -**CentOS** | 7.5, 7.6, 7.7 | Docker 17.03.2, 18.06.2, 18.09.x, 19.03.x -**Oracle Linux*** | 7.7 | Docker 19.03.x -**RancherOS** | 1.5.4 | Docker 17.03.2, 18.06.2, 18.09.x (up to 18.09.8), 19.03.x -**Red Hat Enterprise Linux (RHEL)*** | 7.7 | RHEL Docker 1.13.x, Docker 17.03.2, 18.06.2, 18.09.x, 19.03.x -**Ubuntu** | 16.04 | Docker 17.03.x, 18.06.x, 18.09.x, 19.03.x -**Ubuntu** | 18.04 | Docker 18.06.x, 18.09.x, 19.03.x - -\* Some distributions of Linux derived from RHEL, including Oracle Linux, may have default firewall rules that block communication with Helm. This [how-to guide]({{}}/rancher/v2.x/en/installation/options/firewall) shows how to check the default firewall rules and how to open the ports with `firewalld` if necessary. +> **Note:** Some distributions of Linux derived from RHEL, including Oracle Linux, may have default firewall rules that block communication with Helm. This [how-to guide]({{}}/rancher/v2.x/en/installation/options/firewall) shows how to check the default firewall rules and how to open the ports with `firewalld` if necessary. If you plan to run Rancher on ARM64, see [Running on ARM64 (Experimental).]({{}}/rancher/v2.x/en/installation/arm64-platform/)