Environment Dependencies

Software Dependencies

Ascend Docker Runtime

  • The Docker version in the current environment must be 18.09 and later.

  • The host machine must have the drivers and firmware installed. For details, see "Installing the NPU Driver and Firmware" in the CANN Software Installation Guide (Commercial) or "Installing the NPU Driver and Firmware" in the CANN Software Installation Guide (Community).

  • For Atlas 500 A2 intelligent station, installing Ascend Docker Runtime requires modifying the Docker configuration. Run the vi /etc/sysconfig/docker command to delete the --config-file="" parameter, and run systemctl restart docker to make the configuration take effect.

  • The MEF service pre-installed on the Atlas 500 A2 intelligent station performs security hardening on Docker. Ascend Docker Runtime does not support running in a security-hardened Docker environment. If you need to use Ascend Docker Runtime, manually uninstall the MEF service by referring to the "Uninstalling MEF Edge" in the MindEdge Framework User Guide.

    Run the systemctl status docker command. If the returned information contains the /docker_entrypoint.sh field, Docker has been security-hardened by the MEF service.

Other Cluster Scheduling Components

The dependencies for the Arm architecture and x86_64 architecture are different. The cluster scheduling components support both IPv4 and IPv6, and use IPv4 by default.

Table 1 Software environment

SoftwareSupported VersionInstallation PathDescription
Kubernetes1.17.x~1.34.x (1.19.x and later versions are recommended)All nodesFor details about using K8s, see Kubernetes Documentation.
(Optional) Docker18.09.x~28.5.1All nodesIt can be obtained from the Docker community or official website. The Docker version used must be compatible with Kubernetes. For compatibility details, refer to the Kubernetes release notes or obtain information from the Kubernetes community. It is recommended to select the latest bugfix version.
(Optional) Containerd1.4.x~2.1.4 (1.6.x is recommended)All nodesIt can be obtained from the Containerd official website or community. It is recommended to select the latest bugfix version. Pay attention to the CRI version used with Kubernetes.
Ascend AI Processor Drivers and FirmwareSee the Version Compatibility Table (training) or Version Compatibility Table (inference). Select the drivers and firmware compatible with MindCluster based on the actual hardware device model.Compute nodeSee the Driver and Firmware Installation and Upgrade Guide for each hardware product for corresponding instructions.
NOTE

To ensure that NPU Exporter can be installed by a non-root user (such as hwMindX) when deployed as a binary, use the --install-for-all parameter during driver installation. An example is as follows.

./Ascend-hdk-<chip_type>-npu-driver_<version>_linux-<arch>.run --full --install-for-all
(Optional) CANNIf only the cluster scheduling component is installed, CANN is not required. Users can choose to install the required CANN software package based on actual needs. See the version compatibility table to install the corresponding software package.Compute node or inside training/inference containersTo install the CANN software package on the host, see CANN Software Installation Guide (Commercial) or CANN Software Installation Guide (Community).
NOTE
If the soft partitioning virtualization function is used, CANN must be installed, and the compatible CANN version is 8.5.0. For details, see vCANN-RT.
Python3.8~3.12Inside training or inference containersWhen using Python, the version should be based on the specific AI framework.

NOTE

  • Choose to install Docker or Containerd based on the actual service scenario.
  • For installing the operating system on Atlas servers, see the Installation Guide (Arm) and Installation Guide (x86_64). The installation guides do not cover all the operating systems mentioned above and are for reference only.
  • Atlas A2 training series products have different operating system requirements in virtual machine scenarios. For specific operating system constraints, see the "Installation and Uninstallation on Virtual Machines" section in the Atlas A2 Center Inference and Training Hardware 26.0.RC1 NPU Driver and Firmware Installation Guide.

Networking Requirements

Since Volcano, the core scheduling component for cluster scheduling, is currently deployed on the management node of K8s, the following recommendations are made for deploying the management node based on K8s deployment requirements to ensure service health and stability. Customers can make adjustments based on their own service characteristics.

  • Management nodes should be separated from compute nodes and storage nodes. It is recommended to use a dedicated server for deployment.
  • If the cluster is large in scale or has high requirements for service reliability, multiple management nodes are required.

Deployment Logic Diagram

Figure 1 Deployment logic diagram

The node types in a data center cluster are generally classified into the following three types:

  • Management node (Master node): Manages the cluster and is responsible for distributing training and inference jobs to each compute node for execution. Cluster scheduling components associated with the master node can be installed.
  • Compute node (Worker node): Executes training and inference jobs. Cluster scheduling components associated with the worker node can be installed.
  • Storage node: stores data such as datasets and models output from training.

Users need to divide the network planes into:

  • Service plane: Used for K8s cluster service management.
  • Storage plane: Used to read training datasets from storage nodes. Because there are certain bandwidth requirements, it is recommended to use a separate network plane and network port to connect training nodes (management nodes or compute nodes) with storage nodes.
  • Parameter plane: Used for parameter exchange between training nodes during distributed training. Refer to the following networking instructions.

Software and Hardware Specifications

Operating System Disk Partition

The recommended operating system disk partition is shown in Table 2.

Table 2 Disk space planning

PartitionDescriptionSizeBoot Flag
/bootBoot partition.500 MBon
/varPartition for storing data generated during software operation, such as logs and caches.> 300 GBoff
/var/lib/dockerPartition for storing Docker images and containers.
[!NOTE] Note:
Docker images and containers are stored in the /var/lib/docker partition by default. If the usage of the /var/lib/docker partition exceeds 85%, K8s will trigger the resource eviction mechanism. Ensure that the usage of the /var/lib/docker partition remains below 85% during use.
> 300 GBoff
/etc/mindx-dlThis partition stores imported certificates, KubeConfig, and other files. It is recommended to configure 100 MB, which can be adjusted based on actual conditions.100 MBoff
/Main partition.> 300 GBoff

Hardware Specifications

The hardware must meet the following requirements:

Table 2 Resource requirements

NameRequirement
CPUManagement node CPU > 32 cores
MemoryManagement node memory > 64 GB
Disk space> 1 TB. For disk space planning, see Table 1
Network
  • Out-of-band management (BMC): ≥ 1 Gbit/s
  • In-band management (SSH): ≥ 1 Gbit/s
  • Service plane: ≥ 10 Gbit/s
  • Storage plane: ≥ 25 Gbit/s
  • Parameter plane: 100 Gbit/s or 200 Gbit/s

Cluster Scheduling Component Resource Configuration Requirements

The cluster scheduling component resource configuration must meet the following requirements:

Table 3 Resource configuration requirements for components installed on management nodes

Component

Up to 100 Nodes

500 Nodes

1,000 Nodes

CPU (Unit: Core)

Memory (Unit: GB)

CPU (Unit: Core)

Memory (Unit: GB)

CPU (Unit: Core)

Memory (Unit: GB)

Volcano Scheduler

2.5

2.5

4

5

5.5

8

Volcano Controller

2

2.5

2

3

2.5

4

Infer Operator

2

2

4

4

8

8

Ascend Operator

2

2.5

2

3

2.5

4

ClusterD

1

1

2

2

4

8

Table 4 Resource configuration requirements for components installed on compute nodes

ComponentCPU (Unit: Cores)Memory (Unit: GB)
Ascend Device Plugin0.50.5
NodeD0.50.3
NPU Exporter11
Ascend Docker RuntimeA Docker service plugin that does not require dedicated CPU and memory space