diff --git a/content/rancher/v2.x/en/installation/_index.md b/content/rancher/v2.x/en/installation/_index.md index bcb93810982..1c6f3ecf56f 100644 --- a/content/rancher/v2.x/en/installation/_index.md +++ b/content/rancher/v2.x/en/installation/_index.md @@ -10,7 +10,7 @@ This section contains instructions for installing Rancher in development and pro Install Rancher on a single Linux host. -- [High Availability Installation](ha-server-install/) +- [High Availability Installation](ha-server-install-helm/) This install scenario creates a new Kubernetes cluster dedicated to running Rancher Server in a high-availability (HA) configuration. diff --git a/content/rancher/v2.x/en/installation/ha-server-install/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/_index.md similarity index 96% rename from content/rancher/v2.x/en/installation/ha-server-install/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/_index.md index 84e8627571a..b61fc421174 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/_index.md @@ -30,6 +30,6 @@ The following CLI tools are required for this install. Please make sure these to ## Installation Outline 1. [Create Nodes and Load Balancer](create-nodes-and-load-balancer/) -1. [Install Kubernetes with RKE](install-kubernetese-rke/) +1. [Install Kubernetes with RKE](install-kubernetes-rke/) 1. [Initialize Helm (tiller)](helm-install/) 1. [Install Rancher](rancher-install/) diff --git a/content/rancher/v2.x/en/installation/ha-server-install/create-nodes-and-load-balancer/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/create-nodes-and-load-balancer/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/create-nodes-and-load-balancer/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/create-nodes-and-load-balancer/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/create-nodes-and-load-balancer/nlb/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/create-nodes-and-load-balancer/nlb/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/create-nodes-and-load-balancer/nlb/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/create-nodes-and-load-balancer/nlb/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/helm-install/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/helm-install/_index.md similarity index 96% rename from content/rancher/v2.x/en/installation/ha-server-install/helm-install/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/helm-install/_index.md index d806c58e947..5b5192d6675 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/helm-install/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/helm-install/_index.md @@ -21,7 +21,7 @@ kubectl create clusterrolebinding tiller --clusterrole cluster-admin --serviceac
Additional steps for Air Gap/Private Registry

