如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
从RAPIDS v23.08版本开始,此Docker仓库已弃用。
base类型镜像由 https://hub.docker.com/r/rapidsai/base 替代runtime类型镜像由 https://hub.docker.com/r/rapidsai/notebooks 替代devel类型镜像不再支持完整变更列表请参见 https://github.com/rapidsai/docker/issues/539%E3%80%82
访问 rapids.ai 获取更多信息。
RAPIDS软件库套件让您能够完全在GPU上执行端到端的数据科学和分析管道。它依赖NVIDIA® CUDA®原语进行底层计算优化,但通过用户友好的Python接口公开GPU并行性和高带宽内存速度。
注意: 请查看下方前提条件部分,确保您的系统满足RAPIDS的最低要求。
23.06镜像中包含的库版本:
cuDF https://github.com/rapidsai/cudf/tree/v23.06.00%E3%80%81%60cuML%60 https://github.com/rapidsai/cuml/tree/v23.06.00%E3%80%81%60cuGraph%60 https://github.com/rapidsai/cugraph/tree/v23.06.00%E3%80%81%60RMM%60 https://github.com/rapidsai/RMM/tree/v23.06.00%E3%80%81%60RAFT%60 https://github.com/rapidsai/raft/tree/v23.06.00%E3%80%81%60cuSpatial%60 https://github.com/rapidsai/cuspatial/tree/v23.06.00%E3%80%81%60cuSignal%60 https://github.com/rapidsai/cusignal/tree/v23.06.00%E3%80%81%60cuxfilter%60 https://github.com/rapidsai/cuxfilter/tree/v23.06.00RAPIDS镜像基于 https://hub.docker.com/r/nvidia/cuda%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%BD%9C%E4%B8%BA%E7%9B%B8%E5%BA%94CUDA%E9%95%9C%E5%83%8F%E7%9A%84%E7%9B%B4%E6%8E%A5%E6%9B%BF%E4%BB%A3%E5%93%81%EF%BC%8C%E4%BB%A5%E4%BE%BF%E5%9C%A8%E6%B7%BB%E5%8A%A0RAPIDS%E5%BA%93%E7%9A%84%E5%90%8C%E6%97%B6%E4%BF%9D%E6%8C%81%E5%AF%B9%E7%8E%B0%E6%9C%89CUDA%E5%BA%94%E7%94%A8%E7%9A%84%E6%94%AF%E6%8C%81%E3%80%82
RAPIDS镜像分为三种类型,分布在两个不同的仓库中:
https://hub.docker.com/r/rapidsai/rapidsai-core/tags 仓库包含:
base - 包含可直接使用的RAPIDS环境。
runtime - 扩展base镜像,添加了Notebook服务器和示例Notebook。
本仓库(rapidsai/rapidsai-core-dev)包含:
devel - 包含完整的RAPIDS源代码树,预构建所有工件,以及用于RAPIDS开发的编译器工具链、调试工具、头文件和静态库。
RAPIDS镜像的标签命名方案将关键平台细节整合到标签中,如下所示:
23.06-cuda11.8-devel-ubuntu22.04-py3.10 ^ ^ ^ ^ ^ | | 类型 | Python版本 | | | | CUDA版本 | | | RAPIDS版本 Linux版本
推荐 - Docker CE v19+ 和 nvidia-container-toolkit
bash$ docker pull rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10 $ docker run --gpus all --rm -it -p 8888:8888 -p 8787:8787 -p 8786:8786 \ rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10
旧版 - Docker CE v18 和 nvidia-docker2
bash$ docker pull rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10 $ docker run --runtime=nvidia --rm -it -p 8888:8888 -p 8787:8787 -p 8786:8786 \ rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10
devel容器使用以下端口:
8888 - 暴露 JupyterLab Notebook服务器8786 - 暴露 Dask 调度器8787 - 暴露Dask 诊断Web服务器以下环境变量可传递给docker run命令:
DISABLE_JUPYTER - 设置为true可禁用默认启动的Jupyter服务器JUPYTER_FG - 设置为true可将Jupyter服务器在前台启动而非后台EXTRA_APT_PACKAGES -(仅Ubuntu镜像)用于在容器中安装额外的apt包。使用空格分隔的列表值APT_TIMEOUT -(仅Ubuntu镜像)apt命令应等待的时间(秒)EXTRA_YUM_PACKAGES -(仅CentOS镜像)用于在容器中安装额外的yum包。使用空格分隔的列表值YUM_TIMEOUT -(仅CentOS镜像)yum命令应等待的时间(秒)EXTRA_CONDA_PACKAGES - 用于在容器中安装额外的conda包。使用空格分隔的列表值CONDA_TIMEOUT - conda命令应等待的时间(秒)EXTRA_PIP_PACKAGES - 用于在容器中安装额外的pip包。使用空格分隔的列表值PIP_TIMEOUT - pip命令应等待的时间(秒)示例:
sh$ docker run \ --rm \ -it \ --gpus all \ -e EXTRA_APT_PACKAGES="vim nano" \ -e EXTRA_CONDA_PACKAGES="jq" \ -e EXTRA_PIP_PACKAGES="beautifulsoup4" \ -p 8888:8888 \ -p 8787:8787 \ -p 8786:8786 \ rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10
将文件/文件夹挂载到以下位置可为镜像提供额外功能。
/opt/rapids/environment.yml - 包含conda要安装的依赖列表的YAML文件。文件应如下所示:ymldependencies: - beautifulsoup4 - jq
示例:
sh$ docker run \ --rm \ -it \ --gpus all \ -v $(pwd)/environment.yml:/opt/rapids/environment.yml \ rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10
23.06容器中的Notebook位于以下目录:
/rapids/notebooks/cugraph - cuGraph演示Notebook/rapids/notebooks/cuml - cuML演示Notebook/rapids/notebooks/cusignal - cuSignal演示Notebook/rapids/notebooks/cuxfilter - cuXfilter演示Notebook/rapids/notebooks/cuspatial - cuSpatial演示Notebook/rapids/notebooks/xgboost - XGBoost演示Notebook每个Notebook的完整描述,请参见Notebooks仓库中的https://github.com/rapidsai/notebooks/blob/branch-23.06/README.md%E3%80%82
所有RAPIDS镜像使用conda作为包管理器,所有RAPIDS包(包括源码构建的)都在rapids conda环境中可用。如果要扩展RAPIDS镜像(如使用FROM),则在Dockerfile的所有RUN命令开头必须包含source activate rapids。否则,由于默认使用base环境,docker构建上下文将无法访问RAPIDS库。示例可在我们自己的Dockerfile中找到,位于GitHub上的https://github.com/rapidsai/docker%E3%80%82
您可以自由修改上述步骤。例如,可使用自己的数据启动交互式会话:
推荐 - Docker CE v19+ 和 nvidia-container-toolkit
bash$ docker run --gpus all --rm -it -p 8888:8888 -p 8787:8787 -p 8786:8786 \ -v /path/to/host/data:/rapids/my_data \ rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10
旧版 - Docker CE v18 和 nvidia-docker2
bash$ docker run --runtime=nvidia --rm -it -p 8888:8888 -p 8787:8787 -p 8786:8786 \ -v /path/to/host/data:/rapids/my_data \ rapidsai/rapidsai-core-dev:23.06-cuda11.8-devel-ubuntu22.04-py3.10
这会将主机操作系统的数据映射到容器操作系统的/rapids/my_data目录。您可能需要修改提供的Notebook以适应新的数据路径。
您可以在JupyterLab Notebook中使用?命令查看RAPIDS API的文档,如下所示:
[1] ?cudf.read_csv
这会打印函数签名及其使用文档。如果不够,可使用??查看函数的完整代码:
[1] ??pygdf.read_csv
查看RAPIDS 文档获取更详细信息和RAPIDS 速查表。
查看 RAPIDS 和 XGBoost API文档。
通过遵循https://github.com/rapidsai/notebooks%EF%BC%8C%E4%BA%86%E8%A7%A3%E5%A6%82%E4%BD%95%E8%AE%BE%E7%BD%AE%E5%A4%9A%E8%8A%82%E7%82%B9cuDF%E5%92%8CXGBoost%E6%95%B0%E6%8D%AE%E5%87%86%E5%A4%87%E5%8F%8A%E5%88%86%E5%B8%83%E5%BC%8F%E8%AE%AD%E7%BB%83%E7%8E%AF%E5%A2%83%E3%80%82
请将容器相关问题提交到此GitHub仓库:https://github.com/rapidsai/docker/issues/new
对于cuDF、cuML、RMM等RAPIDS库的问题,请在相关GitHub项目中提交issue。
更多帮助可在 Stack Overflow 或 Google Groups 找到。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




来自真实用户的反馈,见证轩辕镜像的优质服务