Drylab

计算

连接服务器与 HPC

在云端、桌面应用和 CLI 三种方式中选一种,通过 SSH 把 Drylab 连接到你的服务器、HPC 或 Slurm 集群。

先看第 1 节选择你的方式。然后,桌面应用请按第 2 节操作,CLI 请按第 3 节操作。两套流程只需走一套。

桌面应用在设置中配置 SSH/Slurm,CLI 在安装过程中配置 SSH/Slurm。两套流程最后都会先检查连接,再进入文件和任务的通用说明。

CLI 流程不使用桌面应用:它会在服务器上安装一个本地运行时,之后你在浏览器中通过 Drylab 使用它。

1. 选择你的方式

先找到和你的文件位置、可用机器相符的那一行,再选一套流程:第 2 节的桌面应用流程,或第 3 节的 CLI 流程。

按文件位置和可用机器划分的设置方式

这里的服务器也可以指 HPC 系统或集群。不受限服务器允许安装 Drylab 运行时,并具备所需的网络连接。受限服务器通过 SSH 访问,可能限制安装软件或访问网络。

分析在哪里运行

分析在哪里运行

云端使用 Drylab 托管的计算资源;桌面应用在你的笔记本电脑上运行;CLI 在你的不受限服务器上运行。

连接受限服务器或 HPC

连接受限服务器或 HPC

桌面应用 + SSH 从你的笔记本电脑发起连接;CLI + SSH 从你的运行时服务器发起连接。

先确认网络路径:使用桌面应用 + SSH 时,你的笔记本电脑必须能访问目标机器;使用 CLI + SSH 时,你的运行时服务器必须能访问它。使用 CLI + SSH 时,请把笔记本电脑上的文件传到可访问的服务器上。

Slurm 是可选的:普通服务器用 SSH,Slurm 计算任务用调度器。建立 SSH 连接时,受限的目标机器上不需要安装 Drylab。

连接方式一览

连接方式一览

桌面应用 + CLI 要求运行时已安装在不受限服务器上并已连接。如果你在桌面应用中处理笔记本电脑上的文件,又无法直接通过 SSH 访问那台服务器,就用这种方式。运行分析前,请确认服务器能拿到输入文件。

选择一套流程

  • 云端: 在浏览器中打开 Drylab,无需安装运行时。
  • 桌面应用或桌面应用 + SSH: 按第 2 节操作;如果需要远程访问,还要完成 SSH/Slurm 设置。
  • CLI 或 CLI + SSH: 按第 3 节操作。如果需要远程访问,请在安装过程中配置 SSH/Slurm。
  • 桌面应用 + CLI: 先按第 3 节在服务器上安装运行时,再在桌面应用中选择这个运行时。

2. 桌面应用流程

桌面应用和桌面应用 + SSH 都用这套流程。本节的所有操作都在你的笔记本电脑或桌面应用中完成。

开始之前

  • 能登录你的 Drylab 账户,并有一台支持桌面应用的笔记本电脑。
  • 如果用 SSH,准备好目标主机名、用户名、端口(如果不是默认端口),并在笔记本电脑上配置好已授权的 SSH 凭据。
  • 确认你的笔记本电脑能访问目标机器(如需 VPN,请先连接)。
  • 如果用 Slurm,向管理员获取提交节点、账户、分区和资源限制。

A. 安装并打开桌面应用

  1. 从 Drylab 桌面应用下载页下载并安装桌面应用。请见安装桌面应用。
  2. 打开应用并登录,确认它可以正常使用。
只在笔记本电脑上工作?那设置已经完成了。后面的步骤用于通过 SSH/Slurm 连接远程服务器或 HPC。

B. 在笔记本电脑上检查 SSH

在笔记本电脑上打开终端,测试你获准使用的登录方式。把下面的示例换成你的目标机器或已配置的别名:

ssh your-user@cluster.example.edu

首次连接时,请和管理员核对主机身份。登录后确认主机名和用户名,然后退出。如果出现连接错误,先解决再继续。

建立 SSH 连接时,远程目标机器上不需要安装 Drylab 或 Docker,但仍需要具备你的分析所需的软件和权限。

C. 打开设置并启用 SSH

  1. 在桌面应用中打开个人资料菜单,选择 设置。

    从个人资料菜单打开设置

  2. 在侧边栏中选择 SSH 与 Slurm。这一项只在桌面应用中出现。如果看不到,请重启应用,让最新更新生效。

  3. 打开开关以启用访问(默认是关闭的)。

    启用 SSH 与 Slurm

桌面应用使用你笔记本电脑上的 SSH 配置和 agent。你的笔记本电脑必须一直能访问目标机器。

