Repositórios
Conectar um repositório dá aos agentes o seu código-fonte. O Polylane o indexa para pesquisa, o executa em um sandbox, revisa toda pull request contra a produção e coloca o repositório na topologia ao lado daquilo para o que ele faz deploy.
O que faz
Os agentes pesquisam código por palavra-chave e por significado, então uma consulta como "retry with exponential backoff" chega ao módulo certo mesmo quando essas palavras nunca aparecem no código. Eles executam o código do repositório em um sandbox quando uma investigação pede. Toda pull request é verificada contra a topologia de produção e recebe um veredito de aprovada ou reprovada como comentário.
Na topologia, o repositório é um nó unido por arestas deploys_to aos recursos para os quais faz deploy e por arestas defines aos recursos que a sua configuração provisiona. Quando um agente investiga uma issue em um serviço, ele segue essas arestas direto até o código que é entregue ali.
Conectar um repositório
Abra Settings > Repositories no console e escolha Add repository. Add from GitHub instala o GitHub app do Polylane na sua organização e permite escolher quais repositórios o Polylane pode ler; os repositórios conectados permanecem em sincronia conforme o código muda.
Add public repository registra um repositório público do GitHub pela URL. Repositórios adicionados assim não são atualizados automaticamente quando o código muda, então prefira o GitHub app para qualquer coisa que você desenvolva ativamente. Veja GitHub para as permissões do app.
A página do repositório
| Aba | O que faz |
|---|---|
| Settings | Configurações de autofix, revisão de pull requests e rede do sandbox para este repositório, descritas abaixo. |
| Observability | O Polylane revisa o repositório após cada sincronização e relata quão bem o código está instrumentado: quantos handlers de rota emitem telemetria e quais não produzem nenhuma. Cada descoberta pode ser entregue a um agente com Ask Polylane to fix it. |
| Changes | O histórico de revisões de pull requests deste repositório, cada uma verificada contra a topologia de produção com um veredito de aprovada ou reprovada. |
| Resources | Os recursos de nuvem que este repositório gerencia. O Polylane os vincula a partir de manifestos de deploy e metadados do provedor, e o que ele não consegue detectar você adiciona com Link resource. As revisões limitam sua investigação a esses recursos e recorrem à conta de nuvem inteira até que eles sejam vinculados. |
| Properties | O registro bruto do repositório. |
Configurações do repositório
| Configuração | O que controla |
|---|---|
| Open autofix pull requests | Se o Polylane transforma descobertas confirmadas em pull requests neste repositório. Desligar interrompe as novas; as pull requests existentes permanecem abertas. |
| Review pull requests for production impact | Se toda pull request é investigada contra a topologia de produção e recebe um comentário de veredito. |
| Pull request review instructions | Orientações específicas do repositório para a revisão, como quais caminhos são críticos para o deploy ou quais preocupações outras barreiras já tratam. |
| Block merging on production concerns | Publica um check "Polylane production impact" em toda pull request revisada, que falha quando a revisão encontra uma preocupação. Exija esse check na proteção de branch para bloquear o merge. Ligado por padrão. |
| Agent internet access | Se o agente pode fazer requisições de rede de saída enquanto executa código. |
| Domain allowlist | None, Common dependencies para registries de pacotes e ecossistemas de linguagens, ou All (unrestricted). |
Relacionado
- Revisões de pull requests para o que a revisão verifica e como o veredito se lê.
- Topology para o grafo ao qual o repositório se junta.
- Autofix para as pull requests que o Polylane abre em repositórios conectados.
- GitHub para as permissões do app e o que a desconexão remove.
Topology
O mapa vivo de todo recurso nas suas nuvens e repositórios: visualizações, fichas técnicas, níveis e o raio de impacto de qualquer mudança.
Memories
Descobertas confirmadas que agentes e pessoas salvam para que a próxima investigação comece a partir do que você já sabe, mais as notas que o Polylane escreve a cada dia.