Integración de Bitbucket

Integra los commits, ramas y solicitudes de validación de Bitbucket con las tareas de ClickUp. Esto te permite:

  • Consulta toda la actividad de Bitbucket relacionada con una tarea directamente en ClickUp.

  • Opcionalmente, recibe notificaciones de ClickUp cuando se añadan nuevos elementos de actividad de Bitbucket a las tareas.

  • Adjunta automáticamente (o manualmente) la actividad de Bitbucket a tareas de ClickUp.

  • Cambia automáticamente los estados con acciones de Bitbucket añadiendo el ID de tarea de ClickUp a tus confirmaciones utilizando este formato #{taskID}[estado ] Por ejemplo: #1abc2de[cerrado]

Captura de pantalla de una notificación de actividad de tarea en Bitbucket.

Qué necesitas

Autoriza a ClickUp para conectar con Bitbucket

Puedes integrar ClickUp y Bitbucket.org o la versión autoalojada de Bitbucket. El proceso de autorización varía dependiendo de la versión de Bitbucket que utilices.

Opción 1: Autorizar una cuenta de Bitbucket.org

Nota: Solo los administradores de ClickUp pueden adjuntar repositorios a los Espacios de tu equipo.

  1. Abre el Centro de aplicaciones.
  2. Haga clic en Bitbucket.
  3. Haz clic en Activar Bitbucket para el equipo.
  4. Haga clic en + Añadir Bitbucket.
  5. Seleccione No, uso bitbucket.com y haga clic en Enlazar Bitbucket.

    Captura de pantalla de la indicación para seleccionar el tipo de cuenta de Bitbucket que utilizas.
  6. Si no estás conectado, se te pedirá que inicies sesión en tu cuenta de Bitbucket.org

  7. Revisa los permisos requeridos y haz clic en Conceder acceso

Captura de pantalla del mensaje de permisos para autorizar ClickUp.

Ahora que has autorizado tu cuenta, procede al siguiente paso de vincular repositorios de Bitbucket a tu entorno de trabajo.

Opción 2: Autorizar una cuenta de Bitbucket autoalojada

Si está utilizando una versión autoalojada de Bitbucket, puede autorizar a ClickUp creando un token de acceso HTTP. Obtén más información sobre tokens de acceso HTTP de Bitbucket.

  1. Abre el Centro de aplicaciones.
  2. Haz clic en Bitbucket
  3. Haz clic en Activar Bitbucket para el equipo
  4. Haz clic en + Añadir Bitbucket
  5. Seleccione Sí, uso una versión alojada de Bitbucket y luego siga los siguientes pasos en Bitbucket.

    Captura de pantalla de la opción para usar la versión alojada de Bitbucket.
  6. En tu Bitbucket alojado, haz clic en el avatar de tu perfil de usuario, arriba a la derecha.

  7. Selecciona Gestionar cuenta.

    Captura de pantalla del menú de perfil de usuario de Bitbucket.
  8. Selecciona tokens de acceso HTTP en la barra lateral izquierda.

  9. Crea un nuevo token de acceso con permisos de administrador para Proyectos y Repositorios.

  10. Copia el token de acceso HTTP proporcionado.

  11. De vuelta en ClickUp, pega el token copiado en el campo Token de acceso.

  12. Introduce los detalles de tu cuenta de Bitbucket, incluyendo:

    • URL del host

    • URL canónica (opcional)

    Captura de pantalla de los detalles de la cuenta de Bitbucket.
  13. Seleccione sus preferencias:

    • ¿Quieres usar el secreto alojado?

    • IP estática

  14. Haz clic en Enlazar Bitbucket.

Ahora que has autorizado tu cuenta, procede al siguiente paso de vincular repositorios de Bitbucket a tu entorno de trabajo.

Adjunta repositorios de Bitbucket a tu entorno de trabajo

ClickUp permite que varias personas autoricen Bitbucket dentro de tu espacio de trabajo, y también te permite personalizar qué repositorios se comparten con tu espacio de trabajo.

Esto significa que puedes autorizar tu cuenta personal sin necesidad de vincular todos tus repositorios; puedes personalizar cuáles adjuntar.

Vincular un repositorio no otorga acceso al código base de tu repositorio de ninguna manera. Simplemente permite a los usuarios adjuntar elementos del historial de ese repositorio a los espacio(s) que especifiques.

Nota: Solo puedes asociar repositorios de Bitbucket donde tengas acceso de administrador.

Captura de pantalla de los repositorios de Bitbucket y la opción de añadirlos a ClickUp.

