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

Abierto Apto para principiantes
#900 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
docker, linux

Línea de trabajo

Lee docs/deployment.md y la página de la Execution Machine para confirmar los pasos de instalación y vinculación del runner. Redacta una guía breve para una VM en la nube usando boxd, que cubra la creación de la máquina, la configuración del runner con /runners/install.sh y los cambios de Compose en el host de la plataforma. El trabajo estará terminado cuando un lector pueda seguir la guía para ejecutar la Execution Machine sin el socket de Docker del host.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.
Lenguaje dominante
Go
Estrellas
711
Forks
114
Merge medio
1 d 10 h
PR fusionados (30 d)
116

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de Tencent/LoopForge

Todos los issues de Tencent/LoopForge

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.