Integración con GitHub

Cómo se vincula el trabajo

Cada ítem tiene un código, como PBI-364. Escrito en el nombre de una rama, un pull request, un mensaje de commit o las notas de un release, vincula automáticamente esa actividad de GitHub con el ítem; la clave del proyecto y el número, como PAGOS-364, también funciona.

• Los pull requests muestran su estado en vivo, si son borradores y el resultado de su revisión.
• Se puede crear una rama en GitHub desde el propio ítem, ya nombrada a partir de él.
• Una URL pegada de un repositorio vinculado se guarda como ese objeto de GitHub, nunca como duplicado.

Conexión

• Conéctate mediante el servicio general de GitHub, sin registrar nada.
• O usa la App OAuth propia de tu organización, incluido GitHub Enterprise Server.

CI/CD y releases

• Las ejecuciones de GitHub Actions y los estados de commit de cualquier otro CI aparecen en los ítems para los que corrieron.
• Los releases publicados marcan como entregados los ítems que mencionan sus notas.
• Una pestaña de informes resume el éxito de los pipelines, su duración, los releases y los pull requests abiertos.
• Un Deployment con un pull request vinculado cumple el requisito de Pull Request para salir de Desarrollo.

Siempre actualizado

• Cada ítem muestra el avance de su desarrollo, de la rama al release.
• Los webhooks reportan los cambios al momento; además, los enlaces abiertos se vuelven a verificar cada 30 minutos.
• El administrador de cada workspace ve el estado de su conexión, la cuota de la API, la actividad, los errores y todos los repositorios vinculados.

Seguridad

• El token de acceso se guarda cifrado y nunca se muestra ni se registra en los logs.
• Las entregas del webhook se verifican por firma, tienen un tamaño máximo y se reducen a los campos que se usan.
• El secreto del webhook se puede rotar sin interrumpir las entregas.
• Cada proyecto accede solo a sus propios repositorios, y cada usuario solo a los ítems que puede ver.