安装Ascend Docker Runtime

安装场景

目前只支持root用户安装、升级Ascend Docker Runtime，请根据实际情况选择对应的安装方式。

Docker场景下安装Ascend Docker Runtime

1. 安装包下载完成后，首先进入安装包（run包）所在路径。

   cd <path to run package>

2. 执行如下命令，校验软件包安装文件的一致性和完整性。

   ./Ascend-docker-runtime_{version}_linux-{arch}.run --check

   回显示例如下：

   [WARNING]: --check is meaningless for Ascend-docker-runtime and will be discarded in the future
   Verifying archive integrity... ./Ascend-docker-runtime_5.0.0.2_linux-x86_64.run does not contain an embedded SHA256 checksum.
   ...
    All good.

3. 执行以下命令，为软件包添加可执行权限。

   chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run

4. 可通过以下命令安装Ascend Docker Runtime。
   • 安装到默认路径下，执行以下命令。

     ./Ascend-docker-runtime_{version}_linux-{arch}.run --install

   • 安装到指定路径下，执行以下命令，“--install-path”参数为指定的安装路径。

     ./Ascend-docker-runtime_{version}_linux-{arch}.run --install --install-path=<path>

   回显示例如下，表示安装成功。

   Uncompressing ascend-docker-runtime  100%
   [INFO]: installing ascend docker runtime
   ...
   [INFO] Ascend Docker Runtime install success

5. 执行以下命令，使Ascend Docker Runtime生效。

   systemctl daemon-reload && systemctl restart docker

   如果用户在Docker的daemon.json文件中配置了“{"live-restore": true }”选项，且此时已部署了Ascend Device Plugin，则Ascend Docker Runtime安装之后重启容器时，不能成功重启Ascend Device Plugin组件。请在安装Ascend Docker Runtime后，重新安装部署Ascend Device Plugin组件。

Containerd场景下安装Ascend Docker Runtime

1. 安装包下载完成后，首先进入安装包（run包）所在路径。

   cd <path to run package>

2. 执行如下命令，校验软件包安装文件的一致性和完整性。

   ./Ascend-docker-runtime_{version}_linux-{arch}.run --check

   回显示例如下：

   [WARNING]: --check is meaningless for Ascend-docker-runtime and will be discarded in the future
   Verifying archive integrity... ./Ascend-docker-runtime_5.0.0.2_linux-x86_64.run does not contain an embedded SHA256 checksum.
   ...
    All good.

3. 执行以下命令，为软件包添加可执行权限。

   chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run

4. 可通过以下命令安装Ascend Docker Runtime。
   • 安装到默认路径下。

     ./Ascend-docker-runtime_{version}_linux-{arch}.run --install

   • 安装到指定路径下，执行以下命令，“--install-path”参数为指定的安装路径。

     ./Ascend-docker-runtime_{version}_linux-{arch}.run --install --install-path=<path>

   回显示例如下，表示安装成功。

   Uncompressing ascend-docker-runtime  100%
   [INFO]: installing ascend docker runtime
   ...
   [INFO] Ascend Docker Runtime install success

5. 执行以下命令，修改Containerd配置文件。
   • Containerd无默认配置文件时，依次执行以下命令，创建并修改配置文件。

     mkdir /etc/containerd
     containerd config default > /etc/containerd/config.toml
     vim /etc/containerd/config.toml

   • Containerd已有配置文件时，打开并修改配置文件。

     vim /etc/containerd/config.toml

6. 根据实际情况修改config.toml的“runtime”为安装路径，示例如下加粗部分所示。

   ...
    [plugins."io.containerd.monitor.v1.cgroups"] 
      no_prometheus = false 
    [plugins."io.containerd.runtime.v1.linux"] 
      shim = "containerd-shim" 
      runtime = "/usr/local/Ascend/Ascend-Docker-Runtime/ascend-docker-runtime" 
      runtime_root = "" 
      no_shim = false 
      shim_debug = false 
    [plugins."io.containerd.runtime.v2.task"] 
      platforms = ["linux/amd64"] 
   ...

7. 执行以下命令，重启Containerd。

   systemctl daemon-reload && systemctl restart containerd

Ascend Docker Runtime日志路径为“/var/log/ascend-docker-runtime/”。

Ascend Docker Runtime安装包命令行参数说明

参数说明如表1所示。