Paso 3: Seleccione qué espacios están vinculados a sus repositorios

Puedes personalizar qué Espacios tienen repositorios adjuntos expandiendo el desplegable a la derecha de Repos de Equipo. Para adjuntar elementos de Bitbucket a tareas, el espacio debe estar vinculado al repositorio.

Captura de pantalla que muestra la vinculación de repositorios de Bitbucket con espacios de ClickUp.

Asocia automáticamente la actividad de Bitbucket en ClickUp

ClickUp detectará automáticamente cualquier nueva actividad y la asociará con las tareas.

Para habilitar esto, debes:

Añade un ID de tarea de ClickUp en cualquier parte del título de la solicitud de pull, del nombre de la rama o del mensaje de confirmación en uno de estos formatos:

#{task_id}

CU-{task_id}

{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

prefijo-1

Asociar manualmente la actividad de Bitbucket

Captura de pantalla del icono de Bitbucket en una tarea de ClickUp.
  1. Haz clic en el icono de Bitbucket en cualquier tarea

  2. Selecciona un repositorio

  3. Selecciona una rama

  4. Adjunta tu confirmación

Cambia automáticamente el estado de la tarea a través de Bitbucket

También puedes cambiar el estado de una tarea desde una confirmación o solicitud de validación.
Para hacer esto:

Añade el ID de tarea de ClickUp en cualquier parte del mensaje de commit, así como el estado que deseas entre corchetes.
Por ejemplo: #ud5b[ready]

Animación de un cambio de estado de tarea debido a un push de git en Bitbucket.

Nota: ¡También puedes enlazar los ID de tarea de Bitbucket a ClickUp!

Captura de pantalla de una confirmación en Bitbucket.
  1. Ir a los ajustes del repositorio

  2. Haz clic en Enlaces

  3. Añadir nuevo enlace

  4. Tipo de enlace: Personalizado

  5. Enlace URL: app.clickup.com/t/\1

  6. Clave de enlace: CU-(\w{3,10})(\[\w+\])?

Esto funciona tanto para confirmaciones como para solicitudes de validación.

Acciones

Crea rápida y fácilmente nuevas ramificaciones desde ClickUp con nuestras acciones rápidas.

  1. Haz clic en el icono de Bitbucket para abrir el cuadro de diálogo de Git

  2. A la izquierda, encontrarás una variedad de opciones de copia rápida auto-generadas como el nombre sugerido, el comando para revisar y enlazar una nueva rama localmente, el comando para enlazar un único commit, o el comando para abrir una solicitud de validación.

Captura de pantalla del cuadro de diálogo modal de la ramificación git en una tarea de ClickUp.

¡Puedes personalizar el nombre autogenerado utilizado en estas opciones en los ajustes de integración de Bitbucket!

Captura de pantalla de la configuración del nombre de la rama en Bitbucket.

Solicitudes de validación

¡Ahora puede crear solicitudes de validación desde ClickUp o enlazar las existentes! Para crear una nueva solicitud de validación en ClickUp:

  1. Haz clic en el icono de Bitbucket en la tarea que deseas vincular y pulsa el botón "Nueva solicitud de validación".

  2. En el cuadro de diálogo, se prellenará un título sugerido para la solicitud de validación. Si no te gusta el título generado automáticamente, puedes ajustarlo en los ajustes de integración de Bitbucket.

  3. Selecciona una rama objetivo y una rama fuente

  4. Introduce una descripción

  5. Crea la solicitud de validación

En cuanto crees una solicitud de validación en ClickUp o enlaces una existente, se añadirá a la solicitud de validación un enlace a la tarea de ClickUp asociada.

Captura de pantalla de una notificación de tarea vinculada en Bitbucket.

Una vez enlazada una solicitud de validación, podrás ver quién la abrió, el revisor (si hay alguno asignado), el estado de CI/CD y el estado de la solicitud de validación (abierta, revisión solicitada, en revisión, combinada, cerrada), ¡todo ello desde la tarea de ClickUp enlazada!

Captura de pantalla de la actividad de solicitud de validación en el modal git de ClickUp.

¿Problemas con Bitbucket?

Lee nuestro documento de solución de problemas o pregunta al soporte al cliente de Bitbucket aquí.

Elimina la integración con Bitbucket.

Solo los propietarios del entorno de trabajo y los administradores pueden desactivar integraciones.

Para eliminar la integración, desde el Centro de aplicaciones:

  1. Seleccione Bitbucket.
  2. Desplázate hacia abajo y haz clic en Eliminar autorización para mis repositorios de Bitbucket.

¿Fue útil este artículo?