来源:市场资讯

(来源:优刻得云计算)

在软件研发过程中,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