安装Ascend Docker Runtime

环境准备

当前环境的Docker版本需要为18.03及以上版本。
宿主机已安装驱动和固件，详情请参见《CANN 软件安装指南》的“环境准备 -> 软件安装 -> 准备硬件环境”章节。
Atlas 500 A2 智能小站安装Ascend Docker Runtime需要修改Docker配置。执行vi /etc/sysconfig/docker命令，将--config-file=""参数删除。

安装场景

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

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

Docker场景
Containerd场景
iSula场景
iSula与Docker混合使用场景

Docker场景下安装Ascend Docker Runtime

安装包下载完成后，首先进入安装包（run包）所在路径。
```
cd <path to run package>
```

可通过以下命令安装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>

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

安装包下载完成后，首先进入安装包（run包）所在路径。
```
cd <path to run package>
```

可通过以下命令安装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>

执行以下命令，修改Containerd配置文件。
- Containerd无默认配置文件时，依次执行以下3条命令，创建配置文件。
```
mkdir /etc/containerd
containerd config default > /etc/containerd/config.toml
vim /etc/containerd/config.toml
```
- Containerd有配置文件时
```
vim /etc/containerd/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"] 
...

执行以下命令，重启Containerd。

systemctl daemon-reload && systemctl restart containerd

iSula场景下安装Ascend Docker Runtime

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

可通过以下命令安装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>

执行以下命令，使Ascend Docker Runtime生效。
```
systemctl daemon-reload && systemctl restart isulad
```

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

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

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

情况一：使用不同安装路径
 请分别参照Docker场景和iSula场景安装Ascend Docker Runtime，只是需要在使用run包执行安装命令时需要加上--install-path=<path>参数来指定不同的安装路径。同时，用户在卸载Ascend Docker Runtime时也需要针对不同容器引擎进行两次卸载，每次卸载时需要指定相应的安装路径。

情况二：使用相同安装路径
 请参照Docker场景或iSula场景其中一种场景安装Ascend Docker Runtime，安装完成后，需要修改另一容器引擎的daemon.json文件。

如：已参照Docker场景安装了Ascend Docker Runtime，只需参考Ascend Docker Runtime的daemon.json增加或修改iSula对应的daemon.json的default-runtime与runtimes字段。同时，用户在卸载Ascend Docker Runtime时只需进行一次卸载操作，卸载之后完成后需要手动将另一引擎的daemon.json文件还原为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，执行如下步骤进行升级操作。

安装包下载完成后，首先进入安装包（run包）所在路径。
```
cd <path to run package>
```

通过以下命令升级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>

执行以下命令，使新版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安装包。

父主题： 常用操作