在软件研发过程中,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
或点击
即刻创建你的专属沙箱,开启安全、快速、可控的Agent执行体验
参考项?:Novita Actions Runner Controllerhttps://github.com/novitalabs/github-actions-runner-controller
热文回顾
股票
板块
用户
资讯
评论 (0)