Conectar Jira con Bitbucket

Jira es una de las herramientas más potentes para la planificación y gestión de proyectos de desarrollo de software y tareas. Se integra a la perfección con multitud de herramientas de desarrollo pero sin lugar a dudas nada supera su integración con Bitbucket. Gracias a esta integración se combina a la perfección los flujos de trabajo de desarrollo y administración.

Ambas herramientas son de Atlassian y ambos son productos maduros, enfocados en ayudar a los desarrolladores a construir software complejo.

En este pequeño tutorial nos vamos a centrar en como conectar Bitbucket Cloud con Jira Server, es decir, la integración de nuestra cuenta de Bitbucket en la nube en nuestro propia instalación de Jira.

Para conectar Jira Server con nuestra cuenta de Bitbucket Cloud usaremos el conector DVCS que nos facilita Jira. Además necesitaremos permisos de administración, tanto en nuestra instalación Jira como en nuestra cuenta Bitbucket.

Solo vamos a tener que realizar 2 pasos:

Paso 1: Crear un toquen de acceso OAuth para la cuenta de Bitbucket Cloud

El conector DVCS necesita un token de acceso OAuth que tendremos que crear en nuestra cuenta de Bitbucket Cloud.

1. Desde el avatar de la parte inferior izquierda, tendremos que pulsar en Configuración de Bitbucket. Ojo, si queremos crear este conector para un equipo Bitbucket tendremos que hacerlo desde este.
2. En el lateral derecho de la pantalla de Configuración clickearemos en un menú llamado OAuth.
3. Pulsaremos el botón Agregar consumidor.
4. Nos aparecerá una pantalla en la que tendremos que indicar tres valores:
   • Nombre: Un nombre identificativo del consumidor OAuth. Por ejemplo JIRA DVCS.
   • Descripción: Una breve descripción del motivo de este consumidor.
   • Url de remarcación: La url de nuestro Jira Server. (Por ejemplo https://jira.xxx.com).
5. Nos aparecerá una pantalla para indicar los permisos que tendrá nuestro consumidor:
   • Cuenta: Escribir
   • Repositorios: Administrador
   • Pull requests: Leer
6. Click en Guardar
7. Ya tenemos nuestro consumidor OAuth. Nos quedará hacer click en su nombre para recoger la clave y la clave secreta que nos hará falta para el segundo punto.
8. Dejaremos el navegador con la sesión Bitbucket abierta.

Paso 2: Agregue el token OAuth en el servidor de software Jira

Nos dirigiremos a nuestro Jira Server para insertar las credenciales creadas en Bitbucket.

1. Tendremos que acceder a Jira Server con un usuario con permisos de administración.
2. Clickearemos en el icono de configuración que se encuentra en la esquina superior derecha y elegiremos Aplicaciones.
3. Dentro de la sección de Integraciones, seleccionaremos el menú DVCS accounts.
4. Haremos click en Vincular cuenta Bitbucket Cloud o GitHub.
5. En la opción de Host elegiremos Bitbucket.
6. En la siguiente opción insertaremos el nombre de Usuario o Equipo de Bitbucket.
7. Tendremos que insertar los valores de clave y secreto OAuth que hemos obtenido antes en Bitbucket.
8. Pulsaremos en Add.
9. Se nos abrirá una pestaña donde tendremos que conceder los permisos.

Si todo ha ido bien la cuenta estará conectada y nos aparecerán todos los repositorios asociados a nuestro Usuario o Equipo en la página «Cuentas DVCS». La sincronización inicial se realiza automáticamente.

¿Cómo debemos hacer los commits a partir de ahora?

Cuando los desarrolladores realicen un commit deben indicar en éste la referencia de la incidencia. Un ejemplo:

git commit -m «COL-1 Refactoring code»

Donde COL-1 sera la referencia de la incidencia en Jira. Automáticamente el commit quedará asociado a la petición Jira, pudiendo acceder tanto desde Bitbucket a Jira como de Jira a Bitbucket.

Esperamos que os haya servido de ayuda para mejorar vuestra organización y flujo de desarrollo.