-If you have an Air Gapped network extra configuration will be required. +If you have an Air Gapped network you will need the tiller image available in your private registry. ##### Create registry secret diff --git a/content/rancher/v2.x/en/installation/ha-server-install/install-kubernetes-rke/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/install-kubernetes-rke/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/install-kubernetes-rke/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/install-kubernetes-rke/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/install-kubernetes-rke/troubleshooting/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/install-kubernetes-rke/troubleshooting/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/install-kubernetes-rke/troubleshooting/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/install-kubernetes-rke/troubleshooting/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/migrating-from-rke-all-in-one-install/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/migrating-from-rke-all-in-one-install/_index.md similarity index 95% rename from content/rancher/v2.x/en/installation/ha-server-install/migrating-from-rke-all-in-one-install/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/migrating-from-rke-all-in-one-install/_index.md index f64b13048e6..b79def6577d 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/migrating-from-rke-all-in-one-install/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/migrating-from-rke-all-in-one-install/_index.md @@ -31,14 +31,14 @@ kubectl -n cattle-system get secret cattle-keys-ingress -o jsonpath --template=' If you specified a private CA root cert ``` -kubectl -n cattle-system get secret cattle-keys-server -o jsonpath --template='{ .data.cacerts\.pem }' | base64 -d > tls.crt +kubectl -n cattle-system get secret cattle-keys-server -o jsonpath --template='{ .data.cacerts\.pem }' | base64 -d > cacerts.pem ``` ### Remove previous Kubernetes objects Remove the kubernetes objects created by the RKE install. -> NOTE: Removing these Kubernetes components will not affect the Rancher configuration or database, but with any maintenance it is a good idea to create a backup of the data before hand. See [Creating Backups-HA Install]({{< baseurl >}}/rancher/v2.x/en/backups/ha-backups) for details. +> NOTE: Removing these Kubernetes components will not affect the Rancher configuration or database, but with any maintenance it is a good idea to create a backup of the data before hand. See [Creating Backups-HA Install]({{< baseurl >}}/rancher/v2.x/en/backups/backups/ha-backups) for details. ``` kubectl -n cattle-system delete ingress cattle-ingress-http diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rancher-install/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/_index.md similarity index 97% rename from content/rancher/v2.x/en/installation/ha-server-install/rancher-install/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/_index.md index 2fae0a6fae5..44589fdf7d7 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rancher-install/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/_index.md @@ -84,6 +84,7 @@ Now that Rancher is running, see [Adding TLS Secrets](tls-secrets/) to publish t The Rancher chart configuration has many options for customizing the install to suit your specific environment. Here are some common advanced scenarios. * [Private Docker Image Registry/Air Gap Network](chart-options/#private-or-air-gap-registry) +* [TLS Termination on an External Load Balancer](chart-options/#external-tls-termination) See the [Chart Options](chart-options/) for the full list of options. diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rancher-install/chart-options/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/chart-options/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/rancher-install/chart-options/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/chart-options/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rancher-install/tls-secrets/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/tls-secrets/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/rancher-install/tls-secrets/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/tls-secrets/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rancher-install/troubleshooting/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/troubleshooting/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/rancher-install/troubleshooting/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rancher-install/troubleshooting/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/_index.md similarity index 100% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/_index.md diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/_index.md similarity index 98% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/_index.md index 868ce25ae97..b48e1dca8ee 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/_index.md @@ -1,6 +1,8 @@ --- title: High Availability Installation with External Load Balancer (HTTPS/Layer 7) weight: 276 +aliases: +- /rancher/v2.x/en/installation/ha-server-install-external-lb/ --- This set of instructions creates a new Kubernetes cluster that's dedicated to running Rancher in a high-availability (HA) configuration. This procedure walks you through setting up a 3-node cluster using the Rancher Kubernetes Engine (RKE). The cluster's sole purpose is running pods for Rancher. The setup is based on: @@ -105,8 +107,8 @@ Health checks can be executed on the `/healthz` endpoint of the node, this will We have example configurations for the following load balancers: -* [Amazon ALB configuration]({{< baseurl >}}/rancher/v2.x/en/installation/ha-server-install-external-lb/alb) -* [NGINX configuration]({{< baseurl >}}/rancher/v2.x/en/installation/ha-server-install-external-lb/nginx) +* [Amazon ALB configuration](alb/) +* [NGINX configuration](nginx/) ## 3. Configure DNS @@ -327,7 +329,7 @@ During installation, RKE automatically generates a config file named `kube_confi You have a couple of options: -- Create a backup of your Rancher Server in case of a disaster scenario: [High Availablility Back Up and Restoration]({{< baseurl >}}/rancher/v2.x/en/installation/backups-and-restoration/ha-backup-and-restoration). +- Create a backup of your Rancher Server in case of a disaster scenario: [High Availablility Back Up and Restoration]({{< baseurl >}}/rancher/v2.x/en/backups/ha-backups/). - Create a Kubernetes cluster: [Creating a Cluster]({{< baseurl >}}/rancher/v2.x/en/tasks/clusters/creating-a-cluster/).
diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/alb/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/alb/_index.md similarity index 97% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/alb/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/alb/_index.md index 424d35bdd3f..bc96496e99e 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/alb/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/alb/_index.md @@ -1,6 +1,8 @@ --- title: Amazon ALB configuration weight: 277 +aliases: +- /rancher/v2.x/en/installation/ha-server-install-external-lb/alb/ --- ## Objectives diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/nginx/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/nginx/_index.md similarity index 97% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/nginx/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/nginx/_index.md index 20579aa96b8..02e01d3960c 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install-external-lb/nginx/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install-external-lb/nginx/_index.md @@ -1,6 +1,8 @@ --- title: NGINX configuration weight: 277 +aliases: +- /rancher/v2.x/en/installation/ha-server-install-external-lb/nginx/ --- ## Install NGINX diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install/_index.md similarity index 99% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install/_index.md index efd0a46a5ec..188cfc6f909 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install/_index.md @@ -1,6 +1,8 @@ --- title: High Availability Installation with External Load Balancer (TCP/Layer 4) weight: 275 +aliases: +- /rancher/v2.x/en/installation/ha-server-install/ --- This set of instructions creates a new Kubernetes cluster that's dedicated to running Rancher in a high-availability (HA) configuration. This procedure walks you through setting up a 3-node cluster using the Rancher Kubernetes Engine (RKE). The cluster's sole purpose is running pods for Rancher. The setup is based on: @@ -425,7 +427,7 @@ During installation, RKE automatically generates a config file named `kube_confi You have a couple of options: -- Create a backup of your Rancher Server in case of a disaster scenario: [High Availablility Back Up and Restoration]({{< baseurl >}}/rancher/v2.x/en/installation/backups-and-restoration/ha-backup-and-restoration). +- Create a backup of your Rancher Server in case of a disaster scenario: [High Availablility Back Up and Restoration]({{< baseurl >}}/rancher/v2.x/en/installation/backups/restorations/ha-restoration). - Create a Kubernetes cluster: [Creating a Cluster]({{ }}/rancher/v2.x/en/tasks/clusters/creating-a-cluster/).
diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install/nlb/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install/nlb/_index.md similarity index 99% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install/nlb/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install/nlb/_index.md index bbdb1813d81..f2eebef4170 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/ha-server-install/nlb/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/ha-server-install/nlb/_index.md @@ -1,6 +1,8 @@ --- title: Amazon NLB configuration weight: 277 +aliases: +- /rancher/v2.x/en/installation/ha-server-install/nlb/ --- ## Objectives diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/404-default-backend/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/404-default-backend/_index.md similarity index 96% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/404-default-backend/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/404-default-backend/_index.md index 81140055fae..78bbfc446b6 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/404-default-backend/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/404-default-backend/_index.md @@ -1,6 +1,8 @@ --- title: 404 - default backend weight: 30 +aliases: +- /rancher/v2.x/en/installation/troubleshooting-ha/404-default-backend/ --- To debug issues around this error, you will need to download the command-line tool `kubectl`. See [Install and Set Up kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) how to download `kubectl` for your platform. diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/_index.md similarity index 55% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/_index.md index 00ce37f6927..7023eb3dfbe 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/_index.md @@ -1,24 +1,25 @@ --- title: Troubleshooting High Availability Installation weight: 370 +aliases: +- /rancher/v2.x/en/installation/troubleshooting-ha/ --- This section contains common errors seen when setting up a High Availability Installation. Choose from the following options: -- [Generic troubleshooting]({{< baseurl >}}/rancher/v2.x/en/installation/troubleshooting-ha/generic-troubleshooting) +- [Generic troubleshooting](generic-troubleshooting/) In this section, you can find generic ways to debug your Kubernetes cluster. -- [Failed to set up SSH tunneling for host]({{< baseurl >}}/rancher/v2.x/en/installation/troubleshooting-ha/ssh-tunneling) +- [Failed to set up SSH tunneling for host](ssh-tunneling/) In this section, you can find errors related to SSH tunneling when you run the `rke` command to setup your nodes. -- [Failed to get job complete status]({{< baseurl >}}/rancher/v2.x/en/installation/troubleshooting-ha/job-complete-status) +- [Failed to get job complete status](job-complete-status/) In this section, you can find errors related to deploying addons. -- [404 - default backend]({{< baseurl >}}/rancher/v2.x/en/installation/troubleshooting-ha/404-default-backend) +- [404 - default backend](404-default-backend/) In this section, you can find errors related to the `404 - default backend` page that is shown when trying to access Rancher. - diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/generic-troubleshooting/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/generic-troubleshooting/_index.md similarity index 98% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/generic-troubleshooting/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/generic-troubleshooting/_index.md index d1b696dfe42..5790d6a0c23 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/generic-troubleshooting/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/generic-troubleshooting/_index.md @@ -1,6 +1,8 @@ --- title: Generic troubleshooting -weight: 5 +weight: 5 +aliases: +- /rancher/v2.x/en/installation/troubleshooting-ha/generic-troubleshooting/ --- Below are steps that you can follow to determine what is wrong in your cluster. diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/job-complete-status/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/job-complete-status/_index.md similarity index 96% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/job-complete-status/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/job-complete-status/_index.md index 375a6387346..eaec014af2d 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/job-complete-status/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/job-complete-status/_index.md @@ -1,6 +1,8 @@ --- title: Failed to get job complete status weight: 20 +aliases: +- /rancher/v2.x/en/installation/troubleshooting-ha/job-complete-status/ --- To debug issues around this error, you will need to download the command-line tool `kubectl`. See [Install and Set Up kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) how to download `kubectl` for your platform. diff --git a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/ssh-tunneling/_index.md b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/ssh-tunneling/_index.md similarity index 97% rename from content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/ssh-tunneling/_index.md rename to content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/ssh-tunneling/_index.md index ee6573f52ed..d9e2d477628 100644 --- a/content/rancher/v2.x/en/installation/ha-server-install/rke-all-in-one-install/troubleshooting-ha/ssh-tunneling/_index.md +++ b/content/rancher/v2.x/en/installation/ha-server-install-helm/rke-all-in-one-install/troubleshooting-ha/ssh-tunneling/_index.md @@ -1,6 +1,8 @@ --- title: Failed to set up SSH tunneling for host weight: 10 +aliases: +- /rancher/v2.x/en/installation/troubleshooting-ha/ssh-tunneling/ --- ### Failed to set up SSH tunneling for host [xxx.xxx.xxx.xxx]: Can't retrieve Docker Info diff --git a/content/rancher/v2.x/en/installation/single-node-install/_index.md b/content/rancher/v2.x/en/installation/single-node-install/_index.md index eb24c5085a3..feefc33e4b8 100644 --- a/content/rancher/v2.x/en/installation/single-node-install/_index.md +++ b/content/rancher/v2.x/en/installation/single-node-install/_index.md @@ -4,11 +4,8 @@ weight: 250 --- For development environments, we recommend installing Rancher by running a single Docker container. In this installation scenario, you'll install Docker on a single Linux host, and then install Rancher on your host using a single Docker container. - >**Want to use an external load balancer?** -> See [Single Node Installation with an External Load Balancer]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install-external-lb) instead. - - +> See [Single Node Installation with an External Load Balancer](advanced-install-options/single-node-install-external-lb) instead. ## Installation Outline @@ -28,15 +25,15 @@ Provision a single Linux host to launch your {{< product >}} Server. ### Requirements -#### Operating System +#### Operating System {{< requirements_os >}} -#### Hardware +#### Hardware {{< requirements_hardware >}} -#### Software +#### Software {{< requirements_software >}} @@ -81,8 +78,6 @@ If you install Rancher without using your own certificate, Rancher generates a s rancher/rancher:latest ``` - - ### Option B—Bring Your Own Certificate: Self-Signed Your Rancher install can use a self-signed certificate that you provide to encrypt communications. @@ -93,7 +88,6 @@ Your Rancher install can use a self-signed certificate that you provide to encry >- The certificate files must be in [PEM format](#pem). >- In your certificate file, include all intermediate certificates in the chain. Order your certificates with your certificate first, followed by the intermediates. For an example, see [SSL FAQ / Troubleshooting](#cert-order). - **To Install Rancher Using a Self-Signed Cert:** Your Rancher install can use a self-signed certificate that you provide to encrypt communications. @@ -163,7 +157,6 @@ Run the following commands from your Linux host. --acme-domain rancher.mydomain.com ``` - > >**Remember:** Let's Encrypt provides rate limits for requesting new certificates. Therefore, limit how often you create or destroy the container. For more information, see [Let's Encrypt documentation on rate limits](https://letsencrypt.org/docs/rate-limits/). @@ -199,4 +192,3 @@ docker run -d --restart=unless-stopped \ -p 8080:80 -p 8443:443 \ rancher/rancher:latest ``` - diff --git a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/_index.md b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/_index.md index c221c221a90..a2e251d49c4 100644 --- a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/_index.md +++ b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/_index.md @@ -1,4 +1,8 @@ --- title: Advanced Install Options weight: 250 ---- \ No newline at end of file +--- + +* [Air Gap Installation](air-gap-installation) +* [HTTP/S Proxy Configuration](proxy-configuration) +* [Using an External Load Balancer](single-node-install-external-lb) \ No newline at end of file diff --git a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/air-gap-installation/_index.md b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/air-gap-installation/_index.md index a65c2d4614e..df38b9ca48a 100644 --- a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/air-gap-installation/_index.md +++ b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/air-gap-installation/_index.md @@ -1,6 +1,8 @@ --- title: Air Gap Installation weight: 345 +aliases: +- /rancher/v2.x/en/installation/air-gap-installation/ --- Rancher supports installing from a private registry. In every [release](https://github.com/rancher/rancher/releases), we provide you with the needed Docker images and scripts to mirror those images to your own registry. The Docker images are used when nodes are added to a cluster, or when you enable features like pipelines or logging. diff --git a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/proxy-configuration/_index.md b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/proxy-configuration/_index.md index 4656ad38022..79572a0274d 100644 --- a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/proxy-configuration/_index.md +++ b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/proxy-configuration/_index.md @@ -1,6 +1,8 @@ --- title: Rancher HTTP Proxy Configuration weight: 360 +aliases: +- /rancher/v2.x/en/installation/proxy-configuration/ --- If you operate Rancher behind a proxy and you need to reach the Internet to perform tasks (such as using Helm catalogs), you must provide Rancher information about your proxy. diff --git a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/single-node-install-external-lb/_index.md b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/single-node-install-external-lb/_index.md index 54eeed48a4f..cdd34be43a5 100644 --- a/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/single-node-install-external-lb/_index.md +++ b/content/rancher/v2.x/en/installation/single-node-install/advanced-install-options/single-node-install-external-lb/_index.md @@ -1,6 +1,8 @@ --- title: Single Node Installation with External Load Balancer weight: 260 +aliases: +- /rancher/v2.x/en/installation/single-node-install-external-lb/ --- For development environments, we recommend installing Rancher by running a single Docker container. In this installation scenario, you'll deploy Rancher to a Linux host using a single Docker container. Then you will configure an external load balancer to work with Rancher. @@ -58,7 +60,7 @@ The following diagram depicts the basic port requirements for Rancher. For a com For security purposes, SSL (Secure Sockets Layer) is required when using Rancher. SSL secures all Rancher network communication, like when you login or interact with a cluster. >**Attention Air Gap Users:** -> If you are visiting this page to complete [Air Gap Installation]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/), you must prepend your private registry URL to the server tag when running the installation command in the option that you choose. Replace `` with your private registry URL. +> If you are visiting this page to complete [Air Gap Installation](../air-gap-installation/), you must prepend your private registry URL to the server tag when running the installation command in the option that you choose. Replace `` with your private registry URL. > > Example: ``` @@ -173,7 +175,7 @@ server { ## What's Next? You have a couple of options: -- Create a backup of your Rancher Server in case of a disaster scenario: [Single Node Backup and Restoration]({{< baseurl >}}/rancher/v2.x/en/installation/backups-and-restoration/single-node-backup-and-restoration/). +- Create a backup of your Rancher Server in case of a disaster scenario: [Single Node Backup and Restoration]({{< baseurl >}}/rancher/v2.x/en/installation/backups/single-node-backups/). - Create a Kubernetes cluster: [Creating a Cluster]({{< baseurl >}}/rancher/v2.x/en/tasks/clusters/creating-a-cluster/).