Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cluster Provisioning: added RKE2 section #4075

Merged
merged 12 commits into from
May 13, 2022
58 changes: 35 additions & 23 deletions content/rancher/v2.6/en/cluster-provisioning/rke-clusters/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,37 +3,17 @@ title: Launching Kubernetes with Rancher
weight: 4
---

You can have Rancher launch a Kubernetes cluster using any nodes you want. When Rancher deploys Kubernetes onto these nodes, it uses [Rancher Kubernetes Engine]({{<baseurl>}}/rke/latest/en/) (RKE), which is Rancher's own lightweight Kubernetes installer. It can launch Kubernetes on any computers, including:
You can have Rancher launch a Kubernetes cluster using any nodes you want. When Rancher deploys Kubernetes onto these nodes, you can choose between [Rancher Kubernetes Engine]({{<baseurl>}}/rke/latest/en/) (RKE), which is Rancher's own lightweight Kubernetes installer, or [RKE2](https://docs.rke2.io). It can launch Kubernetes on any computers, including:
jtravee marked this conversation as resolved.
Show resolved Hide resolved
jtravee marked this conversation as resolved.
Show resolved Hide resolved

- Bare-metal servers
- On-premise virtual machines
- Virtual machines hosted by an infrastructure provider

Rancher can install Kubernetes on existing nodes, or it can dynamically provision nodes in an infrastructure provider and install Kubernetes on them.

RKE clusters include clusters that Rancher launched on Windows nodes or other existing custom nodes, as well as clusters that Rancher launched with new nodes on Azure, Digital Ocean, EC2, or vSphere.
RKE/RKE2 clusters include clusters that Rancher launched on Windows nodes or other existing custom nodes, as well as clusters that Rancher launched with new nodes on Azure, Digital Ocean, EC2, or vSphere.
nunix marked this conversation as resolved.
Show resolved Hide resolved

### Changes in Rancher v2.6

_Tech Preview_

Rancher v2.6 introduces provisioning for [RKE2](https://docs.rke2.io/) clusters directly from the Rancher UI. RKE2, also known as RKE Government, is a fully conformant Kubernetes distribution that focuses on security and compliance within the U.S. Federal Government sector.

RKE2 provisioning is built on top of a new provisioning framework that leverages the upstream [Cluster API](https://github.com/kubernetes-sigs/cluster-api) project. With this new provisioning framework, you can:

- Provision RKE2 clusters on Digital Ocean, AWS EC2, Azure, and vSphere
- Fully configure RKE2 clusters within Rancher
- Choose CNI options Calico, Cilium, and Multus in addition to Canal
- Install custom RKE2 clusters on pre-provisioned VMs or bare-metal nodes

The RKE2 provisioning tech preview also includes installing RKE2 on Windows clusters. Windows features for RKE2 include:

- Windows Containers with RKE2 powered by containerd
- Added provisioning of Windows RKE2 custom clusters directly from the Rancher UI
- Calico CNI for Windows RKE2 custom clusters.
- SAC releases of Windows Server (2004 and 20H2) are included in the technical preview.

Windows Support for RKE2 Custom Clusters requires choosing Calico as the CNI.
## RKE

### Requirements

Expand All @@ -58,3 +38,35 @@ For more information, refer to the section on [custom nodes.]({{<baseurl>}}/ranc
# Programmatically Creating RKE Clusters

The most common way to programmatically deploy RKE clusters through Rancher is by using the Rancher2 Terraform provider. The documentation for creating clusters with Terraform is [here.](https://registry.terraform.io/providers/rancher/rancher2/latest/docs/resources/cluster)

## RKE2

Rancher v2.6 introduces provisioning for [RKE2](https://docs.rke2.io/) clusters directly from the Rancher UI. RKE2, also known as RKE Government, is a fully conformant Kubernetes distribution that focuses on security and compliance within the U.S. Federal Government sector.
jtravee marked this conversation as resolved.
Show resolved Hide resolved

### Requirements

If you use RKE to set up a cluster, your nodes must meet the [requirements](https://docs.rke2.io/install/requirements/) for nodes in downstream user clusters.
nunix marked this conversation as resolved.
Show resolved Hide resolved

### Launching Kubernetes on New Nodes in an Infrastructure Provider

RKE2 provisioning is built on top of a new provisioning framework that leverages the upstream [Cluster API](https://github.com/kubernetes-sigs/cluster-api) project. With this new provisioning framework, you can:

- Provision RKE2 clusters on Digital Ocean, AWS EC2, Azure, and vSphere
nunix marked this conversation as resolved.
Show resolved Hide resolved
jtravee marked this conversation as resolved.
Show resolved Hide resolved
- Fully configure RKE2 clusters within Rancher
- Choose CNI options Calico, Cilium, and Multus in addition to Canal
- Install custom RKE2 clusters on pre-provisioned VMs or bare-metal nodes

nunix marked this conversation as resolved.
Show resolved Hide resolved
The RKE2 provisioning also includes installing RKE2 on Windows clusters. Windows features for RKE2 include:

nunix marked this conversation as resolved.
Show resolved Hide resolved
- Windows Containers with RKE2 powered by ContainerD
- Added provisioning of Windows RKE2 custom clusters directly from the Rancher UI
- Calico CNI for Windows RKE2 custom clusters.
nunix marked this conversation as resolved.
Show resolved Hide resolved
- SAC releases of Windows Server (2004 and 20H2) are included in the technical preview.
nunix marked this conversation as resolved.
Show resolved Hide resolved

Windows Support for RKE2 Custom Clusters requires choosing Calico as the CNI.
jtravee marked this conversation as resolved.
Show resolved Hide resolved

### Launching Kubernetes on Existing Custom Nodes

If you want to reuse a node from a previous custom cluster, [clean the node]({{<baseurl>}}/rancher/v2.6/en/cluster-admin/cleaning-cluster-nodes/) before using it in a cluster again. If you reuse a node that hasn't been cleaned, cluster provisioning may fail.
jtravee marked this conversation as resolved.
Show resolved Hide resolved

For more information, refer to the section on [custom nodes.]({{<baseurl>}}/rancher/v2.6/en/cluster-provisioning/rke-clusters/custom-nodes/)