Help Center> Ubiquitous Cloud Native Service> User Guide> UCS Clusters> On-Premises Clusters> Registering an On-Premises Cluster
Updated on 2024-06-17 GMT+08:00
View PDF

Registering an On-Premises Cluster

This section describes how you can register an on-premises cluster with UCS.

Constraints

Only Huawei Cloud accounts and users with the UCS FullAccess permission can register on-premises clusters.

Prerequisites

  • You have applied for an on-premises cluster trial on the UCS console.
  • The UCS cluster quota is sufficient.
  • At least 20 GB space is available in the /tmp directory on the node.
  • The executor check items meet the requirements listed in Installing an On-Premises Cluster.
  • You have prepared an executor that is connected with the cluster network.

Registering a Cluster

  1. Log in to the UCS console. In the navigation pane on the left, choose Fleets.
  2. In the On-premises cluster card, click Register Cluster.
  3. Configure the cluster parameters listed in Table 1. The parameters marked with an asterisk (*) are mandatory.

    Table 1 Parameter description

    Parameter

    Description

    * Cluster Name

    Enter a cluster name. Only digits, lowercase letters, and hyphens (-) are allowed, and the name must start with a lowercase letter and cannot end with a hyphen (-).

    * Region

    Select a region where the cluster is deployed.

    Cluster Label

    Optional. You can add labels in the form of key-value pairs to classify clusters. A key or value can contain a maximum of 63 characters starting and ending with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed.

    Fleet

    Select the fleet that the cluster belongs to.

    A cluster can be added to only one fleet. Fleets are used for fine-grained access management. If you do not select a fleet, the cluster will be displayed on the Clusters Not in Fleet tab upon registration. You can add it to a fleet later.

    When registering a cluster, you cannot select a fleet with cluster federation enabled. To add your cluster to the fleet with cluster federation enabled, register your cluster with UCS first. For details about cluster federation, see Enabling Cluster Federation.

    For details about how to create a fleet, see Managing Fleets.

  4. Click OK. After the cluster is added, its status is as shown in Figure 1. You need to connect the cluster to UCS within 24 hours. You can choose either the public or the private network access mode. For details about the network connection process, click in the upper right corner.

    If the cluster is not connected to UCS within 24 hours, it will fail to be registered. In this case, click in the upper right corner to register it again. If the cluster has been connected to UCS but no data is displayed, wait for 2 minutes and refresh the cluster.
    Figure 1 Cluster waiting for network connection

Parent topic: On-Premises Clusters