diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/_index.md index a4575320e53..5665d1b8128 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/_index.md @@ -9,12 +9,14 @@ In this use case, Rancher sends a request to a hosted provider using the provide Rancher supports the following Kubernetes providers: -- Google GKE (Google Container Engine) -- Amazon EKS (Elastic Container Service) -- Microsoft AKS (Azure Kubernetes Service) -- Alibaba ACK (Alibaba Cloud Container Service for Kubernetes) -- Tencent TKE (Tencent Kubernetes Engine) -- Huawei CCE (Huawei Cloud Container Engine) +Kubernetes Providers | Available as of | + --- | --- | +[Google GKE (Google Kubernetes Engine)](https://cloud.google.com/kubernetes-engine/) | v2.0.0 | +[Amazon EKS (Amazon Elastic Container Service for Kubernetes)](https://aws.amazon.com/eks/) | v2.0.0 | +[Microsoft AKS (Azure Kubernetes Service)](https://azure.microsoft.com/en-us/services/kubernetes-service/) | v2.0.0 | +[Alibaba ACK (Alibaba Cloud Container Service for Kubernetes)](https://www.alibabacloud.com/product/kubernetes) | v2.2.0 | +[Tencent TKE (Tencent Kubernetes Engine)](https://intl.cloud.tencent.com/product/tke) | v2.2.0 | +[Huawei CCE (Huawei Cloud Container Engine)](https://www.huaweicloud.com/en-us/product/cce.html) | v2.2.0 | ## Hosted Kubernetes Provider Authentication @@ -23,6 +25,6 @@ When using Rancher to create a cluster hosted by a provider, you are prompted fo - [Creating a GKE Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/gke) - [Creating an EKS Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/eks) - [Creating an AKS Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/aks) -- [Creating a Huawei CCE Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce) - [Creating an ACK Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/ack) - [Creating an TKE Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/tke) +- [Creating a CCE Cluster]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce) diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/ack/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/ack/_index.md index e2978f51c79..740c166b90a 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/ack/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/ack/_index.md @@ -10,13 +10,17 @@ You can use Rancher to create a cluster hosted in Alibaba Cloud Kubernetes (ACK) ## Prerequisites -1. Make sure the services such as Container Service, Resource Orchestration Service (ROS), and RAM have been activated. Log in to the [Container Service console](https://cs.console.aliyun.com), [ROS console](https://ros.console.aliyun.com), and [RAM console](https://ram.console.aliyun.com) to activate the corresponding services. +1. In Aliyun, activate the following services in their respective consoles. -1. Make sure that the account you will be using to create the ACK cluster has the appropriate permissions. Referring to the official Alibaba Cloud documentation about [Role authorization](https://www.alibabacloud.com/help/doc-detail/86483.htm) and [Use the Container Service console as a RAM user](https://www.alibabacloud.com/help/doc-detail/86484.htm) for details. + - [Container Service](https://cs.console.aliyun.com) + - [Resource Orchestration Service](https://ros.console.aliyun.com) + - [RAM](https://ram.console.aliyun.com) -1. Create an access key. For instructions, see the Alibaba Cloud documentation [Creating an AccessKey](https://www.alibabacloud.com/help/doc-detail/53045.html). +2. Make sure that the account you will be using to create the ACK cluster has the appropriate permissions. Referring to the official Alibaba Cloud documentation about [Role authorization](https://www.alibabacloud.com/help/doc-detail/86483.htm) and [Use the Container Service console as a RAM user](https://www.alibabacloud.com/help/doc-detail/86484.htm) for details. -1. Create an SSH key pair. This key is used to access nodes in the Kubernetes cluster. For instructions, see the Alibaba Cloud documentation [Create an SSH key pair](https://www.alibabacloud.com/help/doc-detail/51793.htm). +3. In Alibaba Cloud, create an [access key](https://www.alibabacloud.com/help/doc-detail/53045.html). + +4. In Alibaba Cloud, create an [SSH key pair](https://www.alibabacloud.com/help/doc-detail/51793.html). This key is used to access nodes in the Kubernetes cluster. ## Create an ACK Cluster diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/aks/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/aks/_index.md index d19031d1d1c..ebae39c34f4 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/aks/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/aks/_index.md @@ -8,17 +8,17 @@ aliases: You can use Rancher to create a cluster hosted in Microsoft Azure Kubernetes Service (AKS). -## Prerequisites +## Prerequisites in the Microsoft Azure Portal -Obtain the following information from the Microsoft Azure Portal: +Obtain the following information from the [Microsoft Azure Portal](https://portal.azure.com) by completing how to [Create Service Principal for Azure AD](https://docs.microsoft.com/en-us/azure/azure-stack/azure-stack-create-service-principals#create-service-principal-for-azure-ad). - Your Subscription ID. - Your Tenant ID. - A Client ID and Client Secret. - Complete Create Service Principal for Azure AD to obtain this information. +## Create the AKS Cluster -## To Create an AKS Cluster +Use Rancher to set up and configure your Kubernetes cluster. 1. From the **Clusters** page, click **Add Cluster**. diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce/_index.md index f4f15c6a7c7..0134a01f593 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce/_index.md @@ -8,10 +8,11 @@ _Available as of v2.2.0_ You can use Rancher to create a cluster hosted in Huawei Cloud Container Engine (CCE). Rancher has already implemented and packaged the [cluster driver]({{< baseurl >}}/rancher/v2.x/en/tools/drivers/cluster-drivers/) for CCE, but by default, this cluster driver is `inactive`. In order to launch CCE clusters, you will need to [enable the CCE cluster driver]({{< baseurl >}}/rancher/v2.x/en/tools/drivers/cluster-drivers/#activating-deactivating-cluster-drivers). After enabling the cluster driver, you can start provisioning CCE clusters. -## Prerequisites +## Prerequisites in Huawei -- Find your project ID in Huawei CCE portal. See the CCE documentation on how to [manage your projects](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0066738518.html). -- Create an Access Key ID and Secret Access Key. See the CCE documentation on how to [manage your Access Key ID and Secret Access Key.](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0079477318.html). +1. Find your project ID in Huawei CCE portal. See the CCE documentation on how to [manage your projects](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0066738518.html). + +2. Create an [Access Key ID and Secret Access Key](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0079477318.html). ## Limitations diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/eks/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/eks/_index.md index e85514e6dde..1d1ced3f078 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/eks/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/eks/_index.md @@ -5,28 +5,14 @@ weight: 2110 aliases: - /rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-eks/ --- -## Objectives - +## Prerequisites in Amazon Web Services -- [1. Give Appropriate Permissions](#1-give-appropriate-permissions) -- [2. Create Access Key and Secret Key](#2-create-access-key-and-secret-key) -- [3. Create the EKS Cluster](#3-create-the-eks-cluster) +1. Make sure that the account you will be using to create the EKS cluster has the appropriate permissions. Referring to the official [EKS documentation](https://docs.aws.amazon.com/eks/latest/userguide/IAM_policies.html) for details. +2. Use AWS to create an [access key and client secret for the IAM account](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey) used in the previous step. - - -## 1. Give Appropriate Permissions - -Make sure that the account you will be using to create the EKS cluster has the appropriate permissions. Referring to the official [EKS documentation](https://docs.aws.amazon.com/eks/latest/userguide/IAM_policies.html) for details. - -## 2. Create Access Key and Secret Key - -Use AWS to create an access key and client secret for the IAM account used in [1. Give Appropriate Permissions](#1-give-appropriate-permissions). - -For instructions on how to create these keys, see the AWS documentation [Managing Access Keys: To create, modify, or delete a user's access keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey). - -## 3. Create the EKS Cluster +## Create the EKS Cluster Use Rancher to set up and configure your Kubernetes cluster. @@ -45,10 +31,10 @@ Use Rancher to set up and configure your Kubernetes cluster. | Region | From the drop-down choose the geographical region in which to build your cluster. | | Access Key | Enter the access key that you created in [2. Create Access Key and Secret Key](#2-create-access-key-and-secret-key). | | Secret Key | Enter the secret key that you created in [2. Create Access Key and Secret Key](#2-create-access-key-and-secret-key). | - + 1. Click **Next: Select Service Role**. Then choose a [service role](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html). - Service Role | Description + Service Role | Description -------------|--------------------------- Standard: Rancher generated service role | If you choose this role, Rancher automatically adds a service role for use with the cluster. Custom: Choose from your existing service roles | If you choose this role, Rancher lets you choose from service roles that you're already created within AWS. For more information on creating a custom service role in AWS, see the [Amazon documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role). @@ -60,11 +46,11 @@ Use Rancher to set up and configure your Kubernetes cluster. Option | Description -------|------------ Yes | When your cluster nodes are provisioned, they're assigned a both a private and public IP address. - No: Private IPs only | When your cluster nodes are provisioned, they're assigned only a private IP address.

If you choose this option, you must also choose a **VPC & Subnet** that allow your instances to access the internet. This access is required so that your worker nodes can connect to the Kubernetes control plane. + No: Private IPs only | When your cluster nodes are provisioned, they're assigned only a private IP address.

If you choose this option, you must also choose a **VPC & Subnet** that allow your instances to access the internet. This access is required so that your worker nodes can connect to the Kubernetes control plane. 1. Now choose a **VPC & Subnet**. Follow one of the sets of instructions below based on your selection from the previous step. - Amazon Documentation: + Amazon Documentation: - [What Is Amazon VPC?](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html) - [VPCs and Subnets](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html) @@ -74,7 +60,7 @@ If you choose to assign a public IP address to your cluster's worker nodes, you 1. Choose a **VPC and Subnet** option. - Option | Description + Option | Description -------|------------ Standard: Rancher generated VPC and Subnet | While provisioning your cluster, Rancher generates a new VPC and Subnet. Custom: Choose from your exiting VPC and Subnets | While provisioning your cluster, Rancher configures your nodes to use a VPC and Subnet that you've already [created in AWS](https://docs.aws.amazon.com/vpc/latest/userguide/getting-started-ipv4.html). If you choose this option, complete the remaining steps below. @@ -82,11 +68,11 @@ If you choose to assign a public IP address to your cluster's worker nodes, you 1. If you're using **Custom: Choose from your existing VPC and Subnets**: (If you're using **Standard**, skip to [step 11](#select-instance-options)) - + 1. Make sure **Custom: Choose from your existing VPC and Subnets** is selected. - + 1. From the drop-down that displays, choose a VPC. - + 1. Click **Next: Select Subnets**. Then choose one of the **Subnets** that displays. 1. Click **Next: Select Security Group**. @@ -95,9 +81,9 @@ If you choose to assign a public IP address to your cluster's worker nodes, you If you chose this option, you must also choose a **VPC & Subnet** that allow your instances to access the internet. This access is required so that your worker nodes can connect to the Kubernetes control plane. Follow the steps below. >**Tip:** When using only private IP addresses, you can provide your nodes internet access by creating a VPC constructed with two subnets, a private set and a public set. The private set should have its route tables configured to point toward a NAT in the public set. For more information on routing traffic from private subnets, please see the [official AWS documentation](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html). - + 1. From the drop-down that displays, choose a VPC. - + 1. Click **Next: Select Subnets**. Then choose one of the **Subnets** that displays. 1. Click **Next: Select Security Group**. @@ -119,7 +105,7 @@ If you chose this option, you must also choose a **VPC & Subnet** that allow you Minimum ASG Size | The minimum number of instances that your cluster will scale to during low traffic, as controlled by [Amazon Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html). Maximum ASG Size | The maximum number of instances that your cluster will scale to during high traffic, as controlled by [Amazon Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html). User Data | Custom commands can to be passed to perform automated configuration tasks **WARNING: Modifying this may cause your nodes to be unable to join the cluster.** _Note: Available as of v2.2.0_ + 1. Click **Create**. {{< result_create-cluster >}} - diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/gke/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/gke/_index.md index e4622c0fc37..92c2f16db04 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/gke/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/gke/_index.md @@ -5,17 +5,8 @@ weight: 2105 aliases: - /rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-gke/ --- -## Objectives -1. [Create a Service Account](#create-a-service-account) - - Begin by logging into Google Cloud Platform and creating a service account to operate your cluster. - -2. [Create the Cluster](#create-the-gke-cluster) - - Using your service account, create your Google Container Engine (GKE) cluster. - -## Create a Service Account +## Prerequisites in Google Cloud Platform Create a service account using [Google Cloud Platform](https://console.cloud.google.com/projectselector/iam-admin/serviceaccounts). GKE uses this account to operate your cluster. Creating this account also generates a private key used for authentication. @@ -43,10 +34,6 @@ Use {{< product >}} to set up and configure your Kubernetes cluster. >**Note:** After submitting your private key, you may have to enable the Google Kubernetes Engine API. If prompted, browse to the URL displayed in the Rancher UI to enable the API. -6. {{< step_create-cluster_cluster-options >}} - -7. Use **Nodes** to provision each node in your cluster and choose a geographical region. - -8. Review your options to confirm they're correct. Then click **Create**. +6. Select your **Cluster Options**, customize your **Nodes** and customize the **Security** for the GKE cluster. Review your options to confirm they're correct. Then click **Create**. {{< result_create-cluster >}} diff --git a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/tke/_index.md b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/tke/_index.md index 7b81922f954..1dc22301526 100644 --- a/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/tke/_index.md +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/tke/_index.md @@ -2,23 +2,24 @@ title: Creating a Tencent TKE Cluster shortTitle: Tencent Kubernetes Engine weight: 2125 -aliases: - - /rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-tke/ --- _Available as of v2.2.0_ -You can use Rancher to create a cluster hosted in Tencent Kubernetes Engine(TKE). Rancher has already implemented and packaged the [cluster driver]({{< baseurl >}}/rancher/v2.x/en/tools/drivers/cluster-drivers/) for TKE, but by default, this cluster driver is `inactive`. In order to launch TKE clusters, you will need to [enable the TKE cluster driver]({{< baseurl >}}/rancher/v2.x/en/tools/drivers/cluster-drivers/#activating-deactivating-cluster-drivers). After enabling the cluster driver, you can start provisioning TKE clusters. +You can use Rancher to create a cluster hosted in Tencent Kubernetes Engine (TKE). Rancher has already implemented and packaged the [cluster driver]({{< baseurl >}}/rancher/v2.x/en/tools/drivers/cluster-drivers/) for TKE, but by default, this cluster driver is `inactive`. In order to launch TKE clusters, you will need to [enable the TKE cluster driver]({{< baseurl >}}/rancher/v2.x/en/tools/drivers/cluster-drivers/#activating-deactivating-cluster-drivers). After enabling the cluster driver, you can start provisioning TKE clusters. -## Prerequisites +## Prerequisites in Tencent -- Make sure that the account you will be using to create the TKE cluster has the appropriate permissions. Referring to the official Tencent Cloud documentation about [Cloud Access Management](https://intl.cloud.tencent.com/document/product/598/10600) for reference. -- Create a [Cloud API SecretId and SecretKey](https://console.cloud.tencent.com/capi). -- Create a Private Network and Subnet in the rhttps://intl.cloud.tencent.com/document/product/213/6092equired region. See the Tencent Cloud documentation on [How to create Private Network and Subnet](https://intl.cloud.tencent.com/document/product/215/4927). -- Create an SSH key pair. This key is used to access nodes in the Kubernetes cluster. For instructions, see the Tencent Cloud documentation on [Create an SSH key pair](https://intl.cloud.tencent.com/document/product/213/6092). +1. Make sure that the account you will be using to create the TKE cluster has the appropriate permissions by referring to the [Cloud Access Management](https://intl.cloud.tencent.com/document/product/598/10600) documentation for details. +2. Create a [Cloud API Secret ID and Secret Key](https://console.cloud.tencent.com/capi). + +3. Create a [Private Network and Subnet](https://intl.cloud.tencent.com/document/product/215/4927) in the region that you want to deploy your Kubernetes cluster. + +4. Create a [SSH key pair](https://intl.cloud.tencent.com/document/product/213/6092). This key is used to access the nodes in the Kubernetes cluster. ## Create a TKE Cluster + 1. From the **Clusters** page, click **Add Cluster**. 2. Choose **Tencent TKE**.