From d99139d10bb9f489b641daf77955f776c8a006d8 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Mon, 31 Aug 2020 22:44:08 -0700 Subject: [PATCH] Discourage Docker installs --- .../other-installation-methods/_index.md | 18 +++++++++++------- .../air-gap/_index.md | 2 +- .../single-node-docker/_index.md | 6 ++++-- 3 files changed, 16 insertions(+), 10 deletions(-) diff --git a/content/rancher/v2.x/en/installation/other-installation-methods/_index.md b/content/rancher/v2.x/en/installation/other-installation-methods/_index.md index 868519c447c..b9e2266abf8 100644 --- a/content/rancher/v2.x/en/installation/other-installation-methods/_index.md +++ b/content/rancher/v2.x/en/installation/other-installation-methods/_index.md @@ -3,14 +3,18 @@ title: Other Installation Methods weight: 3 --- -### Docker Installations - -The [single-node Docker installation]({{}}/rancher/v2.x/en/installation/other-installation-methods/single-node-docker) is for Rancher users that are wanting to test out Rancher. Instead of running on a Kubernetes cluster using Helm, you install the Rancher server component on a single node using a `docker run` command. - -Since there is only one node and a single Docker container, if the node goes down, there is no copy of the etcd data available on other nodes and you will lose all the data of your Rancher server. - ### Air Gapped Installations Follow [these steps]({{}}/rancher/v2.x/en/installation/other-installation-methods/air-gap) to install the Rancher server in an air gapped environment. -An air gapped environment could be where Rancher server will be installed offline, behind a firewall, or behind a proxy. \ No newline at end of file +An air gapped environment could be where Rancher server will be installed offline, behind a firewall, or behind a proxy. + +### Docker Installations + +The [single-node Docker installation]({{}}/rancher/v2.x/en/installation/other-installation-methods/single-node-docker) is for Rancher users that are wanting to test out Rancher. Instead of running on a Kubernetes cluster using Helm, you install the Rancher server component on a single node using a `docker run` command. + +The Docker installation is for development and testing environments only. + +Since there is only one node and a single Docker container, if the node goes down, there is no copy of the etcd data available on other nodes and you will lose all the data of your Rancher server. + +When the Rancher server is installed with Docker, it cannot be migrated to a Kubernetes cluster for a production environment. diff --git a/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/_index.md b/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/_index.md index fb264adc5e9..2c4d94963b6 100644 --- a/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/_index.md +++ b/content/rancher/v2.x/en/installation/other-installation-methods/air-gap/_index.md @@ -1,6 +1,6 @@ --- title: Installing Rancher in an Air Gapped Environment -weight: 3 +weight: 1 aliases: - /rancher/v2.x/en/installation/air-gap-installation/ - /rancher/v2.x/en/installation/air-gap-high-availability/ diff --git a/content/rancher/v2.x/en/installation/other-installation-methods/single-node-docker/_index.md b/content/rancher/v2.x/en/installation/other-installation-methods/single-node-docker/_index.md index 97e9673c322..56890fe07da 100644 --- a/content/rancher/v2.x/en/installation/other-installation-methods/single-node-docker/_index.md +++ b/content/rancher/v2.x/en/installation/other-installation-methods/single-node-docker/_index.md @@ -1,14 +1,16 @@ --- title: Installing Rancher on a Single Node Using Docker description: For development and testing environments only, use a Docker install. Install Docker on a single Linux host, and deploy Rancher with a single Docker container. -weight: 1 +weight: 2 aliases: - /rancher/v2.x/en/installation/single-node-install/ - /rancher/v2.x/en/installation/single-node - /rancher/v2.x/en/installation/other-installation-methods/single-node --- -For development and testing environments only, Rancher can be installed by running a single Docker container. +> The Docker installation is for development and testing environments only. When the Rancher server is installed with Docker, it cannot be migrated to a Kubernetes cluster for a production environment. + +Rancher can be installed by running a single Docker container. In this installation scenario, you'll install Docker on a single Linux host, and then deploy Rancher on your host using a single Docker container.