This section describes how to use the Route Tool to add domains, so that domain uniqueness validation can be performed when creating or editing an Ingress.

Validation Rule: Ingresses under the same gateway can use the same domain and its subdomains. Ingresses under different gateways cannot use the same domain.

Note

"Domain Reuse Validation" only takes effect for the current cluster and does not apply to previously existing Ingresses.

Prerequisites

  • The KubeSphere Route Tool extension must be installed and enabled on the KubeSphere platform.

  • You need to join a cluster and have the cluster-admin permission in the cluster. For more information, see Cluster Members and Cluster Roles.

Steps

  1. Log in to the KubeSphere web console with a user who has cluster-admin permissions and enter your cluster.

  2. Click Application Workloads > Route Tool in the left navigation pane.

  3. On the page, click Add Domain.

  4. In the Add Domain dialog box, configure the domain information.

    Parameter Description

    Name

    The name of the domain. The name can only contain lowercase letters, numbers, and hyphens (-), must start and end with a lowercase letter or number, and has a maximum length of 63 characters.

    Domain

    The domain address. Wildcards are supported for matching.

    The wildcard * matches all but only one level of subdomain. That is: *.qingcloud.com matches all domains with the suffix .qingcloud.com, but does not match *.xxx.qingcloud.com.

    Description

    The description of the domain. The description can contain any characters and has a maximum length of 256 characters.