Ir al contenido principal

Integración con GitHub

La integración con GitHub es una de las dos fuentes de datos fundamentales de Leanmote (la otra es tu herramienta de planificación). Alimenta las métricas DORA y las de pull requests. Las métricas de flujo no salen de GitHub: el Tiempo de Ciclo, el Throughput, el WIP, la Eficiencia de Flujo, el Tiempo de Espera y el Tiempo al Mercado se leen de tu herramienta de gestión de tareas, así que conectar sólo GitHub las deja vacías. La Red de Colaboración del Equipo se arma con GitHub junto con tus integraciones de chat, tareas y calendario.


​

Qué trae Leanmote de GitHub


​

  • Los repositorios a los que le das acceso a Leanmote: con la GitHub App, los que eliges en GitHub.

  • Commits, con metadatos de autor y marca de tiempo.

  • Pull requests, con las marcas de tiempo de apertura, merge y cierre, y sus etiquetas.

  • Revisiones de pull request y comentarios de revisión.

  • Comentarios de pull request e hilos de revisión.

  • Despliegues — entorno, si GitHub lo marca como producción, estado (éxito / falla / error), ref, commit y marcas de tiempo.


​

Datos de despliegue y DORA


​

Los despliegues registrados a través de la API de Deployments de GitHub se capturan de forma continua, uses o no esos datos para DORA: por defecto, DORA cuenta los pull requests mergeados como despliegues. Para que la Frecuencia de Despliegue (Deployment Frequency) y la Tasa de Fallos de Cambios (Change Failure Rate) cuenten los despliegues en sí, el propietario de la organización activa Despliegues de GitHub en Configuración → Configuración de la organización → Pestañas → Métricas. Al activarlo se trae automáticamente hasta un año de historial de despliegues.


​

Se soportan dos formas de despliegue:


​

  • Despliegues de GitHub — todo lo registrado por la API de Deployments de GitHub, que es lo que crean los entornos de GitHub Actions y la mayoría de las herramientas de CD. No hay nada que configurar.

  • Check runs de despliegue — para pipelines que despliegan sin crear objetos de despliegue, Leanmote puede tratar un check run de producción con nombre específico sobre tus tags de release como el despliegue. Pídele a tu contacto de Leanmote que configure el nombre del check para tu organización. La captura empieza cuando se activa la opción, y el histórico se completa con el backfill.


​

Consulta Frecuencia de Despliegue y Tasa de Fallos de Cambios para ver cómo cuenta cada métrica.


​

Conecta GitHub


​

Leanmote se conecta a GitHub con la GitHub App de Leanmote. Se instala en tu organización de GitHub y no en la cuenta personal de alguien, así que sigue funcionando cuando alguien entra o se va, y lee con su propio cupo de GitHub en lugar del cupo personal de quien la conectó.


​

  1. Abre Administración → Integraciones (o el paso de integraciones de la configuración guiada).

  2. Busca GitHub en Código y Git y haz clic en Conectar.

  3. GitHub abre la página de instalación de la app de Leanmote. Elige la organización de GitHub dueña de tus repositorios.

  4. Elige All repositories (todos) u Only select repositories (sólo los que marques). Leanmote lee exactamente lo que elijas aquí, y puedes cambiarlo después en GitHub.

  5. Haz clic en Install & Authorize. GitHub te devuelve a Leanmote y la importación empieza.


​

  • ¿No eres propietario (owner) de la organización de GitHub? Si administras los repositorios, GitHub normalmente te deja instalarla por tu cuenta en ellos. Si no, puedes solicitarla, y GitHub les envía tu solicitud por correo a los propietarios de la organización. Cuando uno la apruebe, GitHub se conecta solo; no hace falta que vuelvas.

  • Se conecta una vez, para todos. Con la App instalada, GitHub aparece conectado para todas las personas de tu organización en Leanmote; nadie más necesita instalarla.

  • Cambiar los repositorios. En GitHub, abre Settings → GitHub Apps de tu organización, busca Leanmote y haz clic en Configure. Leanmote toma el cambio por su cuenta y empieza a leer los repositorios que agregaste.


​

Conexiones hechas por OAuth (método anterior)


​

Antes de la GitHub App, cada persona conectaba GitHub con su propia cuenta por OAuth: Conectar, iniciar sesión en GitHub, autorizar a Leanmote y elegir los repositorios en Leanmote. Esas conexiones siguen funcionando: Leanmote sigue leyendo los repositorios que están en ellas, con el cupo personal de GitHub de quien conectó, hasta que los pases a la App. Las conexiones nuevas siempre usan la App.


​

Pasar de OAuth a la GitHub App


