首页
产品
解决方案
开发者
合作伙伴
高校
昇腾AI市场
产业资讯
支持与服务
文档HOT
下载
中文
注册
文档首页
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
提交
在线提单
论坛求助
昇腾小AI

安装Ascend Docker Runtime

安装场景

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

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

Docker场景下安装Ascend Docker Runtime

K8s集成Docker场景安装Ascend Docker Runtime，与Docker场景下安装Ascend Docker Runtime操作一致。

  1. 安装包下载完成后，首先进入安装包（run包）所在路径。
    cd <path to run package>
  2. 执行以下命令，为软件包添加可执行权限。
    chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
  3. 执行如下命令，校验软件包安装文件的一致性和完整性。
    ./Ascend-docker-runtime_{version}_linux-{arch}.run --check
    回显示例如下： 
    Verifying archive integrity... ./Ascend-docker-runtime_{version}_linux-{arch}.run does not contain an embedded SHA256 checksum.
...
  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>
    回显示例如下，表示安装成功。 
    Verifying archive integrity... All good.
...
[INFO]: The version of Ascend Docker Runtime is: xxx
please reboot daemon and container engine to take effect
  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
    回显示例如下： 
    Verifying archive integrity... ./Ascend-docker-runtime_{version}_linux-{arch}.run does not contain an embedded SHA256 checksum.
...
 
Uncompressing ascend-docker-runtime 100%
  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>
    回显示例如下，表示安装成功。 
    Verifying archive integrity... All good.
...
[INFO]: The version of Ascend Docker Runtime is: xxx
please reboot daemon and container engine to take effect
  5. 执行以下命令，修改Containerd配置文件。
    • Containerd无默认配置文件时，依次执行以下3条命令，创建并修改配置文件。
      mkdir /etc/containerd
containerd config default > /etc/containerd/config.toml
vim /etc/containerd/config.toml
    • Containerd已有配置文件时，打开并修改配置文件。
      vim /etc/containerd/config.toml
  6. 根据实际情况修改“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

K8s集成Containerd场景下安装Ascend Docker Runtime

  1. 安装包下载完成后，首先进入安装包（run包）所在路径。
    cd <path to run package>
  2. 执行如下命令，校验软件包安装文件的一致性和完整性。
    ./Ascend-docker-runtime_{version}_linux-{arch}.run --check
    回显示例如下： 
    Verifying archive integrity... ./Ascend-docker-runtime_{version}_linux-{arch}.run does not contain an embedded SHA256 checksum.
...
 
Uncompressing ascend-docker-runtime 100%
  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>
    回显示例如下，表示安装成功。 
    Verifying archive integrity... All good.
