Puesta en marcha y configuración - Jira Cloud
Qué hace esta integración
La integración con Jira Cloud te permite crear un ticket de tipo Bug directamente desde la pantalla de detalle de un error en DockRay, sin copiar a mano el mensaje, la pila de llamadas ni la ruta de la petición. Crear un ticket guarda un vínculo permanente: un error de DockRay con un ticket de Jira. Cuando ese ticket alcanza en Jira la categoría de estado Done, DockRay marca el error como resuelto por sí solo - la lectura del estado es periódica, no instantánea: el comando thor:sync-jira comprueba los tickets vinculados cada cinco minutos.
Qué necesitas del lado de Jira
- una instancia de Jira Cloud en el dominio
*.atlassian.net- la integración solo acepta direcciones HTTPS públicas en ese dominio, - el correo de la cuenta de Atlassian que actuará en nombre de la integración,
- un token de API generado para esa cuenta (ajustes de la cuenta de Atlassian → Seguridad → Tokens de API),
- un proyecto de Jira al que deban llegar los tickets - la integración se mapea a un proyecto, no a un tablero, porque un tablero es solo una vista de un proyecto.
Conexión a nivel de cuenta
En el panel de DockRay ve a Ajustes → Jira e introduce la dirección de la instancia, el correo de la cuenta de Atlassian y el token de API. Esta conexión es compartida por todos los proyectos de la cuenta que no tengan credenciales propias - un proyecto concreto podrá sobrescribirla más adelante.
Configuración de un proyecto concreto
En Ajustes del proyecto → Jira elige el proyecto de Jira que debe recibir los tickets, un responsable por defecto y un estado inicial opcional. Un proyecto de DockRay puede usar las credenciales de toda la cuenta o tener las suyas propias - útil cuando distintos equipos de la empresa mantienen instancias de Jira separadas o cuentas de servicio distintas.
Qué entra en el contenido del ticket
La descripción del ticket es un documento en formato Atlassian Document Format: una cita con el tipo y el mensaje del error, una lista de datos (proyecto, entorno, petición, número de repeticiones, primera y última aparición de ese día, SDK cliente), el lugar del fallo con unas líneas de código alrededor de la línea afectada, una pila de llamadas resumida y un enlace de vuelta al panel de DockRay. Lo que se omite deliberadamente de esa descripción se explica en el siguiente artículo.
La primera prueba
Abre cualquier error existente en un proyecto y crea desde él un ticket de Jira. Comprueba en Jira que el ticket ha llegado al proyecto esperado, con una descripción que incluya el mensaje del error, el lugar del fallo y un enlace al panel de DockRay. Junto al error en DockRay debería aparecer ahora un enlace al ticket creado - la prueba visible de que el vínculo se ha guardado.