All Products
Search
Document Center

Platform For AI:Create a Lingjun cluster

Last Updated:Apr 01, 2026

A Lingjun cluster organizes compute nodes and Lingjun connection instances into node groups.

Prerequisites

Before you begin, make sure you have:

Open the cluster creation page

  1. Log on to the Lingjun console.

  2. In the left-side navigation pane, choose Resources & Nodes > Cluster Management.

  3. Click Create Cluster.

  4. Click the Basic Lingjun Cluster Service card.

Configure the cluster and node groups

Plan your cluster structure and assign compute nodes to node groups.

image
  1. Configure the following cluster information:

    FieldDescription
    Cluster nameA unique name to identify this cluster.
    Root passwordThe root password for all compute nodes in this cluster.
    Resource groupThe resource group that owns this cluster. To create one, see Create a resource group.
  2. Click Create Group and configure the node group:

    1. Set the group name, node model, and runtime image.

    2. Click Select Node Instances to add compute nodes to this group.

  3. Click Save and Next: Network Configuration.

Configure the network

By default, clusters run in isolated network environments. To connect a cluster to the public cloud, use a Lingjun connection instance with a CEN instance, and specify a VPC to monitor network connectivity.

image

Network configuration involves two CIDR blocks:

NetworkDescription
Cluster CIDR blockThe private CIDR block used to assign IP addresses to compute nodes.
Monitoring networkThe VPC used to monitor network connectivity.

These CIDR blocks must not overlap with each other or with any connected VPCs and on-premises data centers.

Configure the cluster CIDR block

Enter a valid private CIDR block for the cluster. Keep the following constraints in mind:

  • The cluster CIDR block cannot overlap with connected VPCs or on-premises data centers.

  • Use a mask length shorter than /22 to leave enough room for future scaling. The number of available IP addresses determines the maximum number of nodes the cluster can support.

  • The cluster subnet is a subnet of the cluster CIDR block. For more information, see Manage Lingjun CIDR blocks.

(Optional) Configure the subnet bond allocation policy

A bond allocation policy controls how bond interfaces on physical network cards are assigned. Three policy types are available: bond policy, model policy, and node policy.

Note

Configure only one bond allocation policy per cluster.

How bond interfaces are named

Bond interfaces are named bond0, bond1, and so on (zero-based numbering). The cluster's total bond interface count equals the highest count among all node models in the cluster.

For example, if a cluster has two node models with 3 and 4 bond interfaces respectively, the cluster has 4 bond interfaces (bond0–bond3). Nodes with 3 interfaces only use policies for bond0–bond2.

Add a bond policy

  1. Configure the bond policy for the cluster.

  2. (Optional) Configure a default bond. This policy applies to bond interfaces without specific policies. Select Apply to all to extend the default policy to all bond interfaces.

Add a model policy

A model policy applies a bond configuration to all nodes of a specific model. Create up to one policy per node group in the cluster.

  1. Select the node model from the drop-down list.

  2. Configure the bond policy. The policy applies to all node instances of the selected model.

Add a node policy

A node policy applies a bond configuration to a single node instance. Different bond ports on the same node can connect to different Lingjun CIDR blocks or subnets.

  1. Select the node instance from the drop-down list.

  2. Configure the bond policy. The policy applies to the selected node instance.

Configure the Lingjun connection instance

The Lingjun connection instance connects your cluster to CEN and grants access to other cloud products.

  1. Click Authorize to grant the required permissions to the Lingjun connection instance. For details on the permissions granted, see Appendix: Service-linked role for Lingjun connection instances.

  2. Select the Lingjun connection instance ID from the drop-down list.

  3. Select the CEN instance to connect through the Lingjun connection instance.

    Important

    The CEN transit router region must match the Lingjun node region. For details, see Transit router instances.

Configure the monitoring network

The monitoring network is a VPC that Lingjun uses to check Lingjun connection instance connectivity.

  1. Create a new VPC or connect an existing VPC to the transit router in the selected CEN instance. For details, see Enable and configure CEN. The vSwitch in the VPC must have at least one available IP address.

    Important
    • Select a VPC from the drop-down list only after connecting it to the selected transit router.

    • The monitoring VPC CIDR block cannot overlap with the cluster CIDR block or with other connected networks (VPCs or on-premises data centers).

  2. Click the refresh icon next to the VPC and vSwitch drop-down lists, then select the VPC and vSwitch.

  3. Click Save and Next: Basic Software Instance Parameters.

Note

After completing the network configuration, verify your CEN network configuration. For details, see Purchase and configure CEN.

Submit the configuration

On the Confirm Configuration page, review the cluster basic information, network information, and software instance parameters. If everything looks correct, click Submit Configuration to create the cluster.

After the cluster is created, you are redirected to Cluster Management.