
如果你使用 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。
重要提示: 如需最新稳定版本,请使用 https://hub.docker.com/r/rapidsai/rapidsai-dev 容器。
访问 https://rapids.ai 获取更多信息。
RAPIDS软件库套件使您能够完全在GPU上执行端到端的数据科学和分析管道。它依赖NVIDIA® CUDA®原语进行底层计算优化,同时通过用户友好的Python接口公开GPU并行性和高带宽内存速度。
注意: 请查看下方的先决条件部分,确保您的系统满足RAPIDS的最低要求。
rapidsai/rapidsai-dev-nightly仓库包含RAPIDS的每日Docker构建,包含当天合并到GitHub仓库的最新开发中变更,用于下一个RAPIDS版本。这些容器通常被认为是不稳定的,仅应用于开发和测试。如需最新稳定版本,请使用 https://hub.docker.com/r/rapidsai/rapidsai-dev 容器。
23.08镜像中包含的库版本:
cuDF https://github.com/rapidsai/cudf、`cuML` https://github.com/rapidsai/cuml、`cuGraph` https://github.com/rapidsai/cugraph、`RMM` https://github.com/rapidsai/RMM、`RAFT` https://github.com/rapidsai/raft、`cuSpatial` https://github.com/rapidsai/cuspatial、`cuSignal` https://github.com/rapidsai/cusignal、`cuxfilter` https://github.com/rapidsai/cuxfilter
dask-sql https://github.com/dask-contrib/dask-sql、`xgboost` https://github.com/rapidsai/xgboost、`dask-cuda` https://github.com/rapidsai/dask-cuda
RAPIDS镜像基于 https://hub.docker.com/r/nvidia/cuda 构建,旨在作为相应CUDA镜像的直接替代品,以便轻松添加RAPIDS库,同时保持对现有CUDA应用的支持。
RAPIDS镜像分为三种类型,分布在两个不同的仓库中:
https://hub.docker.com/r/rapidsai/rapidsai-nightly/tags 仓库包含:
base - 包含可直接使用的RAPIDS环境。
runtime - 扩展base镜像,添加了笔记本服务器和示例笔记本。
本仓库(rapidsai/rapidsai-dev-nightly)包含:
devel - 包含完整的RAPIDS源代码树,预构建了所有工件,以及编译器工具链、调试工具、头文件和静态库,用于RAPIDS开发。
RAPIDS镜像的标签命名规则将关键平台详细信息整合到标签中,如下所示:
23.08-cuda11.8-devel-ubuntu22.04-py3.10 ^ ^ ^ ^ ^ | | 类型 | Python版本 | | | | CUDA版本 | | | RAPIDS版本 Linux版本
推荐 - Docker CE v19+ 和 nvidia-container-toolkit
bash$ docker pull docker.xuanyuan.run/rapidsai/rapidsai-dev-nightly:23.08-cuda11.8-devel-ubuntu22.04-py3.10 $ docker run --gpus all --rm -it -p 8888:8888 -p 8787:8787 -p 8786:8786 \ rapidsai/rapidsai-dev-nightly:23.08-cuda11.8-devel-ubuntu22.04-py3.10
旧版 - Docker CE v18 和 nvidia-docker2
bash$ docker pull docker.xuanyuan.run/rapidsai/rapidsai-dev-nightly:23.08-cuda11.8-devel-ubuntu22.04-py3.10 $ docker run --runtime=nvidia --rm -it -p 8888:8888 -p 8787:8787 -p 8786:8786 \ rapidsai/rapidsai-dev-nightly:23.08-cuda11.8-devel-ubuntu22.04-py3.10
devel容器使用以下端口:
8888 - 公开 https://jupyterlab.readthedocs.io/en/stable/ 笔记本服务器8786 - 公开 https://docs.dask.org/en/latest/ 调度器8787 - 公开 Dask https://docs.dask.org/en/latest/setup/cli.html#diagnostic-web-servers以下环境变量可传递给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-dev-nightly:23.08-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-dev-nightly:23.08-cuda11.8-devel-ubuntu22.04-py3.10
23.08容器中的笔记本可在以下目录中找到:
/rapids/notebooks/cugraph - cuGraph演示笔记本/rapids/notebooks/cuml - cuML演示笔记本/rapids/notebooks/cusignal - cuSignal演示笔记本/rapids/notebooks/cuxfilter - cuXfilter演示笔记本/rapids/notebooks/cuspatial - cuSpatial演示笔记本/rapids/notebooks/xgboost - XGBoost演示笔记本有关每个笔记本的完整说明,请参见笔记本仓库中的https://github.com/rapidsai/notebooks/blob/branch-23.08/README.md。
所有RAPIDS镜像使用conda作为包管理器,所有RAPIDS包(包括源代码构建的)都在rapids conda环境中可用。如果要扩展RAPIDS镜像(例如使用FROM),则在Dockerfile的所有RUN命令开头必须包含source activate rapids。否则,docker构建上下文将无法访问RAPIDS库,因为它默认使用base环境。可在GitHub上的https://github.com/rapidsai/docker中的Dockerfile中找到此类示例。
您可以自由修改上述步骤。例如,您可以使用自己的数据启动交互式会话:
推荐 - 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-dev-nightly:23.08-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-dev-nightly:23.08-cuda11.8-devel-ubuntu22.04-py3.10
这会将主机操作系统的数据映射到容器操作系统的/rapids/my_data目录。您可能需要修改提供的笔记本以适应新的数据路径。
您可以在JupyterLab笔记本中使用?命令查看RAPIDS API的文档,如下所示:
[1] ?cudf.read_csv
这会打印函数签名及其使用文档。如果不够,您可以使用??查看函数的完整代码:
[1] ??pygdf.read_csv
有关更多详细信息和RAPIDS https://rapids.ai/assets/files/cheatsheet.pdf,请查看RAPIDS http://rapids.ai/start.html。
查看 https://docs.rapids.ai/api 和 https://xgboost.readthedocs.io/en/latest/ API文档。
通过遵循 https://github.com/rapidsai/notebooks,了解如何设置多节点cuDF和XGBoost数据准备及分布式训练环境。
请将容器相关问题提交到此GitHub仓库:https://github.com/rapidsai/docker/issues/new
对于cuDF、cuML、RMM等RAPIDS库的问题,请在相关GitHub项目中提交issue。
可在 https://stackoverflow.com/tags/rapids 或 https://groups.google.com/forum/#!forum/rapidsai 获取额外帮助。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务