Documentation

Installing Ascend-Docker

Ascend Docker (container engine plugin) is essentially Docker Runtime implemented based on the Open Container Initiative (OCI) standard without modifying the Docker engine and provides the Ascend NPU adaptation function for Docker as a plugin, so that AI jobs can run smoothly on Ascend devices as Docker containers.

This section describes how to quickly install Ascend Docker for container image deployment. For details about how to use Ascend Docker, see "Installation and Deployment" > "Manual Installation" > "Ascend Docker Runtime" in MindCluster Cluster Scheduling Installation Guide.

Obtaining Software Packages

Software Type

Software Package

Link

Container engine plugin

Ascend-docker-runtime_<version>_linux-<arch>.run

Link

Procedure

  1. Log in to the server as the root user and upload the software package Ascend-docker-runtime_{version}_linux-{arch}.run to any directory (for example, /home) on the server.
  2. Add the execute permission on the software package and verify the consistency and integrity of the software package installation file.
    1
2
    chmod +x Ascend-docker-runtime_<version>_linux-<arch>.run
./Ascend-docker-runtime_<version>_linux-<arch>.run --check
    If the verification is complete, the following information is displayed:
    1
2
3
4
5
    [WARNING]: --check is meaningless for Ascend-docker-runtime and will be discarded in the future
Verifying archive integrity... ./Ascend-docker-runtime_
<version>_linux-<arch>.run does not contain an embedded SHA256 checksum.
...
 All good.
  3. Install the software.
    1
    ./Ascend-docker-runtime_<version>_linux-<arch>.run --install
    If information similar to the following is displayed, the software is successfully installed:
    1
2
3
4
    Uncompressing ascend-docker-runtime  100%
[INFO]: installing ascend docker runtime
...
[INFO] Ascend Docker Runtime install success
  4. Run the following command to make the content added by the container engine plugin to the Docker configuration file take effect:
    1
    systemctl daemon-reload && systemctl restart docker