​

  1. Abre Administración → Integraciones y haz clic en Gestionar en la tarjeta de GitHub.

  2. Abajo en la ventana, haz clic en Pasar a la GitHub App. Sólo aparece mientras tu organización todavía no tiene la App.

  3. En GitHub, elige la organización dueña de tus repositorios y marca All repositories (todos), o al menos los que Leanmote lee hoy. Haz clic en Install & Authorize. Si no eres propietario de esa organización, haz clic en Request: GitHub les envía un correo a los propietarios, y cuando uno lo apruebe, GitHub se conecta solo.

  4. De vuelta en Leanmote, los repositorios que ya sigues pasan a la App con su historial; no se vuelve a importar nada. Los que la App no cubre se desactivan: para medirlos, instala la App también en la cuenta de GitHub de esos repositorios y actívalos en Gestionar.

  5. Desde ese momento, GitHub aparece conectado para todos. Quien quiera borrar su conexión OAuth personal puede hacer clic en Desconectar GitHub en Gestionar: borra sólo su OAuth, y la App sigue leyendo.


​

Permisos solicitados


​

La GitHub App de Leanmote pide sólo acceso de lectura y no puede escribir en tus repositorios:


​

  • Metadata — nombres y datos básicos de los repositorios.

  • Contents — commits, ramas y tags.

  • Pull requests — pull requests, revisiones y comentarios de revisión.

  • Issues — los comentarios de los pull requests, que GitHub guarda como comentarios de issue.

  • Checks — check runs, incluidos los check runs de despliegue.

  • Deployments — despliegues y sus estados.


​

Las conexiones hechas por OAuth, antes de la App, otorgaron estos permisos:


​

  • repo — necesario para leer commits, pull requests, revisiones y despliegues de repositorios privados. GitHub no ofrece un equivalente de solo lectura para repositorios privados: el permiso repo da acceso de lectura y escritura. Leanmote lo usa estrictamente para operaciones de lectura y nunca escribe en tus repositorios.

  • read:org — leer la membresía y la lista de equipos de tu organización, que se usa para mapear identidades de GitHub a equipos de Leanmote.

  • user:email — leer el email del perfil de usuario para poder emparejar autores de GitHub con compañeros en Leanmote.


​

Si tu equipo de seguridad necesita verificar el comportamiento de Leanmote, el registro de auditoría de GitHub es la fuente de verdad: cada llamada a la API queda registrada de tu lado y vas a ver solo operaciones de lectura.


​

Frecuencia de sincronización


​

  • Importación inicial: el último año de historial de cada repositorio.

  • Sincronización incremental: refrescos programados a lo largo del día leen lo que cambió desde el anterior.


​

Desconectar GitHub


​

  • Desconectar GitHub, en Gestionar, borra tu conexión OAuth personal si tienes una. La GitHub App sigue instalada y sigue leyendo.

  • Si instalaste la App y no tienes una conexión OAuth propia, Desconectar GitHub desinstala la App de tu organización de GitHub, y Leanmote deja de leer a través de ella para toda tu organización. Para volver a conectar, hay que instalar la App otra vez.

  • Para quitar la App del todo, desinstálala en GitHub: Settings → GitHub Apps → Leanmote → Configure → Uninstall. Leanmote lo detecta y deja de leer a través de ella.


​

Problemas comunes


​

  • Faltan algunos repositorios — confirma que estén entre los que la App puede leer (Settings → GitHub Apps → Leanmote → Configure en GitHub). Con una conexión OAuth, vuelve a abrir la integración para agregar o quitar repositorios.

  • Instalación esperando aprobación — GitHub les envió tu solicitud por correo a los propietarios de tu organización de GitHub, y uno de ellos todavía tiene que aprobarla. Cuando lo haga, GitHub se conecta solo. Si después de la aprobación sigue sin conectarse, haz clic en Conectar otra vez.

  • Dejó de leer cuando alguien se fue — una conexión OAuth es de la persona que la hizo y deja de funcionar cuando esa persona pierde el acceso. Pasa a la GitHub App, que es de la organización.

  • Commits de bots inflando las métricas — excluye las cuentas de bots en el mapeo de equipos.

  • No aparecen despliegues — verifica que tu pipeline cree despliegues de GitHub (o un check run de despliegue) y reporte su estado final. Los despliegues a entornos que GitHub no marca como producción solo se cuentan cuando tu organización no marca ningún entorno como producción.


​

Artículos relacionados


​

  • Panorama de integraciones

  • Conecta tus primeras integraciones

  • La sincronización no termina

  • La integración aparece desconectada

¿Ha quedado contestada tu pregunta?