...
[INFO]: The version of Ascend Docker Runtime is: xxx
please reboot daemon and container engine to take effect
  5. 修改Containerd配置文件“/etc/containerd/config.toml”。
    根据实际情况修改返回类型和runtime安装路径，示例如下加粗部分所示。 
        [plugins."io.containerd.grpc.v1.cri".containerd.runtimes] 
       [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc] 
         runtime_type = "io.containerd.runtime.v1.linux" 
         runtime_engine = "" 
         runtime_root = "" 
         privileged_without_host_devices = false 
         base_runtime_spec = "" 
         [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options] 
   [plugins."io.containerd.grpc.v1.cri".cni] 
     bin_dir = "/opt/cni/bin" 
     conf_dir = "/etc/cni/net.d" 
     max_conf_num = 1 
     conf_template = "" 
 [plugins."io.containerd.grpc.v1.cri".registry] 
     [plugins."io.containerd.grpc.v1.cri".registry.mirrors] 
       [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"] 
         endpoint = ["https://registry-1.docker.io"] 
 [plugins."io.containerd.grpc.v1.cri".image_decryption] 
     key_model = "" 
 
...
 [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"] 
...
  6. 修改节点上kubelet的配置文件kubeadm-flags.env。
    vi /var/lib/kubelet/kubeadm-flags.env

    增加如下加粗内容，其他参数已省略。

    KUBELET_KUBEADM_ARGS="... --container-runtime=remote --container-runtime-endpoint=/run/containerd/containerd.sock ..."
  7. 如果存在Docker或者iSula服务，请执行以下命令停止对应服务。
    systemctl stop docker isula
  8. 执行命令，重启Containerd和kubelet，示例如下。
    systemctl daemon-reload && systemctl restart containerd kubelet

iSula场景下安装Ascend Docker Runtime

  1. iSula容器需要使用runC作为容器运行时，请确保主机上安装了runC。
  2. 安装包下载完成后，首先进入安装包（run包）所在路径。
    cd <path to run package>
  3. 执行如下命令，校验软件包安装文件的一致性和完整性。
    ./Ascend-docker-runtime_{version}_linux-{arch}.run --check
    回显示例如下： 
    Verifying archive integrity... ./Ascend-docker-runtime_{version}_linux-{arch}.run does not contain an embedded SHA256 checksum.
...
Uncompressing ascend-docker-runtime 100%
  4. 执行以下命令，为软件包添加可执行权限。
    chmod u+x Ascend-docker-runtime_{version}_linux-{arch}.run
  5. 可通过以下命令安装Ascend Docker Runtime。
    • 安装到默认路径下，需要依次执行以下两条命令。
      ./Ascend-docker-runtime_{version}_linux-{arch}.run --install --ce=isula
    • 安装到指定路径下，需要依次执行以下两条命令，“--install-path”参数为指定的安装路径。
      ./Ascend-docker-runtime_{version}_linux-{arch}.run --install --ce=isula --install-path=<path>
    回显示例如下，表示安装成功。 
    Verifying archive integrity... All good.
...
[INFO]: The version of Ascend Docker Runtime is: xxx
please reboot daemon and container engine to take effect
  6. 执行以下命令，使Ascend Docker Runtime生效。
    systemctl daemon-reload && systemctl restart isulad

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

在同时使用Docker与iSula的场景下，若只需要其中一个容器引擎使用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，只需增加或修改iSula对应的daemon.json的runtimes字段。同时，用户在卸载Ascend Docker Runtime时只需进行一次卸载操作，卸载之后完成后需要手动将另一引擎的daemon.json文件还原为Ascend Docker Runtime安装之前的内容。

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

参数说明如表1所示。

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

参数

说明

--help | -h

查询帮助信息。

--info

查询软件包构建信息。在未来某个版本将废弃该参数。

--list

查询软件包文件列表。在未来某个版本将废弃该参数。

--check

检查软件包的一致性和完整性。在未来某个版本将废弃该参数。

--quiet

静默安装，跳过交互式信息，需要配合install、uninstall或者upgrade使用。在未来某个版本将废弃该参数。

--nox11

不使用x11模式运行。在未来某个版本将废弃该参数。

--noexec

解压软件包到当前目录，但不执行安装脚本。配套--extract=<path>使用，格式为--noexec --extract=<path>。在未来某个版本将废弃该参数。

--extract=<path>

解压软件包中文件到指定目录，需要配合--noexec参数一起使用。在未来某个版本将废弃该参数。

--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>
仅支持在以下产品安装或升级Ascend Docker Runtime包时使用该参数：
  • Atlas 200 AI加速模块（RC场景）、
  • Atlas 200I SoC A1 核心板、
  • Atlas 500 智能小站（型号 3000）、
  • Atlas 500 A2 智能小站、
  • Atlas 200I A2 加速模块

Atlas 200I DK A2 开发者套件

该参数用于设置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一起使用，不能单独使用。

--version

打印Ascend Docker Runtime版本。
父主题： 手动安装
搜索结果
找到“0”个结果

当前产品无相关内容

未找到相关内容，请尝试其他搜索词