安装Ascend Docker Runtime

环境准备

Docker版本需要在18.03以上版本。
宿主机已安装驱动和固件，详情请参见《CANN 软件安装指南》的“环境准备 -> 软件安装 -> 准备硬件环境”章节。

安装

安装Ascend Docker Runtime可执行如下步骤。

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

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

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

安装成功后需要运行以下命令让Ascend Docker Runtime生效。
```
systemctl daemon-reload && systemctl restart docker
```

目前只支持root用户安装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”已被删除。若3.0.0版本之前的Ascend Docker Runtime是通过ToolBox安装包安装的，则该文件不存在，不需要删除。若不指定，将安装到默认路径“/usr/local/Ascend”中。若通过该参数指定了安装目录，运行用户需要对指定的安装路径有可读写权限。
--uninstall	卸载已安装的软件。
--upgrade	升级已安装的软件。
--install-type=<type>	仅支持在A200（RC场景）、A200I SoC A1和A500上安装Ascend Docker Runtime包时使用。指定安装的产品类型，用于在执行安装（--install）时指定部分产品（A200、A200ISoC、A500）。该参数需要配合“--install”一起使用。

Atlas 200 AI加速模块（RC场景）、Atlas 200I SoC A1核心板和Atlas 500 智能小站（型号 3000）支持Ascend Docker Runtime工具，安装或升级时需指定--install-type=<type>用于设置Ascend Docker Runtime的默认挂载：
Atlas 200 AI加速模块（RC场景）安装时执行如下命令：
./Ascend- docker-runtime_{version}_linux-{arch}.run --install --install-type=A200
Atlas 200I SoC A1核心板安装时执行如下命令：
./Ascend- docker-runtime_{version}_linux-{arch}.run --install --install-type=A200ISoC
Atlas 500 智能小站（型号 3000）安装时执行如下命令：
./Ascend- docker-runtime_{version}_linux-{arch}.run --install --install-type=A500

升级

在升级Ascend Docker Runtime时，可执行如下步骤升级。

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

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

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

升级成功后需要运行以下命令让新版Ascend Docker Runtime生效。
```
systemctl daemon-reload && systemctl restart docker
```

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

父主题： 常用操作