来源:市场资讯
(来源:优刻得云计算)
在软件研发过程中,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-cisteps:- uses: actions/checkout@v5- uses: actions/setup-go@v6with: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
热门跟贴