Para qué sirve esta sección
Conecta el proveedor de Git y elige los repositorios que quieres analizar. Guardar la conexión no inicia la primera sincronización: ejecútala desde la tarjeta o espera al proceso programado si está habilitado.
Cuándo usarla
- Cargar datos de Git por primera vez.
- Revisar datos que faltan o actualizar un token.
Primeros pasos
- 1Usa los permisos indicados en el formulario: repo y read:user para GitHub; read_api y read_user para GitLab.
- 2Para Bitbucket con token de API, usa autenticación básica con correo de Atlassian y permisos de lectura de repositorios, PR y cuenta. OAuth usa un modo distinto.
- 3Configura la URL si usas una instancia propia, selecciona repositorios y ejecuta la sincronización.
- 4Comprueba el estado y la fecha de finalización antes de abrir las métricas.
Configuración
| Ajuste | Para qué sirve | Cómo usarlo | Error frecuente |
|---|---|---|---|
| Token y permisos | Dan acceso a los repositorios del proveedor. | Revisa permisos y caducidad; las acciones reales de automatización también necesitan permisos de escritura. | Suponer que todas las funciones pueden operar con acceso de solo lectura. |
| URL y repositorios | Definen la instancia y los datos que se sincronizan. | Comprueba la URL completa y empieza con los repositorios del equipo. | Analizar repositorios ajenos al alcance que quieres medir. |
Ejemplo de uso
Situación: Las métricas no muestran actividad reciente.
- 1Comprueba la última sincronización e inicia una manual.
- 2Si falla, revisa el error, la caducidad del token y el acceso al repositorio.
Qué permite comprobar: Podrás comprobar si la falta de datos se debe a la sincronización o a los filtros.
Preguntas frecuentes
¿Qué datos se leen?
Metadatos de commits y PR, el árbol de archivos y determinados manifiestos y archivos de configuración para identificar tecnologías. No se clona el código fuente completo. Los tokens se cifran con AES-256-GCM.
¿Cada cuánto se sincroniza?
El proceso en segundo plano depende de la configuración del servidor; el intervalo predeterminado es de unos 30 minutos cuando está habilitado. También puedes sincronizar manualmente.
¿Qué pasa al eliminar la conexión?
Se eliminan de Commitlane los repositorios sincronizados de esa conexión y sus commits y PR. Los originales del proveedor no cambian. Si solo necesitas renovar el token, actualiza la conexión para conservar esos datos.
Consejos
- Comprueba los datos y el estado de una conexión antes de ampliar el número de repositorios.