Skip to main content
Version: v2.0-v2.4

Setting up Clusters from Hosted Kubernetes Providers

In this scenario, Rancher does not provision Kubernetes because it is installed by providers such as Google Kubernetes Engine (GKE), Amazon Elastic Container Service for Kubernetes, or Azure Kubernetes Service.

If you use a Kubernetes provider such as Google GKE, Rancher integrates with its cloud APIs, allowing you to create and manage role-based access control for the hosted cluster from the Rancher UI.

In this use case, Rancher sends a request to a hosted provider using the provider's API. The provider then provisions and hosts the cluster for you. When the cluster finishes building, you can manage it from the Rancher UI along with clusters you've provisioned that are hosted on-prem or in an infrastructure provider.

Rancher supports the following Kubernetes providers:

Kubernetes ProvidersAvailable as of
Google GKE (Google Kubernetes Engine)v2.0.0
Amazon EKS (Amazon Elastic Container Service for Kubernetes)v2.0.0
Microsoft AKS (Azure Kubernetes Service)v2.0.0
Alibaba ACK (Alibaba Cloud Container Service for Kubernetes)v2.2.0
Tencent TKE (Tencent Kubernetes Engine)v2.2.0
Huawei CCE (Huawei Cloud Container Engine)v2.2.0

Hosted Kubernetes Provider Authentication

When using Rancher to create a cluster hosted by a provider, you are prompted for authentication information. This information is required to access the provider's API. For more information on how to obtain this information, see the following procedures: