Documentação

Crie seu primeiro projeto

Transforme um repositório conectado em um projeto que o Coroid possa analisar, compilar e testar.

Uma conexão torna os repositórios disponíveis. Um projeto é o ambiente onde o Coroid realmente opera: um projeto corresponde a um repositório e utiliza os comandos de compilação, comandos de teste, contexto e configurações desse repositório.

Crie um a partir de Projetos → Novo.

O que acontece na criação

O Coroid clona o repositório e realiza uma primeira análise dele. Essa análise identifica:

  • quais linguagens e frameworks estão presentes
  • como o projeto é compilado
  • como seus testes são executados
  • se ele pode ser transformado em contêiner

Essa análise permite que um agente compile seu código e execute sua suíte de testes posteriormente. Vale a pena dedicar dois minutos a isso agora, pois tudo o que vem a seguir depende da precisão dessa etapa.

Verifique o que foi detectado

Abra as configurações do projeto e confira os comandos de compilação e teste. A detecção funciona bem em estruturas convencionais e menos bem em:

  • monorepos, nos quais os comandos ficam em um subdiretório
  • projetos que exigem uma etapa de configuração (geração de código, migrações) antes da execução dos testes
  • suítes que necessitam que serviços — como banco de dados ou filas — estejam operando previamente

Se alguma dessas situações se aplicar, corrija os comandos manualmente. Um agente incapaz de executar seus testes não consegue verificar seu próprio trabalho, e isso se manifestará mais tarde como tarefas falhando na verificação por motivos não relacionados à alteração feita.

Suporte a linguagens

Os agentes escrevem código em qualquer linguagem utilizada pelo seu repositório. O que varia é o grau de verificação independente que o Coroid consegue realizar — leia suporte a linguagens e o ambiente do agente sobre o conjunto de ferramentas pré-instalado em cada área de trabalho e sobre as linguagens que contam com um servidor de linguagem complementar.

Um repositório ou vários?

Um projeto por repositório. Se seu sistema abranger vários repositórios, crie um projeto para cada; assim, o Coroid poderá coordenar o trabalho que envolve mais de um deles.

Resista à tentação de associar dois projetos ao mesmo repositório para representar fluxos de trabalho distintos — use planos, sprints ou faixas para isso, de modo que os dois fluxos compartilhem uma visão única do código-fonte.

Próximo

Execute sua primeira tarefa — descreva um trabalho e acompanhe seu andamento.