跳转至

环境搭建

1. 开发环境准备

📝 IPU_Toolchain基于AVX2指令集编写,请使用支援AVX2的处理器运行。

推荐配置

🖥️💻 ⚙️
CPU Intel® Xeon® Gold 6242 or Higher
RAM 256G or Higher

最低配置

🖥️💻 ⚙️
CPU Intel® CoreTM i7
RAM 32G

1.1 安装Docker开发环境

加载 SGS docker 镜像文件.

tar -Jxvf sgs_docker_v1.8.tar.xz
docker load < sgs_docker_v1.8.tar

运行 SGS docker.

./run_docker.sh

使用须知

对 run_docker.sh 内docker run的参数解释如下,用户可以根据个人需要修改参数配置:

  • -i / --interactive:保持容器的标准输入(stdin)打开,允许用户与容器进行交互。
  • -t / --tty:分配一个伪终端(pseudo-TTY),通常与 -i 一起使用,以便在容器中获得一个交互式的 shell。
  • --net=host:使用宿主机的网络栈。
  • --privileged:开启容器的特权模式,容器将拥有对宿主机设备和功能的访问权限,如挂载设备、使用内核模块等。
  • --name:为这个容器指定一个名称,方便以后其他 docker 操作。
  • --ulimit core=-1:设置容器的 core 文件生成限制,-1 表示取消限制,允许生成任意大小的 core 文件。
  • -v /:/work:将宿主机的文件目录 / 挂载到容器的 /work 目录,如果容器内没有 /work 路径,会自动创建。
  • env LANG=C.UTF-8:在容器中执行时,设置环境变量 LANG=C.UTF-8,用于指定语言和字符编码,确保容器中的应用正确地支持 UTF-8 编码。
  • /bin/bash:在容器启动后执行的命令,即启动一个 Bash shell,-it 保证可以与这个 shell 交互。

使用须知

更多有关docker的问题可以参考链接


1.2 SGS_IPU_Toolchain工具链环境设置

使用须知

新创建的docker容器内不包含IPU Toolchain。请从容器内的挂载路径上获取IPU Toolchain(挂载路径见run_docker.sh里的 -v 参数指定),或者使用docker cp命令拷贝IPU Toolchain到容器内使用。

进入SGS_IPU_Toolchain工具链目录设置环境。

cd /path/to/SGS_IPU_Toolchain
source cfg_env.sh