From 7113cda9f7a29eea7598d3b9da2579c1a7214e3e Mon Sep 17 00:00:00 2001 From: Mark Bishop Date: Thu, 26 Apr 2018 19:30:40 -0700 Subject: [PATCH] unshelving new install files and deleting old ones --- .../server-installation/container-install.md | 37 +++++++++++++++++++ ...-availability.md => kubernetes-install.md} | 28 ++++++++++---- .../single-node-installs.md | 25 ------------- 3 files changed, 57 insertions(+), 33 deletions(-) create mode 100644 content/rancher/installation/server-installation/container-install.md rename content/rancher/installation/server-installation/{high-availability.md => kubernetes-install.md} (97%) delete mode 100644 content/rancher/installation/server-installation/single-node-installs.md diff --git a/content/rancher/installation/server-installation/container-install.md b/content/rancher/installation/server-installation/container-install.md new file mode 100644 index 00000000000..ca2095d324d --- /dev/null +++ b/content/rancher/installation/server-installation/container-install.md @@ -0,0 +1,37 @@ +--- +title: Single Node Installation +layout: single-docs +weight: 250 +--- + +# Installing Rancher Using a Docker Container + +## Provision Linux Host + +Provision a single Linux host to use as a template to launch your {{< product >}}. + +### Requirements + +{{< requirements_os >}} + +{{< requirements_hardware >}} + +{{< requirements_software >}} + +## Install Rancher + +Installing Rancher on a Linux host using a single Docker container is simple. Simply connect to your host and run the command below. + +1. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. + +2. From your shell, enter the following command: + + ``` + $ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher + ``` + + >**Note:** + >- `rancher/rancher` is hosted on DockerHub. If you don't have access to DockerHub, or you are installing Rancher without an internet connection, refer to {{< ref "private-registries" >}}. + >- For a list of other Rancher server tags available, refer to {{< ref "server-tags" >}}. + +**Result:** Rancher is installed. diff --git a/content/rancher/installation/server-installation/high-availability.md b/content/rancher/installation/server-installation/kubernetes-install.md similarity index 97% rename from content/rancher/installation/server-installation/high-availability.md rename to content/rancher/installation/server-installation/kubernetes-install.md index af782b04cd9..fc86eddd209 100644 --- a/content/rancher/installation/server-installation/high-availability.md +++ b/content/rancher/installation/server-installation/kubernetes-install.md @@ -1,21 +1,32 @@ --- -title: High-Availability Installation +title: Installing Rancher in a Kubernetes Cluster layout: single-docs weight: 275 --- -# High-Availability Installation
(i.e. Multi-Node Installation) +# Installing Rancher in a Kubernetes Cluster In high-availability installations, Rancher is installed on multiple nodes of a Kubernetes cluster. This multi-node configuration ensures that Rancher server is always available, even if your primary Rancher server goes down. ## Provision Linux Hosts -1. Provision a minimum of three Linux hosts according to our {{ ref "server-requirements.md" }} -2. Add the hosts to your Domain Name System (DNS)—each host requires a fully qualified domain name (FQDN) for something you'll be doing later. +Provision a minimum of three Linux hosts. Use the requirements below. + +### Requirements + +{{< requirements_os >}} + +{{< requirements_hardware >}} + +{{< requirements_software >}} + +{{< requirements_ports >}} + +{{< requirements_ha >}} ## Get RKE -Rancher Kubernetes Engine (RKE) is a fast, versatile Kubernetes installe you can use to install Kubernetes on your Linux hosts. You can download RKE from GitHub. +Rancher Kubernetes Engine (RKE) is a fast, versatile Kubernetes installer you can use to install Kubernetes on your Linux hosts. You can download RKE from GitHub. 1. From your workstation, open a web browser and navigate to [https://github.com/rancher/rke/releases](https://github.com/rancher/rke/releases). Download the latest RKE installer. @@ -60,21 +71,21 @@ Once you have a template, customize it to suit your needs. ``` nodes: - - address: 159.65.99.240 + - address: user: root role: - controlplane - etcd - worker ssh_key_path: /home/user/.ssh/id_rsa #PATH TO PUBLIC KEY, I.E. PEM FILE - - address: 206.189.168.116 + - address: user: root role: - controlplane - etcd - worker ssh_key_path: /home/user/.ssh/id_rsa #PATH TO PUBLIC KEY, I.E. PEM FILE - - address: 206.189.168.31 + - address: user: root role: - controlplane @@ -138,6 +149,7 @@ Once you have a template, customize it to suit your needs. - `` - `` + **Example:** ``` diff --git a/content/rancher/installation/server-installation/single-node-installs.md b/content/rancher/installation/server-installation/single-node-installs.md deleted file mode 100644 index 7a7f9aaf579..00000000000 --- a/content/rancher/installation/server-installation/single-node-installs.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Single Node Installation -layout: single-docs -weight: 250 ---- - -# Single-Node Installation - -## Option 1: Single Container Install - -Installing Rancher on a Linux host using a single Docker container is simple. Simply connect to your host and run the command below. - -1. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. - -2. From your shell, enter the following command: - - ``` - $ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher - ``` - -**Result:** Rancher is installed. - -## Option 2: Single Container Install with etcd - -## Option 3: Local Cluster Install