[Feature]: Guide for running an execution machine on a cloud VM (boxd)

未关闭 适合新手
#900 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
76/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
docker, linux

调研方向

阅读 docs/deployment.md 和 Execution Machine 页面,确认 runner 的安装和绑定步骤。使用 boxd 编写一份简短的云 VM 指南,涵盖创建机器、使用 /runners/install.sh 设置 runner,以及在平台主机上进行 Compose 更改。读者能够按照指南运行 Execution Machine,且不使用主机的 Docker 套接字时,即为完成。

由索引模型根据 Issue 内容生成。

描述

Problem

The Compose deployment mounts the host Docker socket so AI SOPs run out of the box, and docs/deployment.md explains that this is equivalent to root on the host. The alternative it suggests is to remove the socket and connect a separate Docker-capable worker or execution machine. There is no guide yet for setting one up on a cloud VM, so most people keep the socket.

Proposed behavior

A short guide in docs/deployment.md (or a page under docs/) for running an execution machine on a cloud VM, using boxd as the example. boxd machines are full Linux VMs with Docker installed, so the runner and its Docker sandboxes run there, away from the platform host:

  1. Create a machine and open a shell on it.
  2. Install the runner with /runners/install.sh and the binding code from the execution-machine page.
  3. Remove the docker.sock volume and AGENTFLOW_LOCAL_SANDBOX from compose.yaml on the platform host.

I work on boxd. If you are open to it, I would test the steps end to end against a real LoopForge install and open a docs-only PR. No code changes.

Scope

Documentation

Alternatives considered

A boxd sandbox driver that gives every task its own VM. That touches the runtime, so I would only propose it if you want it.

Checks
  • This proposal does not require organization-specific infrastructure or credentials.
  • I searched existing issues and discussions for similar proposals.
主要语言
Go
星标
711
派生
114
平均合并
1 天 10 小时
30 天内合并 PR
116

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

Tencent/LoopForge 的其他 Issue

查看 Tencent/LoopForge 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。