Hilbana
ES/EN

Bitbucket

Vincula Pull Requests de Bitbucket Cloud con issues: mueve el estado y adjunta el PR automáticamente.

Abres el PR y la tarea se mueve sola. Si la rama lleva el identificador de la tarea, al abrir el pull request en GitHub o Bitbucket se adjunta a la tarea y la pasa a en curso; al fusionarlo, la cierra. Sin tocar el tablero. Ver en el feed →

La integración con Bitbucket hace con Bitbucket Cloud lo mismo que la de GitHub: conecta la actividad de tus repositorios con las issues de Hilbana.

Qué es

Se conecta en Ajustes → Bitbucket (solo administradores). Autorizas a Hilbana en Bitbucket y eliges qué escuchar:

  • Todo el workspace: un solo webhook que cubre todos sus repositorios, también los que crees después. Necesitas ser admin del workspace en Bitbucket.
  • Solo algunos repositorios: un webhook por repositorio. Basta con ser admin de cada uno.

Hilbana crea los webhooks por ti; no hay que configurar nada a mano en Bitbucket. Puedes conectar más de un workspace de Bitbucket al mismo workspace de Hilbana.

Para qué sirve

Cuando trabajas un Pull Request cuya rama contiene el identificador de una issue (por ejemplo drapps-142-... → la issue DRAPPS-142), Hilbana:

  • Adjunta el PR a la issue (número, enlace, rama y estado).
  • Mueve el estado de la issue: al abrir el PR, a un estado en curso; al fusionarlo (merge), a un estado completado. Si lo declinas, el PR aparece como cerrado y la issue no cambia de estado.
  • Dispara los disparadores de PR de tus automatizaciones: se abre un PR, PR mergeado y PR cerrado sin merge. Bitbucket no avisa de cuándo un borrador pasa a estar listo, así que «PR listo para revisión» solo funciona con GitHub.
  • Usa los cambios de los PRs fusionados para el resumen de un hito, igual que con GitHub.

Cómo se usa

  1. En Ajustes → Bitbucket, pulsa Conectar Bitbucket y autoriza a Hilbana.
  2. De vuelta en Hilbana, elige el workspace de Bitbucket y qué escuchar, y pulsa Activar.
  3. Nombra tus ramas incluyendo el identificador de la issue (el botón Copiar nombre de rama de la ficha te lo da hecho).
  4. Abre y fusiona PRs como siempre: la issue se actualiza sola.

Apagar la integración

El interruptor «Usar integración Git (GitHub y Bitbucket)» de Ajustes → General es el mismo para las dos: al apagarlo desaparecen la sección Git de las tareas, las entradas GitHub y Bitbucket de Ajustes y los disparadores de PR de las automatizaciones.

Detalles

  • Solo Bitbucket Cloud. Bitbucket Data Center / Server no está soportado.
  • Cada conexión firma sus webhooks con su propio secreto: un evento solo puede escribir en el workspace de Hilbana al que pertenece la conexión.
  • La autorización de Bitbucket se guarda cifrada y nunca se muestra. Hilbana actúa con los permisos de la cuenta que conectó: si esa persona pierde el acceso en Bitbucket, hay que volver a conectar con otra cuenta.
  • Desconectar borra los webhooks en Bitbucket y el vínculo en Hilbana. También puedes retirar el acceso desde tus ajustes personales de Bitbucket (apartado OAuth).
  • La transición solo ocurre si el equipo de la issue tiene un estado de esa categoría.

Relacionado: GitHub · Issues · Estados de flujo.