D. 添加 SSH 主机

  1. 在 服务器 下,选择 + Add Host。

  2. 输入连接字符串,例如 your-user@server-ip,然后选择 添加。

  3. 检查 密钥 下是否出现了预期的密钥,且状态为 可用。如果密钥设有密码短语,点击 解锁 并输入。密码短语只在本次会话中记住,不会写入磁盘,所以之后可能需要再次解锁。点击 稍后 可跳过。

    密钥 列出在 ~/.ssh 中找到的密钥,它们会一直留在你的笔记本电脑上。如果系统的 ssh-agent 中已经有密钥,沙箱会改用 agent,~/.ssh 中的密钥只列出来供参考。如果你的所有密钥都来自 agent,列表可能是空的,并显示“密钥由系统 ssh-agent 提供”,这是正常的。

添加主机并检查可用的 SSH 密钥

E. 按需配置 Slurm

如果是普通 SSH 服务器,保持 Slurm 集群 关闭。如果是 Slurm 集群,请启用它,并选择接受调度命令的主节点/登录节点。

F. 保存并应用

先保存你的工作,然后选择 保存并应用,再确认 应用并重启。这会重启沙箱管理程序和正在运行的沙箱。如果当前没有打开项目,按钮会显示为 保存,更改会在你下次打开项目时生效。在笔记本电脑上修改 SSH 配置或密钥后,用 重新加载 重新读取。

G. 验证连接

在 Drylab 中使用笔记本电脑环境,并发送:

在我配置好的 SSH 目标机器上,报告主机名和用户名,然后列出我项目目录中的文件。先不要开始分析。

检查成功后,继续看第 4 节,了解文件、命令、任务和结果。你不需要再走 CLI 流程。

3. CLI 流程

CLI 和 CLI + SSH 都用这套流程。在你的服务器上运行安装命令,然后在浏览器中打开 app.thedrylab.com 使用 Drylab,连接到这个运行时。

开始之前

  • 能在服务器上使用终端或获准的控制台,并有权限安装运行时。
  • 确认服务器能访问 Drylab 服务,并有一个可写的工作区。
  • 如果用 SSH,在这台服务器上配置好已授权的凭据,以及所需的 VPN(如有)。
  • 确认能从这台服务器通过 SSH 访问目标机器。只能从笔记本电脑访问是不够的。
  • 如果用 Slurm,向管理员获取提交节点、账户、分区和资源限制。
请在 CLI 安装过程中配置 SSH/Slurm。桌面应用的 SSH 与 Slurm 设置面板无法配置 CLI 运行时。启动安装程序前,请先准备好目标机器的信息。

如果需要远程访问,安装前先在服务器的终端中测试 SSH 登录:

ssh your-user@cluster.example.edu

把示例换成你的目标机器或别名。首次连接时核对主机身份,确认主机名和用户名,然后退出。

建立 SSH 连接时,远程目标机器上不需要安装 Drylab。Drylab 运行时装在你的服务器上,由它去连接目标机器。

桌面应用 + CLI: 同样按这套服务器安装流程操作,然后在桌面应用中选择已连接的运行时。即使你的笔记本电脑无法直接 SSH 到服务器,你或管理员也需要有办法在服务器上运行安装程序。

A. 打开设置

  1. 在浏览器中打开 Drylab,点击左侧边栏底部的工作区。
  2. 选择 设置。

从个人资料菜单打开设置

B. 进入本地计算

  1. 在设置侧边栏中选择 本地计算。
  2. 点击 新建,打开 创建本地运行环境。

本地计算设置

C. 生成并复制安装命令

  1. 输入 机器名称,例如 Lab Server。
  2. 选择 Docker 镜像:Drylab Notebook;如果是配有 NVIDIA GPU 的 Linux 服务器,选 Drylab Notebook GPU。
  3. 如果你的服务器有 CUDA GPU,把 选择 GPU 机器 设为 是。
  4. 点击 生成安装脚本。
  5. 点击 Run the install command in terminal 下方命令旁的复制图标。

生成安装脚本

请从你自己的设置面板中复制。截图中是示例值,不要照着图片输入命令。

D. 在服务器上运行命令

  1. 在服务器上打开终端。
  2. 粘贴并运行第 C 步复制的命令。
  3. 按安装程序的检查提示操作,并输入 Workspace path:这台服务器上一个可写的文件夹。

安装程序检查

随附的 Linux 安装程序会检查 Docker、Docker Compose 和网络连接。如有检查未通过,先解决再继续。工作区属于这台服务器,而不是你的笔记本电脑或另一台 SSH 目标机器。

在安装过程中设置 SSH/Slurm。 安装程序运行期间,继续完成第 E 步和第 F 步。如果使用 CLI 但没有 SSH 目标机器,在 SSH 和 Slurm 提示中回答 No,然后直接进入第 G 步。

