​
Permisos de la Cuenta de Jira

Permisos Requeridos

Debes ser un Owner o Admin para instalar Jira Cloud en tu cuenta de organización de Rootly.

También debes tener derechos de admin en tu instancia de Jira Cloud.

Cuenta de Servicio

Para garantizar la mejor estabilidad a largo plazo de tu integración, se recomienda que integres con una cuenta de servicio de Jira, en lugar de una cuenta personal.

La cuenta de Jira que estás utilizando para la instalación necesita tener los siguientes permisos:

  • Asignar incidencias: Capacidad para asignar incidencias a usuarios específicos.
  • Cerrar incidencias: Capacidad para cerrar incidencias.
  • Crear incidencias: Capacidad para crear incidencias.
  • Eliminar incidencias: Capacidad para eliminar incidencias.
  • Editar incidencias: Capacidad para editar incidencias.
  • Vincular incidencias: Capacidad para vincular una incidencia con otra.
  • Transicionar incidencias: Capacidad para transicionar una incidencia de un estado a otro.

La cuenta de Jira que estás utilizando para la instalación necesita tener los siguientes permisos de oauth:

  • read:application-role:jira
  • read:avatar:jira
  • read:field-configuration:jira
  • read:group:jira
  • read:issue:jira
  • read:issue-status:jira
  • read:issue-meta:jira
  • read:issue-security-level:jira
  • read:issue-type:jira
  • read:issue-type-hierarchy:jira
  • read:issue.changelog:jira
  • read:issue.transition:jira
  • read:issue.vote:jira
  • read:priority:jira
  • read:project:jira
  • read:project-category:jira
  • read:project-version:jira
  • read:project.component:jira
  • read:project.property:jira
  • read:status:jira
  • read:user:jira
  • read:user.property:jira
  • write:attachment:jira
  • write:comment:jira
  • write:comment.property:jira
  • write:issue:jira
  • write:issue.property:jira

Puedes aprender más sobre los permisos de Jira aquí.

​
Instalación de una Instancia de Jira Cloud

Localiza Jira Cloud en el Catálogo de Integraciones y selecciona Setup.

Se te presentará la siguiente página de instalación. Verifica dos veces que estás instalando la instancia correcta antes de confirmar la instalación seleccionando Accept.

¡Eso es todo! Ya estás listo para comenzar a automatizar los flujos de trabajo de Jira.

​
Instalación de Instancias Adicionales

Si tu organización utiliza múltiples instancias de Jira Cloud, puedes instalar instancias adicionales utilizando el mismo procedimiento descrito anteriormente.

Una “instancia” de Jira Cloud NO es lo mismo que un “proyecto” de Jira. Piensa en una instancia de Jira Cloud como un dominio separado. Puedes tener múltiples proyectos de Jira dentro de una sola instancia. La mayoría de las organizaciones deberían tener solo una instancia, pero múltiples proyectos.

Para instalar una instancia adicional, localiza Jira Cloud en el Catálogo de Integraciones, nuevamente, y selecciona Set up another instance.

Los pasos siguientes son los mismos que para instalar la primera instancia.

Asegúrate de estar conectado a la instancia que pretendes instalar en la misma ventana del navegador en la que tienes abierto Rootly.

​
Configuración del Webhook de Jira

Rootly no solo te permite crear tickets en Jira, también es capaz de recibir actualizaciones de Jira y actualizar el incidente para reflejar los cambios de Jira. Para hacerlo, necesitarás configurar webhooks en Jira.

Como administrador de Jira, navega a Sistemas > WebHooks en tu instancia de Jira Cloud. Luego selecciona + Create a WebHook

Dale al webhook un Name fácil de identificar (por ejemplo, Rootly Webhook Listener) y copia la URL del webhook de tu plataforma Rootly.

Asegúrate de que el Status del webhook esté Enabled.

Copia la URL del webhook de la página de integraciones de Rootly en el campo URL en Jira.

Si no quieres que todos tus proyectos de Jira envíen eventos a Rootly, puedes filtrarlos en la consulta JQL de eventos relacionados con incidencias.

Selecciona los eventos específicos que te gustaría escuchar.

Finalmente, asegúrate de NO marcar la casilla Exclude body. A veces, los webhooks de Jira tendrán esto marcado por defecto.

Una vez que todos los campos anteriores estén ingresados, selecciona Create para guardar la configuración del webhook.

Ahora podrás ver los eventos de Jira aparecer en la página de Alertas en tu plataforma Rootly. Puedes probar esto creando o actualizando un ticket de prueba en Jira. Si el evento aparece en la página de Alertas, sabrás que el webhook está funcionando.

​
Desinstalación

Puedes desinstalar tu instancia de Jira Cloud en Rootly navegando a Integraciones > Jira y seleccionando Delete.

​
Soporte

Si necesita ayuda o más información sobre esta integración, por favor contacte a support@rootly.com o inicie un chat navegando a Ayuda > Chatear con nosotros.