股票
板块
用户
资讯
首页
天眼
自选
发现
开户
首页
天眼
自选
发现
我的

告别常驻Runner,Agent Sandbox实现按需创建与自动回收

在软件研发过程中,GitHub Actions被广泛用于自动化构建与测试。对于需要特定编译器、系统库或内部构建工具的项目,研发团队通常会选择自托管Runner,以满足定制化的构建需求。然而,当Runner长期运行在固定的虚拟机上,任务少时容易造成资源闲置,任务集中时又可能因容量不足而排队。同一环境反复执行任务,还可能因残留的临时文件或后台进程影响后续构建。

针对这些问题,Agent Sandbox提供了一种按需创建、独立运行的任务执行方式。通过预先配置的模板,在任务到来时创建独立Sandbox,执行完成后自动回收,让构建资源随任务需求灵活调整。

每个Job都从?净环境开始

Agent Sandbox让每个Job从模板开始,完成后释放环境。依赖、?件和进程状态不会传给下?个Job,构建失败时也更容易判断问题来?代码还是环境。

模板固定环境,资源按任务创建

团队可以把编译器、系统库和包管理器放进Agent Sandbox Template,为Go、Node.js或 CMake项?维护基础环境。升级?具链时构建新模板,?作流不必反复安装依赖。

当前实现默认MIN_RUNNERS=0、MAX_RUNNERS=10。没有任务时不预留Runner,GitHub分配任务后创建Sandbox,任务结束后销毁资源。实际并发受账户配额限制。对于集中构建的项?,环境可以跟着任务出现,不必?期保留峰值容量。

Controller和Runner使用不同模板。Controller监听GitHub,生成即时注册配置并交给Runner。GitHub Token留在Controller中,不写入Runner模板。

快速接入

准备好GitHub PAT、Agent Sandbox API Key,以及Controller和Runner模板。下面以us-ca地域(目前仅支持us-ca地域)为例:

ucloud-sandbox-cli sandbox create system/ucloud-github-actions-controller \  --detached --timeout 3600 \  --env "GITHUB_CONFIG_URL: $GITHUB_CONFIG_URL" \  --env "GITHUB_TOKEN: $GITHUB_TOKEN" \  --env "UCLOUD_SANDBOX_API_KEY: $UCLOUD_SANDBOX_API_KEY" \  --env "PROVIDER: ucloud" \  --env "UCLOUD_RUNNER_TEMPLATE: system/ucloud-github-actions-runner" \  --env "UCLOUD_SANDBOX_REGION: us-ca" \  --env "SCALE_SET_NAME: ucloud-controller-ci" \  --env "RUNNER_LABELS: ucloud-controller-ci" \  --env "MAX_RUNNERS: 10"

将返回的Sandbox ID填?下?命令,在后台启动Controller,并把?志写?Sandbox内的?件:

ucloud-sandbox-cli sandbox exec --user user --command-timeout -1"$SANDBOX_ID" \  'nohup /usr/local/bin/novita-actions-controller \    > /home/user/novita-actions-controller.log2>&1 < /dev/null &'

查看启动?志:

ucloud-sandbox-cli sandbox exec --user user "$SANDBOX_ID" \  'tail -n 100 /home/user/novita-actions-controller.log'

需要持续追踪时,将tail -n 100改为tail -f。

最后让?作流使?对应标签:

jobs:  test:    runs-on: ucloud-controller-ci    steps:      - uses: actions/checkout@v5      - uses: actions/setup-go@v6        with:          go-version: '1.27.3'      - run: go test ./...

GitHub分配Job后,Controller会创建Agent Sandbox Runner。nohup和重定向让Controller脱离当前命令会话继续运?,?志保存在/home/user/novita-actions-controller.log。--command-timeout -1关闭命令超时,--timeout 360仍表示Sandbox最?运???时。

制作自己的Runner模板

如果项?需要CMake、Ninja或内部?具,可以从基础镜像初始化??的模板:

ucloud-sandbox-cli template init my-team-runner-v1 \  --from uhub.service.ucloud.cn/agent-sandbox-public/ucloud-github-actions-runner:latest \  --cpu-count 4 --memory-mb 8192

在template.dockerfile中安装依赖,同时保留user?户、/home/user/actions-runner?录和??命令:

FROM uhub.service.ucloud.cn/agent-sandbox-public/ucloud-github-actions-runner:latestUSER rootRUN apt-get update && apt-get install -y --no-install-recommends \      build-essential cmake ninja-build jq \    && rm -rf /var/lib/apt/lists/*USER userCMD ["/home/user/actions-runner/entrypoint.sh"]

构建模板并检查??脚本:

ucloud-sandbox-cli template build my-team-runner-v1 \  --cmd /home/user/actions-runner/entrypoint.sh \  --ready-cmd 'test -x /home/user/actions-runner/entrypoint.sh'

确认?具可?后,把Controller的 UCLOUD_RUNNER_TEMPLATE改成my-team-runner-v,再触发测试Job。建议保留v1、 v2等模板版本,切换前等待旧Job完成,避免同?Scale Set同时运?两个Controller。

从?个Job开始,探索Agent Sandbox

?个Job,就是?个独?Sandbox的起点。

Agent Sandbox不只是GitHub Actions Runner的运?环境,更是?套?向任务执?的隔离运?环境。通过Template预先定义运?时、依赖和?具环境,在任务到来时快速创建独?Sandbox,为每个任务提供隔离、可控的执?空间。

?论是GitHub Actions Job、?动化构建、批量测试,还是AI Agent的代码执?、?具调?和临时?作区,都可以基于Agent Sandbox实现按需创建、独?运?和?动回收。

开发者可以通过CLI或SDK管理Sandbox,执?命令、读写?件,并根据任务需求灵活控制Sandbox的?命周期。对于需要跨任务保留的缓存和构建产物,则可以结合外部存储或?作流进?管理。

如果你正在探索如何为?动化任务或AI Agent提供安全、隔离、弹性的执?环境,不妨从?个Job开始:通过Template定义环境,创建Sandbox,完成任务执?,再回收资源,体验Agent Sandbox的完整?作流程。

让每个任务都拥有独?的执?环境,让Sandbox成为?动化任务与AI Agent的基础设施。


了解更多Agent Sandbox产品详情,请访问:

https://astraflow.ucloud.cn/sandbox/landing

或点击
即刻创建你的专属沙箱,开启安全、快速、可控的Agent执行体验

参考项?:Novita Actions Runner Controllerhttps://github.com/novitalabs/github-actions-runner-controller

热文回顾

全国工商联副主席安立佳一行走进优刻得

AstraFlow模型托管平台上线,让企业自建模型更简单

US3助力AI视频超分:依托自建超分集群大幅降低4K视频增强成本

原文链接
多空观点 观点仅供交流,不构成投资建议
点赞
踩一踩
收藏
分享

评论 (0)

0/200
声明:社区内容仅代表用户个人观点,不构成任何投资建议。投资有风险,入市需谨慎。