EXECUTIONS

在云端运行代码。
直接从您的应用程序发起。

通过 SDK 或 API 将代码执行集成到产品中。在隔离虚拟机中处理文件和任务，为每次执行配置资源。

我要集成执行能力查看价格并估算用量 ↗

一台虚拟机
对应一个 Execution。

每个 Execution 都会启动一台虚拟机来运行代码。生成 PDF、转换数据，或处理应用程序发送的文件。

Execution 结束后，虚拟机会关闭。已收集的结果和文件仍可供后续获取。

如何使用 Executions。

通过终端运行、使用控制面板，或集成到应用程序中。

通过 CLI 访问。

在终端中启动执行并查看状态。在脚本中使用相同命令，自动执行重复任务。

通过控制面板访问。

在 runvibe_ 控制面板中创建并跟踪执行。选择代码和资源，随后查看状态、日志和生成的文件。

通过 SDK 集成到应用程序。

在应用代码中使用 SDK 启动 Executions。跟踪执行进度，并将结果用于下一步处理。

在您的产品中执行任务。

应用程序提交任务、跟踪执行，并将结果用于下一步。runvibe_ 在启动前检查权限和配置。

AI 应用可以提交文件进行处理，并获取已收集的结果以继续完成任务。

连接您的 AI 工具。

连接兼容 MCP 的工具，例如 Codex、Claude Code 或 Cursor，启动 Executions 并获取结果。

配置可复用的
执行任务。

TOML 清单。

在 TOML 文件中描述执行内容和所需资源，包括变量、卷、网络规则和时间限制。复用清单，以相同配置启动新的执行。

在清单中引用 Packages。

指定要使用的 Package、入口文件及其参数。Execution 启动该文件；对具体函数的调用由代码本身完成。

在需要审核的使用场景中，必须批准 Package 的确切内容。审批不能替代执行权限和策略。

了解审批流程 ↗

包含输入数据的卷。

将卷中的文件挂载到脚本或容器预期的路径。Execution 保留源卷；容器中的可写副本是临时的。

环境变量。

在清单中声明进程所需的配置值。对于容器 Executions，分别定义每个容器的环境变量。

使用 Secrets 管理凭据。

将令牌、密码和 API 密钥存储在 Secrets 中。在 Execution 配置中，将 Secret 引用映射到应用程序需要的环境变量。进程在运行时接收相应值，无需将其写入代码或清单。

网络控制。

禁止外部访问。

对于仅处理所提供数据的 Executions，可关闭出站网络访问。

允许访问的目标。

按 IP、地址段或域名限制出站流量，并指定协议和端口。

由宿主机执行策略。

宿主机执行网络规则，阻止访问私有网络、本地地址和基础设施元数据，即使在公共模式下也不例外。

分别控制镜像下载和代码执行。

对容器分别配置镜像下载策略和代码执行策略。下载时允许访问某个镜像仓库，不代表 Execution 运行时也允许访问。

选择格式
用于您的执行任务。

提交脚本、Package 或容器配置。在兼容的运行时中，脚本和 Packages 可使用预先准备的镜像。

Python 和 Node.js 脚本。

直接提交 Python 或 JavaScript 代码并选择运行时。脚本从工作目录启动，使用已配置的变量和卷。

适用于临时自动化任务、数据转换或 AI 生成的代码。直接提交代码，无需将项目打包为 ZIP。

包含已准备环境的镜像。

使用已安装工具和依赖项的镜像，可在 Workspace 中准备。脚本和 Packages 可在兼容的运行时中使用该环境。

每次执行都会获得镜像的可写副本。安装和修改仅影响副本，已发布镜像保持不变，供后续 Executions 使用。

基于 OCI 镜像的容器。

指定 OCI 镜像、命令和环境变量，并根据 Execution 的需要添加辅助服务。同一个 Execution 中的容器共享 CPU、内存和网络。

适用于已打包为容器的应用程序。每个容器的退出码和日志在收集后可用。

可复用的 Packages。

将项目代码和文件打包为 ZIP，一次上传。如果处理依赖多个文件，如 Python 模块和报告模板，可使用 Packages。

在新的 Executions 中复用 Package，无需重新上传文件。

获取结果
并下载文件。

收集完成后，使用 Execution ID 通过 API、CLI 或 MCP 获取结果和文件。将结构化结果写入 result.json，将文件写入 outputs/。

通过 API 获取结构化结果。

将数据写入 result.json，通过 API 获取 JSON 结果并在应用程序中使用。

Execution 生成的文件。

将报告、文档和其他文件保存到 outputs/。通过 API 查看产物并请求下载所需文件。可用性受平台限制和保留期限约束。

通过 CLI 或 AI 访问。

在 CLI 中使用 Execution ID 获取结果并下载产物。通过 MCP 连接 AI 工具后，可让它获取结果或生成的文件，继续处理。

执行日志和指标。

在 stdout 和 stderr 中查看标准输出和错误。跟踪状态、时长和资源指标。容器日志在执行结束并完成收集后可用。

隔离和控制
适用于每次执行。

专用内核

Execution 在虚拟机中运行，内核与宿主机及其他执行环境隔离。同一个 Execution 中的容器共享该虚拟机的内核。

转发端口以供本地访问

对配置为不设时长限制且正在运行的容器或 Package Executions，可通过 CLI 转发端口。直接脚本不支持此访问方式。端口转发随 Execution 结束而终止。

设置资源

根据处理任务的需要，为每次执行选择 CPU 和内存。

超时和取消

为 Execution 设置时间限制，或在需要停止时请求取消。

按运行时间
付费。

在 runvibe_ 云端，处理任务根据资源和运行时间消耗套餐余额。

任务结束后停止执行计费；月费和存储仍按套餐规则收费。

估算我的用量 ↗

启动 Execution

设置了代码、输入和配置

在云中运行

用量取决于所选资源和运行时间

获取结果

Execution 已结束 · 执行环境已释放

常见问题。

需要先创建 Workspace 吗？

不需要。您可以直接用 Python 或 Node.js 代码、Package 或容器启动 Execution。需要准备和测试可复用环境镜像时，再使用 Workspace。

Package 和清单如何配合？

Package 包含代码和文件；清单定义运行方式和所需资源。查看配置 ↗

如何在应用程序中获取结果？

将数据写入 result.json，将文件写入 outputs/。收集完成后，使用 Execution ID 获取。查看结果和文件 ↗

可以使用在 Workspace 中准备的镜像吗？

可以，前提是运行时支持预先准备的镜像。这样可以复用已安装依赖项的环境。容器执行使用 OCI 镜像和独立配置。

在哪里查看错误和资源用量？

在执行详情中查看状态、stdout、stderr 和已记录的指标。容器日志在 Execution 结束后收集。

什么时候选择 Execution，什么时候选择 Workspace？

对于有明确起止、需要集成到应用程序或自动化流程中的处理任务，使用 Execution。需要开发、测试应用并在同一环境中继续工作时，选择 Workspace。

申请访问权限，开始
使用 Executions。

我要集成执行能力

了解套餐 ↗