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

Aperta Adatta ai principianti
#900 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
76/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
docker, linux

Direzione di ricerca

Leggi docs/deployment.md e la pagina sull’Execution Machine per confermare i passaggi di installazione e associazione del runner. Prepara una breve guida per una VM cloud usando boxd, che copra la creazione della macchina, la configurazione del runner con /runners/install.sh e le modifiche a Compose sull’host della piattaforma. Il lavoro è concluso quando un lettore può seguire la guida per eseguire l’Execution Machine senza il socket Docker dell’host.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.
Lingua principale
Go
Stelle
711
Fork
114
Merge medio
1g 10h
PR unite (30g)
116

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di Tencent/LoopForge

Tutte le issue di Tencent/LoopForge

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.