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

Aberta Para iniciantes
#900 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
76/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
docker, linux
Domínio
devops, documentation

Direção de pesquisa

Leia docs/deployment.md e a página da Execution Machine para confirmar as etapas de instalação e vinculação do runner. Elabore um guia curto para uma VM na nuvem usando boxd, cobrindo a criação da máquina, a configuração do runner com /runners/install.sh e as alterações no Compose no host da plataforma. O trabalho estará concluído quando um leitor puder seguir o guia para executar a Execution Machine sem o socket Docker do host.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.
Linguagem predominante
Go
Estrelas
711
Forks
114
Merge médio
1d 10h
PRs com merge (30d)
116

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de Tencent/LoopForge

Todas as issues de Tencent/LoopForge

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.