安装Ascend Docker Runtime

环境准备

安装场景

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

用户需要根据环境的容器引擎的安装和使用情况决定Ascend Docker Runtime的安装场景；常见的Ascend Docker Runtime安装场景如下。

Docker场景下安装Ascend Docker Runtime

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

    cd <path to run package>

  2. 可通过以下命令安装Ascend Docker Runtime。

    • 安装到默认路径下，需要依次执行以下两条命令。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --install
    • 安装到指定路径下，需要依次执行以下两条命令，<path>参数为指定的安装路径。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --install --install-path=<path>

  3. 执行以下命令，使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。

    • 安装到默认路径下，依次执行以下两条命令。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --install
    • 安装到指定路径下，依次执行以下两条命令，<path>参数为指定的安装路径。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --install --install-path=<path>

  3. 执行以下命令，修改Containerd配置文件。

    • Containerd无默认配置文件时，依次执行以下3条命令，创建配置文件。
      mkdir /etc/containerd
containerd config default > /etc/containerd/config.toml
vim /etc/containerd/config.toml
    • Containerd有配置文件时
      vim /etc/containerd/config.toml

  4. 根据实际情况修改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"] 
...

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

    systemctl daemon-reload && systemctl restart containerd

iSula场景下安装Ascend Docker Runtime

  1. iSula容器需要使用runC作为容器运行时，请确保主机上安装了runC。
  2. 安装包下载完成后，首先进入安装包（run包）所在路径。

    cd <path to run package>

  3. 可通过以下命令安装Ascend Docker Runtime。

    • 安装到默认路径下，需要依次执行以下两条命令。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --install --ce=isula
    • 安装到指定路径下，需要依次执行以下两条命令，<path>参数为指定的安装路径。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --install --ce=isula --install-path=<path>

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

    systemctl daemon-reload && systemctl restart isulad

iSula与Docker混合使用场景下安装Ascend Docker Runtime

在同时使用iSula与Docker的场景下，若只需要其中一个容器引擎使用Ascend Docker Runtime，参考以上相应场景进行安装即可。

若需要两种容器引擎都使用Ascend Docker Runtime，相应操作步骤如下：

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

参数说明如表 安装包支持的参数说明所示。

表1 安装包支持的参数说明

参数

说明

--help | -h

查询帮助信息。

--info

查询软件包构建信息。

--list

查询软件包文件列表。

--check

检查软件包的一致性和完整性。

--quiet | -q

静默安装，跳过交互式信息，需要配合install、uninstall或者upgrade使用。

--nox11

不使用x11模式运行。

--noexec

解压软件包到当前目录，但不执行安装脚本。配套--extract=<path>使用，格式为：

--noexec --extract=<path>。

--extract=<path>

解压软件包中文件到指定目录。

--tar arg1 [arg2 ...]

对软件包执行tar命令，使用tar后面的参数作为命令的参数。例如执行--tar xvf命令，解压run安装包的内容到当前目录。

--install

安装软件包。后面可以指定安装路径--install-path=<path>，也可以不指定安装路径，直接安装到默认路径下。

--install-path=<path>

指定安装路径。当环境上存在全局配置文件“ascend_dcoker_runtime_install.info”时，指定的安装路径必须与全局配置文件中保存的安装路径保持一致。如用户想更换安装路径，需先卸载原路径下的Ascend Docker Runtime软件包并确保全局配置文件“ascend_dcoker_runtime_install.info”已被删除。若5.0.RC1版本之前的Ascend Docker Runtime是通过ToolBox安装包安装的，则该文件不存在，不需要删除。

若不指定，将安装到默认路径“/usr/local/Ascend”中。

若通过该参数指定了安装目录，运行用户需要对指定的安装路径有可读写权限。

--uninstall

卸载已安装的软件。如果安装时指定了安装路径，那么卸载时也需要指定安装路径，安装路径的参数为--install-path=<path>。

--upgrade

升级已安装的软件。如果安装时指定了安装路径，那么升级时也需要指定安装路径，安装路径的参数为--install-path=<path>。

--install-type=<type>

仅支持在Atlas 200 AI加速模块（RC场景）、Atlas 200I SoC A1 核心板、Atlas 500 智能小站（型号 3000）、Atlas 500 A2 智能小站、Atlas 200I A2 加速模块和Atlas 200I DK A2 开发者套件上安装或升级Ascend Docker Runtime包时使用，用于设置这几种场景下Ascend Docker Runtime的默认挂载内容，且需要配合“--install”一起使用，格式为：--install --install-type=<type>。<type>可选值为：

  • A200
  • A200ISoC
  • A500
  • A500A2
  • A200IA2（支持Atlas 200I A2 加速模块和Atlas 200I DK A2 开发者套件）

--ce=<ce>

仅在使用iSula启动容器时需要指定该参数，参数值为isula，并且需要配合--install或者--uninstall一起使用，不能单独使用。

升级

目前只支持root用户升级Ascend Docker Runtime，执行如下步骤进行升级操作。

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

    cd <path to run package>

  2. 通过以下命令升级Ascend Docker Runtime。

    • 在默认路径下升级Ascend Docker Runtime，需要依次执行以下2条命令。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --upgrade
    • 在指定路径下升级Ascend Docker Runtime，需要依次执行以下2条命令，<path>参数为指定的升级路径。
      chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
./Ascend-docker-runtime_{version}_linux-{arch}.run --upgrade --install-path=<path>

  3. 执行以下命令，使新版Ascend Docker Runtime生效。

    • Docker场景
      systemctl daemon-reload && systemctl restart docker
    • Containerd场景
      systemctl daemon-reload && systemctl restart containerd
    • iSula场景
      systemctl daemon-reload && systemctl restart isulad

若当前的Ascend Docker Runtime是通过ToolBox安装包安装的，升级时需要从ToolBox安装路径中找到Ascend Docker Runtime的script路径，执行uninstall.sh脚本将3.0.0版本之前的Ascend Docker Runtime卸载，然后下载新的Ascend Docker Runtime安装包进行安装，安装完成后需要重启服务器。可参考软件包说明获取Ascend Docker Runtime安装包。

父主题： 常用操作