Conectar Jira Cloud: guía paso a paso
Crea una incidencia de tipo Bug por cada prueba que falla, añade un comentario cuando la prueba vuelve a fallar y la pasa a Done cuando la prueba se supera sin errores. Esta guía te lleva desde cero hasta una conexión verificada y enumera los errores que puedes encontrar con sus causas y soluciones.
Última actualización:
Mantén tus credenciales en privado. Nunca pegues un token, una clave, una contraseña ni una URL de webhook en un chat. Introdúcelos solo en Studio → Configuración → Integraciones, donde se guardan en el archivo .env de tu espacio de trabajo y se muestran como puntos. Lo mismo se aplica a un asistente de IA: puede guiarte por estos pasos, pero nunca necesita tu token.
Qué necesitas
- Un sitio de Jira Cloud, por ejemplo https://your-team.atlassian.net (solo Jira Cloud; la dirección debe usar https).
- El correo electrónico de tu cuenta de Atlassian y un token de API creado con esa misma cuenta.
- Una clave de proyecto, por ejemplo QA, cuyo proyecto tenga un tipo de incidencia llamado Bug.
- En ese proyecto, permisos para que esa cuenta pueda explorar, crear incidencias, añadir comentarios, crear archivos adjuntos y cambiar el estado de las incidencias.
Obtén las credenciales
- Abre https://id.atlassian.com/manage-profile/security/api-tokens y elige Crear token de API.
- Ponle un nombre (por ejemplo "Nexus StudioQA"), elige una fecha de caducidad, créalo y copia el token en ese momento. Atlassian solo lo muestra una vez.
- Mantenlo en el portapapeles. No lo pegues en ningún sitio excepto en Studio (siguiente paso).
Conéctalo en Studio
- En Studio, abre Configuración → Integraciones → Conectar Jira.
- Pega cualquier enlace de tu Jira (la página de inicio, un tablero o una incidencia) y pulsa Comprobar conexión. Studio guarda la dirección del sitio y la clave del proyecto.
- Cuando te lo pida, introduce tu correo electrónico de Atlassian y el token, y pulsa Guardar & comprobar.
- Selecciona el proyecto en "Destino de los errores" y activa
JIRA_ENABLED.
Comprueba que funciona
- Comprobar conexión muestra "Sesión iniciada como <tu nombre>" y "<KEY> admite incidencias de tipo Bug". La comprobación solo consulta datos; nunca crea una incidencia.
- Abre Configuración → Integraciones → Incidencias y pulsa Crear incidencia de prueba. Se crea una incidencia con la etiqueta nexus-test y es el único botón de esa sección que realiza una llamada a Jira.
- Abre esa incidencia en Jira y confirma que tiene las etiquetas auto-generated, nexus-studioqa-automation y nexus-test. Elimínala cuando hayas terminado.
Errores habituales
| Lo que ves | Causa | Solución |
|---|---|---|
| "Eso no es un enlace" o "Un enlace de Jira empieza por https://" | El texto pegado no es una dirección web completa o empieza por http://. | Copia la dirección de la barra de direcciones mientras estás en tu sitio de Jira. Debe empezar por https://. |
| HTTP 401 | El correo electrónico o el token son incorrectos, el token ha caducado o se ha revocado, o el correo electrónico no corresponde a la cuenta que creó el token. | Crea un token nuevo en id.atlassian.com con la cuenta cuyo correo electrónico guardaste y vuelve a guardar ambos en Configuración. |
| HTTP 403 | El inicio de sesión funciona, pero Jira indica que esa cuenta no tiene autorización para hacerlo: normalmente falta el permiso Crear incidencias, Añadir comentarios o Crear archivos adjuntos en el proyecto. | Pide esos permisos al administrador del proyecto o elige otro proyecto. Nexus StudioQA no puede concederlos. |
| HTTP 404 | La dirección del sitio o la clave del proyecto no existe, o esa cuenta no puede ver el proyecto (Jira devuelve 404 para los proyectos que oculta). | Pega cualquier enlace del sitio correcto y elige el proyecto de la lista. |
| "Esa dirección respondió, pero no con una cuenta de Jira" | La dirección no corresponde a un sitio de Jira Cloud (por ejemplo, es una dirección de Server o Data Center, u otra página web). | Usa la dirección https://<team>.atlassian.net de tu sitio de Jira Cloud. |
| "<KEY> no tiene ningún tipo de incidencia llamado Bug" | El proyecto no tiene ningún tipo de incidencia llamado Bug, por lo que no se puede crear ninguna incidencia. | En Jira, abre Configuración del proyecto → Tipos de incidencia y añade Bug, o elige otro proyecto. |
| "no se pudo conectar con Jira (ENOTFOUND)" o "no respondió en 20 s" | Este equipo no puede conectarse al sitio: hay un error en la dirección, una VPN o un proxy, o no hay conexión de red. | Corrige la dirección y luego abre el sitio en un navegador en el mismo equipo. Repite la comprobación. |
| Todo está correcto, pero no aparece ninguna incidencia | JIRA_ENABLED es false; o el resultado fue FLAKY o un resultado de entorno; o fue una ejecución en un entorno aislado; o ya existe una incidencia Bug abierta para esa prueba (si el fallo se repite, se añade un comentario); o se creó una incidencia Bug con el mismo título en las últimas 24 horas. | Activa JIRA_ENABLED, lee "Una incidencia por prueba" en la página de integraciones y usa Crear incidencia de prueba para verificar la conexión. |
| Una prueba superada no cierra su incidencia | El flujo de trabajo no tiene ninguna transición con el nombre indicado en JIRA_DONE_TRANSITION, por lo que solo se añade el comentario a la incidencia. | Establece JIRA_DONE_TRANSITION con el nombre exacto del botón de transición de tu flujo de trabajo. |
Claves de configuración
| Clave | Qué hace | Valor válido | Cómo comprobarlo |
|---|---|---|---|
JIRA_ENABLED | Crear incidencias de Jira para los fallos | true o false | Activa la integración y luego ejecuta Crear incidencia de prueba. |
JIRA_BASE_URL | Dirección del sitio de Jira | https://<site>.atlassian.net | Comprobar conexión muestra el sitio; al pegar un enlace, se rellena este campo. |
JIRA_EMAIL | Correo electrónico de inicio de sesión en Jira | El correo electrónico de la cuenta de Atlassian a la que pertenece el token | Comprobar conexión muestra "Sesión iniciada como …" con este correo electrónico. |
JIRA_API_TOKEN | Token de acceso de Jira (secreto, guardado solo en este equipo) | Una sola línea, sin comillas ni espacios | Comprobar conexión: HTTP 401 significa que la combinación de correo electrónico y token es incorrecta. |
JIRA_PROJECT_KEY | Proyecto de Jira para incidencias Bug | La clave del proyecto, normalmente en mayúsculas, por ejemplo QA | El desplegable de proyectos lo muestra; "acepta incidencias Bug" confirma el tipo. |
JIRA_DONE_TRANSITION | Estado de Jira cuando se supera la prueba | El nombre exacto de una transición del flujo de trabajo, sin distinguir entre mayúsculas y minúsculas | Si la prueba se supera sin problemas, la incidencia cambia de estado; si el flujo de trabajo no tiene esa transición, solo se le añade un comentario. |
Más: todas las integraciones, la guía de configuración, solución de problemas. Otras guías: Azure Boards, Slack, Microsoft Teams, Telegram, GitHub Issues.
¿Sigues sin poder avanzar? Escribe a [email protected] e incluye la línea exacta del error que muestra Studio. No incluyas ningún token.