Pular para o conteúdo

Para mantenedores

Desenvolvimento local

Iniciar com isolamento, porta consistente e segredos fora do Git.

Nesta página

Antes de iniciar

Nunca copie tokens para exemplos, screenshots, comandos públicos ou arquivos versionados. Credenciais de desenvolvimento não devem ser usadas em produção.

  1. Confira a branch e a worktree da tarefa. Preserve alterações existentes e mantenha master estável.

  2. Verifique se a porta 3000 está ocupada. Não troque automaticamente para 3001 ou 3099 nem encerre processos de identidade incerta.

  3. Configure as variáveis locais nos arquivos ignorados apropriados. Engine e Runtime precisam apontar para o mesmo ambiente local e a mesma URL do Engine.

  4. Confirme que não existe outro Runner ou Worker conectado ao mesmo bot.

Perfil local compilado

O repositório inclui um perfil de compilação e execução local para máquinas com recursos limitados. Execute na raiz da worktree; a compilação deve ocorrer sem alterações concorrentes nos arquivos de origem.

PowerShell · raiz da worktree
node scripts/local-profile.mjs build
node scripts/local-profile.mjs engine
# Em outro terminal, somente sem instância conflitante:
node --env-file=runbots-runtime/.env scripts/local-profile.mjs runtime

O que não deve ser flexibilizado

Não desative CSRF, validação de origem, autenticação ou checagem de lease para acomodar um ambiente local. Chaves oficiais de teste do Turnstile dependem das proteções locais explícitas e não autorizam uso em produção.

Não execute migrations em um banco existente sem autorização. A preparação local não é um procedimento de deploy.