Revisões de pull requests
A maioria dos incidentes começa com uma mudança. O Polylane revisa toda pull request em um repositório conectado contra os recursos de produção para os quais ela faz deploy, e publica um comentário que diz aprovada ou reprovada.
O que faz
Um agente lê o diff e as métricas, logs e issues abertas ao vivo dos recursos para os quais o repositório faz deploy, depois decide se a mudança pode prejudicar a produção. Você recebe um comentário na pull request, um check Polylane production impact opcional e uma thread no console com a análise completa.
Como funciona
- Abrir uma pull request contra a branch padrão, enviar push para ela ou marcá-la como pronta para revisão inicia uma revisão do seu commit mais recente. Drafts não são revisados.
- Um push posterior substitui a revisão em andamento, então apenas o commit mais recente é julgado.
- Mudanças que tocam apenas documentação, testes ou arquivos de CI são aprovadas sem investigação.
- O Polylane segue as arestas de deploy do repositório até seus recursos de produção, ou revisa contra as contas de nuvem do workspace como um todo quando não há nenhuma.
- O agente investiga em uma thread e registra um veredito
passoufail. - Um comentário por pull request é editado a cada revisão. Uma reprovação diz Hold this merge com o nível de impacto e a descoberta; uma aprovação diz Production impact unlikely, ou informa se a correção de uma issue detectada deve resolvê-la. Quando um push posterior resolve uma preocupação, o comentário volta a ser uma aprovação e diz isso.
O agente também pode sugerir melhorias de observabilidade, como uma revisão em lote de comentários de sugestão ou uma pull request empilhada. Elas nunca afetam o veredito.
Agir sobre uma revisão
Mencione @polylane em um comentário na pull request e o Polylane responde na mesma conversa; não membros recebem uma nota sobre acesso em vez disso.
| Você pede | O que acontece |
|---|---|
| Uma pergunta | O agente responde a partir da thread de revisão, com as evidências à frente. |
| Outra olhada | O agente revisa o push mais recente de novo e reconsidera o veredito. |
| Uma correção | O Polylane inicia uma execução de correção e abre uma pull request empilhada contra a branch da pull request, vinculada a partir do comentário. |
A aba Changes do repositório no console lista toda revisão. Uma reprovação oferece Fix with Polylane, que inicia a mesma execução de correção, e Dismiss quando a preocupação não se aplica: a pull request continua sendo revisada, mas não recebe mais comentários até que você a Restore.
| Status | Descrição |
|---|---|
| In review | O Polylane está revisando o push mais recente. |
| Flagged | A revisão encontrou uma preocupação de produção. |
| Passed | Nenhuma preocupação de produção encontrada. |
| Resolved | Um push posterior resolveu as preocupações. |
| Dismissed | Um membro descartou a revisão; a pull request não recebe mais comentários. |
Configurar
As revisões ficam ligadas para todo repositório conectado. Settings > Pull request reviews as desliga para todo o workspace e define se as threads de revisão são compartilhadas com quem vê a pull request. Em Settings > Repositories, a aba Settings de um repositório adiciona três campos.
| Campo | Descrição |
|---|---|
| Review pull requests for production impact | Desliga as revisões apenas para este repositório. |
| Pull request review instructions | Texto livre que o agente lê em toda revisão: caminhos críticos para o deploy, ou preocupações que outras barreiras já tratam. |
| Block merging on production concerns | Publica o check Polylane production impact em toda pull request revisada; ele falha em uma preocupação. Ligado por padrão. Exija-o na proteção de branch para bloquear o merge. |
O check também é concluído em commits da fila de merge, já que a pull request foi revisada antes de entrar na fila. Um veredito de reprovação pode enviar o e-mail Production Concern Found, desligado por padrão em Notificações.
Notas sobre planos
Cada plano inclui um número mensal de revisões de pull requests; a cota do plano Free está listada em Cobrança e uso, e os membros recebem um e-mail conforme ela se esgota. Além da cota, o console registra a pull request como Production impact not verified e nada é publicado no GitHub.
Relacionado
- Repositórios para conectar um repositório e vincular seus recursos.
- Execuções de correção para como uma thread de revisão chega ao seu veredito.
- Autofix para as pull requests que uma execução de correção abre.
- Notificações para o e-mail que uma revisão reprovada pode enviar.
Issues
Todo problema que o Polylane detecta ou recebe do seu alertamento se torna uma issue, trabalhada por uma execução de correção cuja thread conta toda a história.
Advisories
Recomendações por recurso para má configuração, riscos de resiliência e lacunas de observabilidade, cada uma com uma correção que você pode entregar a um agente.