5 min lectura • Guide 94 of 877
Conectando Commits de GitHub a Tareas Automáticamente
Sin vinculación automática, los desarrolladores deben actualizar manualmente las tareas cuando se hace commit de código, llevando a estados de tarea desactualizados y contexto faltante. La integración de GitHub de GitScrum conecta automáticamente commits y PRs a tareas, proporcionando visibilidad en tiempo real del progreso del código.
Beneficios de la Integración
| Sin Integración | Con Integración |
|---|---|
| Actualizaciones manuales de estado | Auto-actualización en PR |
| Sin visibilidad de código | Commits en tarea |
| Información duplicada | Única fuente de verdad |
| Contexto perdido | Historial completo |
Proceso de Configuración
Instalación de GitHub App
CONFIGURACIÓN DE INTEGRACIÓN GITHUB
═══════════════════════════════════
PASO 1: Instalar GitHub App
─────────────────────────────────────
GitScrum Settings → Integraciones → GitHub
Click "Instalar GitHub App"
Seleccionar organización/repos
Autorizar permisos
PASO 2: Configurar Repositorios
─────────────────────────────────────
Elegir repositorios a conectar
Mapear repos a proyectos de GitScrum
Establecer comportamientos default
PASO 3: Establecer Reglas de Vinculación
─────────────────────────────────────
Patrón de ID de tarea: GS-[0-9]+
Patrón de rama: feature/GS-[0-9]+-*
Auto-transición: Habilitado
PERMISOS REQUERIDOS:
├── Leer contenidos del repositorio
├── Leer/escribir issues
├── Leer/escribir pull requests
├── Leer estado de commits
└── Webhooks
Mapeo de Proyectos
MAPEO REPOSITORIO → PROYECTO
════════════════════════════
┌────────────────────────────────────────────────────────┐
│ Repositorio GitHub │ Proyecto GitScrum │
├────────────────────────────────────────────────────────┤
│ acme/frontend │ Acme Website │
│ acme/backend-api │ Acme Website │
│ acme/mobile-app │ Acme Mobile App │
│ acme/shared-libs │ (Todos los proyectos) │
└────────────────────────────────────────────────────────┘
PROYECTO MULTI-REPO:
├── Múltiples repos → un proyecto
├── PRs se muestran en tareas relacionadas
└── Contexto a través del codebase
Vinculación de Commits
Formato de Mensaje de Commit
PATRONES DE MENSAJE DE COMMIT
═════════════════════════════
FORMATO ESTÁNDAR:
GS-123: Descripción breve
EJEMPLOS:
─────────────────────────────────────
GS-456: Agregar flujo de autenticación de usuario
GS-456: Corregir bug de refresh de token
GS-789: Actualizar estilos de dashboard
─────────────────────────────────────
MÚLTIPLES TAREAS:
GS-123, GS-124: Refactoring compartido
CONVENTIONAL COMMITS + TAREA:
feat(auth): GS-123 agregar soporte OAuth
fix(api): GS-456 manejar respuesta null
PATRONES RECONOCIDOS:
├── GS-123
├── GS-123:
├── [GS-123]
├── (GS-123)
└── Fixes GS-123
Qué Se Vincula
DATOS VINCULADOS EN TAREA
═════════════════════════
VISTA DE TAREA:
┌─────────────────────────────────────────────────┐
│ Tarea: GS-456 Implementar login de usuario │
├─────────────────────────────────────────────────┤
│ Estado: En Revisión │
│ │
│ CÓDIGO VINCULADO: │
│ ┌─────────────────────────────────────────────┐│
│ │ Rama: feature/GS-456-user-login ││
│ │ ││
│ │ Commits (3): ││
│ │ ├── abc1234: Agregar UI de login ││
│ │ ├── def5678: Agregar lógica de auth ││
│ │ └── ghi9012: Agregar tests ││
│ │ ││
│ │ Pull Request: ││
│ │ PR #234: feat: implementar login ││
│ │ Estado: ✅ Aprobado | CI: ✅ Pasando ││
│ │ Revisores: @alex, @jordan ││
│ └─────────────────────────────────────────────┘│
│ │
│ [Ver PR] [Ver Commits] [Crear Rama] │
└─────────────────────────────────────────────────┘
Auto-Transiciones
Configuración de Transiciones
REGLAS DE AUTO-TRANSICIÓN:
┌─────────────────────────────────────────────────────────────┐
│ │
│ EVENTO TRANSICIÓN │
│ ────────────────────────────────────────────────────────── │
│ Rama creada con ID de tarea → Mover a "En Progreso" │
│ PR abierto → Mover a "En Revisión" │
│ PR aprobado → Mover a "Aprobado" │
│ PR mergeado → Mover a "Hecho" │
│ PR cerrado sin merge → Mover a "En Progreso" │
│ │
│ CONFIGURACIÓN: │
│ ├── Transiciones: ✓ Habilitadas │
│ ├── Crear rama desde tarea: ✓ Habilitado │
│ ├── Sincronizar comentarios de PR: Opcional │
│ └── Mostrar estado de CI: ✓ Habilitado │
│ │
└─────────────────────────────────────────────────────────────┘
Creación de Ramas desde Tareas
Flujo de Trabajo
CREAR RAMA DESDE TAREA:
┌─────────────────────────────────────────────────────────────┐
│ │
│ En la tarea GS-123: │
│ │
│ [Crear Rama] → │
│ │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Crear Rama para GS-123 ││
│ │ ││
│ │ Repositorio: [acme/frontend ▼] ││
│ │ Rama base: [main ▼] ││
│ │ Nombre de rama: feature/GS-123-implementar-login ││
│ │ ↑ auto-generado ││
│ │ ││
│ │ [Crear Rama] ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ RESULTADO: │
│ • Rama creada en GitHub │
│ • Tarea movida a "En Progreso" │
│ • Rama vinculada a tarea │
│ │
└─────────────────────────────────────────────────────────────┘