Revisiones de pull requests
La mayoría de los incidentes empiezan con un cambio. Polylane revisa cada pull request de un repositorio conectado contra los recursos de producción en los que despliega, y publica un comentario que dice aprobado o suspendido.
Qué hace
Un agente lee el diff y las métricas, logs e issues abiertos en vivo de los recursos en los que despliega el repositorio, y después decide si el cambio puede dañar producción. Recibes un comentario en el pull request, un check opcional Polylane production impact y un hilo en la consola con el análisis completo.
Cómo funciona
- Abrir un pull request contra la rama por defecto, hacer push a él o marcarlo como listo para revisión inicia una revisión de su commit de cabecera. Los borradores no se revisan.
- Un push posterior sustituye la revisión en curso, así que solo se juzga el último commit.
- Los cambios que solo tocan documentación, pruebas o archivos de CI se aprueban sin investigación.
- Polylane sigue las aristas de despliegue del repositorio hasta sus recursos de producción, o revisa contra las cuentas de nube del espacio de trabajo en conjunto cuando no tiene ninguna.
- El agente investiga en un hilo y registra un veredicto
passofail. - Se edita un único comentario por pull request en cada revisión. Un suspenso dice Hold this merge con el nivel de impacto y el hallazgo; un aprobado dice Production impact unlikely, o indica si se espera que una corrección para un issue detectado lo resuelva. Cuando un push posterior atiende una preocupación, el comentario vuelve a aprobado y lo dice.
El agente también puede sugerir mejoras de observabilidad, como una única revisión agrupada de comentarios de sugerencia o como un pull request apilado. Nunca afectan al veredicto.
Actuar sobre una revisión
Menciona @polylane en un comentario del pull request y Polylane responde en la misma conversación; quienes no son miembros reciben en su lugar una nota sobre el acceso.
| Pides | Qué ocurre |
|---|---|
| Una pregunta | El agente responde desde el hilo de revisión, con la evidencia delante. |
| Otro vistazo | El agente revisa de nuevo el último push y reconsidera el veredicto. |
| Una corrección | Polylane inicia una ejecución de corrección y abre un pull request apilado contra la rama del pull request, enlazado desde el comentario. |
La pestaña Changes del repositorio en la consola lista cada revisión. Un suspenso ofrece Fix with Polylane, que inicia la misma ejecución de corrección, y Dismiss cuando la preocupación no aplica: el pull request se sigue revisando pero no recibe más comentarios hasta que lo restauras con Restore.
| Estado | Descripción |
|---|---|
| In review | Polylane está revisando el último push. |
| Flagged | La revisión encontró una preocupación de producción. |
| Passed | No se encontraron preocupaciones de producción. |
| Resolved | Un push posterior atendió las preocupaciones. |
| Dismissed | Un miembro descartó la revisión; el pull request no recibe más comentarios. |
Configurar
Las revisiones están activadas para cada repositorio conectado. Settings > Pull request reviews las desactiva para todo el espacio de trabajo y fija si los hilos de revisión se comparten con quienes ven el pull request. En Settings > Repositories, la pestaña Settings de un repositorio añade tres campos.
| Campo | Descripción |
|---|---|
| Review pull requests for production impact | Desactiva las revisiones solo para este repositorio. |
| Pull request review instructions | Texto libre que el agente lee en cada revisión: rutas críticas para el despliegue, o preocupaciones que ya cubren otros controles. |
| Block merging on production concerns | Publica el check Polylane production impact en cada pull request revisado; falla ante una preocupación. Activado por defecto. Exígelo en la protección de ramas para bloquear la fusión. |
El check también se completa en los commits de la cola de fusión, ya que el pull request se revisó antes de entrar en la cola. Un veredicto de suspenso puede enviar el correo Production Concern Found, desactivado por defecto en Notificaciones.
Notas sobre el plan
Cada plan incluye un número mensual de revisiones de pull requests; la cuota del plan Free figura en Facturación y uso, y los miembros reciben un correo cuando se está agotando. Superada la cuota, la consola registra el pull request como Production impact not verified y no se publica nada en GitHub.
Relacionado
- Repositorios para conectar un repositorio y enlazar sus recursos.
- Ejecuciones de corrección para cómo un hilo de revisión llega a su veredicto.
- Autofix para los pull requests que abre una ejecución de corrección.
- Notificaciones para el correo que puede enviar una revisión suspendida.
Issues
Cada problema que Polylane detecta o recibe de tu sistema de alertas se convierte en un issue, trabajado por una ejecución de corrección cuyo hilo cuenta toda la historia.
Advisories
Recomendaciones por recurso sobre configuración incorrecta, riesgos de resiliencia y carencias de observabilidad, cada una con una corrección que puedes entregar a un agente.