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 69c6aeeb8fb..b1d0f2fe911 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 @@ -19,4 +19,5 @@ 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) \ No newline at end of file +- [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) \ No newline at end of file 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 new file mode 100644 index 00000000000..2f2b6f14f23 --- /dev/null +++ b/content/rancher/v2.x/en/cluster-provisioning/hosted-kubernetes-clusters/cce/_index.md @@ -0,0 +1,87 @@ +--- +title: Creating a Huawei CCE Cluster +shortTitle: Huawei Cloud Kubernetes Service +weight: 2130 +aliases: + - /rancher/v2.x/en/tasks/clusters/creating-a-cluster/create-cluster-huaweicloud-container-service/ +--- + +_Available as of v2.2.0_ + +You can use Rancher to create a cluster hosted in Huawei Cloud Container Engine(CCE). + +## Prerequisites + +Obtain the following information from the Huawei Cloud Portal: + +- A Region to deploy the CCE cluster. +- Your project ID of the region, you can found it in IAM service -> Projects. +- Access Key ID and Secret Access Key. + +[This is the document for how to find and manage your projects.](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0066738518.html) + +[This is the document for how to manage your Access Key ID and Secret Access Key.](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0079477318.html) + +## Limitations + +As Huawei CCE service doesn't support to create cluster public access via API, we can only use CCE Cloud driver when Rancher server instances should have access to the VPC network you choose for the CCE cluster. e.g. Your Rancher server can run in the same vpc with your CCE cluster's. + +## Create the CCE Cluster + +1. Enable **Huawei CCE** Cloud Driver in **Drivers** page and wait for driver active. + +2. From the **Clusters** page, click **Add Cluster**. + +3. Choose **Huawei CCE**. + +4. Enter a **Cluster Name**. + +5. {{< step_create-cluster_member-roles >}} + +6. Enter **Project Id**, Access Key ID as **Access Key** and Secret Access Key **Secret Key**. Then Click **Next: Configure cluster**. + +7. Fill the following cluster configuration: + + |Settings|Description| + |---|---| + | Cluster Type | Which type or node you want to include into the cluster, `VirtualMachine` or `BareMetal`. | + | Description | The description of the cluster. | + | Master Version | The Kubernetes version. | + | Management Scale Count | The max node count of the cluster. The options are 50, 200 and 1000. The larger of the scale count, the more the cost. | + | High Availability | Enable master node high availability. The cluster with high availability enabled will have more cost. | + | Container Network Mode | The network mode used in the cluster. `overlay_l2` and `vpc-router` is supported in `VirtualMachine` type and `underlay_ipvlan` is supported in `BareMetal` type | + | Container Network CIDR | Network CIDR for the cluster. | + | VPC Name | The VPC name which the cluster is going to deploy into. Rancher will create one if it is blank. | + | Subnet Name | The Subnet name which the cluster is going to deploy into. Rancher will create one if it is blank. | + | External Server | This option is reserved for the future we can enable CCE cluster public access via API. For now, it is always disabled. | + | Cluster Label | The labels for the cluster. | + | Highway Subnet | This option is only supported in `BareMetal` type. It requires you to select a VPC with high network speed for the bare metal machines. | + +8. Fill following node configuration of the cluster: + + |Settings|Description| + |---|---| + | Zone | The available zone at where the node(s) of the cluster is deployed. | + | Billing Mode | The bill mode for the cluster node(s). In `VirtualMachine` type, only `Pay-per-use` is supported. in `BareMetal`, you can choose `Pay-per-use` or `Yearly/Monthly`. | + | Validity Period | This option only shows in `Yearly/Monthly` bill mode. It means how long you want to pay for the cluster node(s). | + | Auto Renew | This option only shows in `Yearly/Monthly` bill mode. It means that the cluster node(s) will renew the `Yearly/Monthly` payment automatically or not. | + | Data Volume Type | Data volume type for the cluster node(s). `SATA`, `SSD` or `SAS` for this option. | + | Data Volume Size | Data volume size for the cluster node(s) | + | Root Volume Type | Root volume type for the cluster node(s). `SATA`, `SSD` or `SAS` for this option. | + | Root Volume Size | Root volume size for the cluster node(s) | + | Node Flavor | The node flavor of the cluster node(s). The flavor list in Rancher UI is fetched from Huawei Cloud. It includes all the supported node flavors. | + | Node Count | The node count of the cluster | + | Node Operating System | The operating system for the cluster node(s). Only `EulerOS 2.2` and `CentOS 7.4` are supported right now. | + | SSH Key Name | The ssh key for the cluster node(s) | + | EIP | The public IP options for the cluster node(s). `Disabled` means that the cluster node(s) are not going to bind a public IP. `Create EIP` means that the cluster node(s) will bind one or many newly created Eips after provisioned and more options will be shown in the UI to set the to-create EIP parameters. And `Select Existed EIP` means that the node(s) will bind to the EIPs you select. | + | EIP Count | This option will only be shown when `Create EIP` is selected. It means how many EIPs you want to create for the node(s). | + | EIP Type | This option will only be shown when `Create EIP` is selected. The options are `5_bgp` and `5_sbgp`. | + | EIP Share Type | This option will only be shown when `Create EIP` is selected. The only option is `PER`. | + | EIP Charge Mode | This option will only be shown when `Create EIP` is selected. The options are pay by `BandWidth` and pay by `Traffic`. | + | EIP Bandwidth Size | This option will only be shown when `Create EIP` is selected. The BandWidth of the EIPs. | + | Authentication Mode | It means enabling `RBAC` or also enabling `Authenticating Proxy`. If you select `Authenticating Proxy`, the certificate which is used for authenticating proxy will be also required. | + | Node Label | The labels for the cluster node(s). | + +9. Click **Create** to create the CCE cluster. + +{{< result_create-cluster >}}