adding content about what custom nodes and node pool clusters are. Have not yet described what custom clusters are

This commit is contained in:
Mark Bishop
2018-07-18 12:30:54 -07:00
parent 8575e30bf4
commit b0afa6b002
2 changed files with 37 additions and 15 deletions
@@ -6,7 +6,13 @@ aliases:
- /rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-custom/
---
## Objectives
## Custom Nodes
Use Rancher to create a Kubernetes cluster on your on-premise bare metal servers. In addition to bare-metal servers, on-premise virtual machines, or _any_ IaaS providers by integrating with node drivers. This option creates a cluster using RKE, which is Rancher's own lightweight Kubernetes installer.
To use this option you'll need access to servers you intend to use as your Kubernetes cluster. Provision each server according to Rancher requirements, which includes some hardware specifications and Docker. After you install Docker on each server, run the command provided in the Rancher UI to turn each server into a Kubernetes node.
## Objectives for Creating Cluster with Custom Nodes
1. [Provision a Linux Host](#provision-a-linux-host)
@@ -28,23 +34,29 @@ Begin creation of a custom cluster by provisioning a Linux host. Your host can b
- An on-premise VM
- A bare-metal server
>**Bare-Metal Server Note:**
>
While creating your cluster, you must assign Kubernetes roles to your cluster nodes. If you plan on dedicating bare-metal servers to each role, you must provision a bare-metal server for each role (i.e. provision multiple bare-metal servers).
Provision the host according to the requirements below.
### Requirements
{{< requirements_os >}}
{{< requirements_hardware >}}
{{< requirements_software >}}
{{< requirements_ports_rancher >}}
{{< requirements_ports_rke >}}
>**Bare-Metal Server Note:**
>
While creating your cluster, you must assign Kubernetes roles to your cluster nodes. If you plan on dedicating bare-metal servers to each role, you must provision a bare-metal server for each role (i.e. provision multiple bare-metal servers).
{{< accordion id="os" label="Operating System" >}}
{{< requirements_os >}}
{{< /accordion >}}
{{< accordion id="hardware" label="Hardware" >}}
{{< requirements_hardware >}}
{{< /accordion >}}
{{< accordion id="software" label="Software" >}}
{{< requirements_software >}}
{{< /accordion >}}
{{< accordion id="ports-rancher" label="Ports for Rancher" >}}
{{< requirements_ports_rancher >}}
{{< /accordion >}}
{{< accordion id="ports-rke" label="Ports for RKE" >}}
{{< requirements_ports_rke >}}
{{< /accordion >}}
## Create the Custom Cluster
@@ -7,8 +7,16 @@ aliases:
- /rancher/v2.x/en/concepts/global-configuration/node-templates/
---
### Node Drivers
Using Rancher, you can use APIs from major IaaS providers in combination with Rancher RKE to provision a new Kubernetes cluster quickly and easily, all from the Rancher UI. There's no need to log directly into your infrastructure provider's portal.
Out-of-the-box, Rancher supports the following infrastructure providers:
- Amazon EC2
- Microsoft Azure
- DigitalOcean
- VMWare Vsphere
### Node Drivers
Out-of-the-box, Rancher provides support for creating clusters using many popular cloud providers: Amazon EC2, Azure, DigitalOcean, and so on. However, you may want to create a cluster using another cloud provider. In these scenarios, you can create a custom node driver for the cloud provider and point Rancher toward it.
@@ -45,3 +53,5 @@ Using the **Custom** option, you can create a cluster using virtually any cloud
You can create new clusters within Rancher using _node templates_. A node template is a virtual machine image used to create a Kubernetes cluster. While creating a cluster, Rancher will prompt you for an image to use as a template. Follow the directions on screen to create the template. During cluster creation, Rancher clones the template and installs different Kubernetes components.
After you add a node template to Rancher, its stored by the system so that you can use it when creating another cluster later. Node templates are bound to your login. After you add a template, you can remove them from your user profile.
You can create provider-hosted nodes from the Rancher UI by creating a node template. After providing Rancher with an access token from the vendor you're using, Rancher prompts you for specifications that it will send to your provider by API. The provider than provisions your nodes based on the template.