安装Ascend Docker Runtime

安装场景

目前只支持root用户安装、升级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所示。