GitScrum / Docs
Todas las Mejores Prácticas

Integración Git Desconectada de Gestión | GitScrum

Conecta GitHub, GitLab y Bitbucket a tus tareas de GitScrum para tracking unificado donde commits, branches y PRs se vinculan al trabajo.

6 min de lectura

Cuando los repositorios Git y la gestión de proyectos viven en mundos separados, los equipos pierden visibilidad sobre qué código soporta qué tareas. GitScrum se integra con GitHub, GitLab y Bitbucket para conectar commits, branches y pull requests.

El Problema de la Desconexión

Git separado de la gestión de proyectos crea fricción:

  • Actualizaciones manuales — Marcar tareas completas después de merges
  • Contexto perdido — Sin visibilidad de qué commits soportan qué tareas
  • Esfuerzo duplicado — Escribir descripciones de PR y actualizaciones de tareas
  • Brechas de auditoría — Rastrear features a requisitos originales
  • Sobrecarga de reportes — Correlacionar manualmente código y progreso

Integraciones Git de GitScrum

Conecta tus repositorios a GitScrum:

Plataformas Soportadas

PlataformaCaracterísticas
GitHubCommits, branches, PRs, sync de issues
GitLabCommits, branches, MRs, sync de issues
BitbucketCommits, branches, PRs

Qué Se Conecta

  • Commits vinculados a tareas vía ID de tarea en mensaje de commit
  • Branches rastreados por tarea
  • Pull/Merge Requests visibles en timeline de tarea
  • Cambios de estado reflejados automáticamente

Configurando Integración Git

Setup de GitHub

  • Ir a Configuración del Proyecto → Integraciones
  • Seleccionar GitHub
  • Autenticar con OAuth
  • Seleccionar repositorios a conectar
  • Configurar opciones de sync

    • Setup de GitLab

  • Ir a Configuración del Proyecto → Integraciones
  • Seleccionar GitLab
  • Ingresar token de acceso personal
  • Seleccionar proyectos a conectar
  • Configurar notificaciones webhook

    • Setup de Bitbucket

  • Ir a Configuración del Proyecto → Integraciones
  • Seleccionar Bitbucket
  • Autenticar con OAuth
  • Seleccionar repositorios a conectar
  • Configurar opciones de sync

    • Vinculando Commits a Tareas

    Usa IDs de tarea en mensajes de commit para vincular:

    Formato de Mensaje de Commit

    git commit -m "Add user authentication [GS-234]"

    Formatos Alternativos

    # Forma corta
git commit -m "Fix login bug #234"

# Con descripción
git commit -m "Implement OAuth flow

Adds Google OAuth support for user authentication.
Closes GS-234"

# Múltiples tareas
git commit -m "Refactor auth module [GS-234] [GS-235]"

    Qué Aparece en GitScrum

    Tarea #234: Implementar login OAuth
├── Estado: En Progreso
├── Actividad Git:
│   ├── Commit abc123: "Add user authentication [GS-234]"
│   ├── Branch: feature/oauth-login
│   └── PR #45: "OAuth Implementation" (Abierto)
└── Última actualización: hace 5 minutos

    Tracking de Branches

    GitScrum rastrea branches asociados a tareas:

    Convención de Nombres de Branch

    feature/GS-234-oauth-login
bugfix/GS-456-login-error
hotfix/GS-789-security-patch

    Visibilidad de Branch

    • Ver branches activos por tarea
    • Rastrear estado del branch (abierto, merged, eliminado)
    • Ver historial de branch en timeline de tarea

    Integración de Pull Requests

    Visibilidad de PRs en Tareas

    Cuando los PRs referencian IDs de tarea: 
    Tarea #234: Implementar login OAuth
├── Pull Requests:
│   └── #45: "OAuth Implementation"
│       ├── Estado: Abierto
│       ├── Autor: @developer
│       ├── Revisores: @senior-dev
│       ├── Checks: ✓ Todos pasando
│       └── Comentarios: 3

    Actualizaciones Automáticas de Estado

    Configura auto-transiciones:
    • PR abierto → Tarea se mueve a "En Review"
    • PR merged → Tarea se mueve a "Done"
    • PR cerrado → Tarea regresa a "En Progreso"

    Timeline de Actividad

    Cada tarea muestra actividad Git cronológicamente:

    Tarea #234: Implementar login OAuth
Timeline:
├── Dic 18, 10:00 — PR #45 merged por @senior-dev
├── Dic 18, 09:30 — PR #45 aprobado por @senior-dev
├── Dic 17, 16:00 — PR #45 abierto por @developer
├── Dic 17, 15:45 — Commit def456: "Add OAuth callback handling"
├── Dic 17, 14:00 — Commit abc123: "Add OAuth initialization"
├── Dic 16, 10:00 — Branch feature/GS-234-oauth-login creado
└── Dic 15, 09:00 — Tarea creada por @pm

    Vinculación Bidireccional

    De GitScrum a Git

    • Ver commits, branches, PRs en detalles de tarea
    • Clic para ir a GitHub/GitLab/Bitbucket
    • Ver estado de PR y comentarios de review

    De Git a GitScrum

    • Agregar links a tareas en descripciones de PR
    • Ver contexto de tarea al revisar PRs
    • Acceder a requisitos de tarea desde historial de commits

    Mejores Prácticas

    Estándares de Mensajes de Commit

  • Incluir ID de tarea — Cada commit referencia una tarea
  • Ser descriptivo — Explicar qué y por qué
  • Mantenerlo atómico — Un cambio lógico por commit
  • Usar formato convencional — type(scope): message [task-id]

    • Estrategia de Branches

  • Usar ID de tarea en nombre de branch — Vinculación automática
  • Mantener branches de vida corta — Merge frecuentemente
  • Eliminar después de merge — Repositorio limpio

    • Workflow de PRs

  • Referenciar tarea en título o descripción de PR
  • Usar template de PR que solicite link de tarea
  • Revisar requisitos de tarea antes de aprobar

    • Oportunidades de Automatización

    Auto-Mover Tareas en Eventos Git

    Evento GitTransición de Tarea
    Branch creadoPor Hacer → En Progreso
    PR abiertoEn Progreso → Code Review
    PR aprobadoCode Review → Listo para Merge
    PR mergedListo para Merge → Done
    PR cerrado (no merged)Code Review → En Progreso

    Notificaciones Webhook

    Enviar eventos Git a GitScrum:
    • Pushes de commits
    • Cambios de estado de PR
    • Creación/eliminación de branches
    • Solicitudes de review

    Soluciones Relacionadas