E. 启用 SSH 并选择主机

  1. 在 Allow sandboxes to reach SSH hosts via a scoped agent?(允许沙箱通过限定范围的 agent 访问 SSH 主机?)处,选择 Yes。

    允许沙箱访问 SSH 主机

  2. 在 Select SSH hosts to allow(选择允许的 SSH 主机)中,按 Space 选中需要的目标机器。

  3. 如果列表中没有你的目标机器,使用 + Add a host not in ~/.ssh/config…,然后输入它的 Connection string(连接字符串,例如 your-user@cluster.example.edu)。

  4. 按 Tab 继续。(Space 或 Enter 可切换高亮主机的选中状态。)

    选择允许的 SSH 主机

这些主机、密钥和 SSH agent 都属于在服务器上运行 Drylab 运行时的那个账户。笔记本电脑上的密钥不会自动出现在那里。

F. 按需配置 Slurm

如果是普通 SSH 服务器,在 Slurm 提示中选择 No,然后进入第 G 步。

  1. 如果是 Slurm 集群,在 Enable Slurm integration?(启用 Slurm 集成?)处选择 Yes。

    启用 Slurm 集成

  2. 在 Slurm connection mode(Slurm 连接方式)中,选择 Drylab 与调度器通信的方式:

    • SSH to head node:通过 SSH 在登录节点上运行 Slurm 命令。
    • REST API:使用集群的 Slurm REST API;安装程序会要求你填写 Slurm REST API URL 和 Slurm User Token。
  3. 如果选的是 SSH 方式,在 Select Slurm head node(s)(选择 Slurm 主节点)中,按 Space 选中接受调度命令的节点。

  4. 按 Tab 确认。

    选择 Slurm 主节点

G. 完成安装并选择运行时

  1. 完成安装程序剩下的提示。
  2. 回到 Drylab 中的 本地计算。
  3. 检查 你现有的计算 下你的服务器状态是否从 disconnected 变为 pending,再变为 active。
  4. 在分析中点击机器按钮,打开 选择机器,并在 本地运行时 下选择这台服务器。

H. 验证连接

如果使用 CLI 但没有 SSH,检查运行时本身:

在当前选择的运行时上,报告主机名和工作目录,然后列出工作区中的文件。先不要开始分析。

如果使用 CLI + SSH,检查已配置的目标机器:

在我配置好的 SSH 目标机器上,报告主机名和用户名,然后列出我项目目录中的文件。先不要开始分析。

检查成功后,继续看第 4 节,了解文件、命令、任务和结果。你不需要再走桌面应用流程。

4. 使用你的服务器或 HPC

每次开始一项任务时,都要明确告诉 Drylab 智能体在哪里完成工作。例如:

  • 在我的笔记本电脑上完成这项工作。
  • 在我选择的服务器运行时上完成这项工作。
  • 在我配置好的 SSH 目标机器上完成这项工作。
  • 把这项工作提交到我配置好的 Slurm 集群。

5. 故障排除

桌面应用

遇到的问题检查什么
找不到 SSH 主机在“服务器”下添加它。在笔记本电脑上修改 SSH 配置后,使用“重新加载”。
某个密钥不见了,或状态不是“可用”检查笔记本电脑上的 SSH 密钥和 agent,然后点击“重新加载”。
设置更改没有生效先保存你的工作,然后选择“保存并应用”。这会重启沙箱管理程序和正在运行的沙箱。

CLI

遇到的问题检查什么
运行时一直是 pending 或 disconnected检查安装输出,以及服务器与 Drylab 服务之间的连接。
SSH 只能从笔记本电脑连上从服务器上测试;检查这台服务器的网络路径、SSH 配置和 agent。
没有配置 SSH/Slurm只能在 CLI 安装过程中配置。桌面应用的设置面板无法配置 CLI 运行时。
命令在错误的机器上运行检查当前选择的运行时,并让 Drylab 报告它的主机名。

连接和任务的通用检查

遇到的问题检查什么
Permission denied从运行 Drylab 的机器上测试 SSH;检查用户名和已授权的公钥。
SSH 超时从那台机器上检查 VPN、防火墙、主机名和端口。
Slurm 命令或任务失败确认提交节点、调度器环境、账户、分区、资源限制和日志。
找不到某个文件弄清它的路径属于笔记本电脑、运行时服务器还是 SSH 目标机器。必要时把文件传过去。

访问权限和凭据

Drylab 使用你现有的 SSH 账户权限和网络路径。需要授权时,把公钥提供给管理员。不要分发私钥,也不要把它粘贴到对话中。

从 Drylab 的配置中移除主机,只会限制 Drylab 的访问;要吊销 SSH 凭据本身,需要在目标机器上修改授权。

本页内容