Run Shell/Run Task

执行Run Task操作后，系统将根据用户配置分配计算资源并启动分布式任务，同时生成对应的Session会话，供用户进行统一管理。无论任务执行成功、异常失败或用户手动终止任务，系统均会自动回收并释放任务占用的计算资源。
执行Run Shell 操作后，系统将根据用户配置分配计算资源并创建单机任务，同时生成对应的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一致，参数查看页面如下图所示。企业注册

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

参数名称	说明	是否必须	备注
Name	会话名称输入框。用于给当前运行的任务或会话命名，方便后续识别和管理。	是	不超过30个字符。
Configurations	配置选择下拉菜单。允许用户加载之前保存的参数组合。	否	-
File	启动脚本/文件路径。指定任务启动时要执行的主程序文件。	-	通常指向 Python 训练脚本。
Environment	运行环境镜像选择。决定任务运行的基础操作系统、CUDA 版本及预装库。分布式训练任务（Run Task）需选择Worker节点数，Worker节点数不超过`8`。	是	所选资源不超过当前使用VKS的GPU资源总额。
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”按钮，系统自动创建会话，您可查看管理当前会话，操作详情如下表所示。

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