From 50683e04df64fd75d00754a973e9745f3385515e Mon Sep 17 00:00:00 2001 From: Ziqiang Zhang Date: Tue, 17 Nov 2026 23:22:08 +0800 Subject: [PATCH] docs: configure GPU and shared memory for distributed Docker training --- docs/guides/06_distributed_training/deployment_cn.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/guides/06_distributed_training/deployment_cn.rst b/docs/guides/06_distributed_training/deployment_cn.rst index e076eaeeeda..08915872939 100644 --- a/docs/guides/06_distributed_training/deployment_cn.rst +++ b/docs/guides/06_distributed_training/deployment_cn.rst @@ -52,10 +52,11 @@ paddle 环境安装 .. code-block:: - $ docker run --name paddle -it --net=host -v $PWD:/paddle ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:2.2.2-gpu-cuda11.2-cudnn8 /bin/bash + $ docker run --gpus all --name paddle -it --net=host -v "$PWD:/paddle" -v /dev/shm:/dev/shm ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:2.2.2-gpu-cuda11.2-cudnn8 /bin/bash -* 当使用 gpu 时请配置 nvidia docker runtime 或使用 nvidia-docker 启动容器,进入容器后使用 nvidia-smi 命令确认环境正确 -* 使用分布式时需要添加 --net=host 参数让容器使用主机网络以实现跨机建立连接 +* 使用 GPU 时,先安装并配置 `NVIDIA Container Toolkit `_,再通过 ``--gpus all`` 向容器开放 GPU;进入容器后使用 ``nvidia-smi`` 命令确认环境正确。 +* 使用分布式时需要添加 ``--net=host`` 参数,让容器使用主机网络以实现跨机建立连接。 +* 多卡训练需要足够的共享内存。``-v /dev/shm:/dev/shm`` 将主机的共享内存目录挂载到容器,避免容器默认共享内存容量不足导致训练失败。 安装后,运行以下命令