Skip to main content
Version: v2.8

Cluster Drivers

Cluster drivers are used to create clusters in a hosted Kubernetes provider, such as Google GKE. The availability of which cluster driver to display when creating clusters is defined by the cluster driver's status. Only active cluster drivers will be displayed as an option for creating clusters. By default, Rancher is packaged with several existing cloud provider cluster drivers, but you can also add custom cluster drivers to Rancher.

If there are specific cluster drivers that you do not want to show your users, you may deactivate those cluster drivers within Rancher and they will not appear as an option for cluster creation.

Managing Cluster Drivers

Prerequisites:

To create, edit, or delete cluster drivers, you need one of the following permissions:

Activating/Deactivating Cluster Drivers

By default, Rancher only activates drivers for the most popular cloud providers, Google GKE, Amazon EKS and Azure AKS. If you want to show or hide any node driver, you can change its status.

  1. In the upper left corner, click ☰ > Cluster Management.

  2. In the left navigation menu, click Drivers.

  3. On the Cluster Drivers tab, select the driver that you wish to activate or deactivate and click ⋮ > Activate or ⋮ > Deactivate.

Adding Custom Cluster Drivers

If you want to use a cluster driver that Rancher doesn't support out-of-the-box, you can add the provider's driver in order to start using them to create hosted kubernetes clusters.

  1. In the upper left corner, click ☰ > Cluster Management.
  2. In the left navigation menu, click Drivers.
  3. On the Cluster Drivers tab, click Add Cluster Driver.
  4. Complete the Add Cluster Driver form. Then click Create.

Developing your own Cluster Driver

In order to develop cluster driver to add to Rancher, please refer to our example.