GPU Run/Debug

GPU凭借大量线程实现高度并行计算，适合处理数据量大、计算密集且逻辑分支简单的任务。在深度学习中，面对海量数据，GPU通过众多流处理器（CUDA核心）同时处理多个数据，显著提升运算效率，大幅缩短训练和推理时间，相较CPU更具优势。

GPU Run：执行 GPU Run 操作后，系统将根据用户配置分配计算资源并启动预设的训练或推理任务。任务运行期间，系统会自动创建对应的 Session 会话，用于任务管理。任务执行成功、运行失败或用户手动终止任务后，系统将自动释放所占用的计算资源，并停止展示对应的 Session。
GPU Debug：执行 GPU Debug 操作后，系统将根据用户配置分配计算资源并建立远程调试环境。调试过程中，系统会自动创建对应的 Session 会话，用于调试管理。调试完成、调试失败或用户手动关闭调试后，系统将自动释放所占用的计算资源，并停止展示对应的 Session。

前提条件

用户已经配置适合当前代码项目的环境，如需尚未配置或需要帮助，请参考配置环境。

操作步骤

在远端页面，单击File/Open Folder选择持久化目录root或者capacity/vksdata下对应目录，capacity/vksdata路径详解如下所示。

企业注册

目录名称	用途	权限	备注
userdata	存放企业根目录下数据与应用数据。	只读 (Read-Only)，允许用户查看当前企业下的所有数据。	-
vksdata	VKS服务的专用数据目录。用于存储基于VKS创建的Workshop运行数据等文件。 - aim：用于存储当前workshop运行的监控数据。 - tasks：用于存储当前workshop相关任务的日志数据。 - workshops：用于存储当前workshop运行的工作空间数据。	读写 (Read-Write)，用户也可自定义路径。	非标准系统目录。

说明

当用户选择capacity/vksdata/workshops路径时，系统展示的待选目录与Workshop的Pod Name一致，参数查看页面如下图所示。企业注册

在远端页面对应目录下拖拽已有项目或者开发项目，打开待调试的.py文件，右键选择GPU Run/Debug菜单项，进入GPU Session参数配置页面，参数详解如下表。

参数名称	说明	是否必须	备注
Name	会话名称输入框。用于给当前运行的任务或会话命名，方便后续识别和管理。	否	若留空，系统通常会生成默认名称。
Configurations	配置选择下拉菜单。允许用户加载之前保存的参数组合。	否	-
File	启动脚本/文件路径。指定任务启动时要执行的主程序文件。	是	通常指向 Python 训练脚本。
Environment	运行环境镜像选择。决定任务运行的基础操作系统、CUDA 版本及预装库。	是	按需选择即可。
Resource	计算资源分配。选择任务运行时要使用资源类型，CPU或GPU。	是	根据任务所需资源进行选择即可。
CPU/GPU	选择CPU/GPU资源的详细配置。	是	- Ephemeral Storage：容器运行时的临时读写空间，容器销毁后数据会丢失。 - /dev/shm：共享内存大小，用于进程间通信（IPC）的内存。
Python Interpreter	Python 解释器路径。指定运行代码的具体 Python 版本。	是	-
自定义配置	可选择保存当前会话的设置也可选择运行后是否自动删除会话。	否	按需选择即可。
ENV	环境变量设置。以键值对形式传入配置，如 API Key、超参数等。	否	格式通常为 `key=value`，多个变量用分号隔开。敏感信息建议通过此处传递而非硬编码在代码中。
Args	启动参数。传递给启动脚本（File）的命令行参数。	否	例如训练脚本需要的 `--epochs 10 --batch_size 32` 等参数填在此处。
Python Module	Python模块启动命令。如果不直接运行脚本，可通过模块方式启动（如分布式训练）。	否	可用于多机多卡训练任务启动。
Work Dir	工作目录。容器启动后默认进入该路径。	否	例如训练脚本需要在 `/capacity/vksdata/workshop/`。代码中的相对路径读取都将基于此目录。
PVC MOUNTS	持久化存储挂载。将云端的存储卷（PVC）映射到容器内部的路径。	否	保存模型 checkpoints 的关键位置。
External Access	外部访问配置。用于开启端口映射成公网访问地址。	否	适用于需要对外提供服务（如SwanLab、TensorBoard等可视化）的场景。

参数配置完成后，单击Submit按钮，系统自动创建并默认运行GPU任务会话，您可查看管理当前会话，操作详情如下表所示。

功能名称	功能描述	适用场景
Start	启动会话。点击此选项将立即运行选中的开发任务或脚本。	当任务处于停止状态，或需要重新运行某个配置完成的会话。
Download Log	下载日志。将会话运行产生的完整日志文件保存到本地计算机。	当需要在本地深入分析报错信息、归档运行记录或离线排查问题时。
View Log	查看日志。在当前界面直接打开日志预览窗口，实时或历史查看输出内容。	当需要快速确认任务运行状态、查看控制台输出或进行即时调试时。
Delete	删除会话。将该会话条目从列表中移除。	当任务已完成、配置错误或不再需要保留该历史记录时。