Conectar GitHub Issues: guía paso a paso
Abre una incidencia de GitHub por cada prueba fallida, añade un comentario cuando la prueba vuelve a fallar y la cierra cuando la prueba se supera sin problemas. GitHub no admite la carga de archivos, por lo que la incidencia indica la carpeta de evidencias en lugar de adjuntar la captura de pantalla. 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
- Una cuenta de GitHub que pueda abrir incidencias en el repositorio (un colaborador o el propietario).
- Un repositorio con las incidencias activadas (Configuración del repositorio → Funciones → Incidencias).
- Un token de acceso personal de permisos específicos con Incidencias → Lectura y escritura en ese repositorio, o un token clásico con el ámbito repo.
Obtén las credenciales
- Abre https://github.com/settings/personal-access-tokens/new (un token de permisos específicos).
- Asígnale un nombre, establece una fecha de caducidad y, en Acceso a repositorios, elige Solo repositorios seleccionados; después, selecciona el repositorio que recibirá las incidencias.
- En Permisos → Permisos del repositorio, establece Incidencias en Lectura y escritura. No se necesita nada más.
- Genera el token y cópialo ahora. GitHub solo lo muestra una vez. No lo pegues en ningún sitio salvo en Studio (siguiente paso).
Conéctalo en Studio
- En Studio, abre Configuración → Integraciones → Conectar GitHub Issues.
- Cuando se te solicite, introduce el token y pulsa Guardar & comprobar. Studio muestra a quién pertenece el token y a cuántos repositorios tiene acceso.
- Selecciona el repositorio en "Destino de las incidencias". La lista solo muestra los repositorios a los que el token tiene acceso y que tienen las incidencias activadas.
- Activa
GITHUB_ISSUES_ENABLED.
Comprueba que funciona
- Comprobar conexión muestra "sesión iniciada como <you>" y "<owner/repo> admite incidencias". La comprobación solo lee datos; nunca abre una incidencia.
- Abre Configuración → Integraciones → Tickets y pulsa Crear ticket de prueba en el destino de GitHub. Se abrirá una incidencia con la etiqueta nexus-test.
- Ábrela en GitHub, comprueba la etiqueta y ciérrala o elimínala cuando termines.
Errores habituales
| Lo que ves | Causa | Solución |
|---|---|---|
| "GitHub rechazó el token (401)" | El token es incorrecto, ha caducado, se ha revocado o no se ha copiado por completo. | Crea un token nuevo con Incidencias → Lectura y escritura y vuelve a guardarlo. |
| HTTP 403 | El token no tiene el permiso de Incidencias, el repositorio no se seleccionó para ese token o se ha agotado el límite de solicitudes. | Edita el token: establece Incidencias en Lectura y escritura y selecciona el repositorio. Si el problema es el límite de solicitudes, espera unos minutos. |
| HTTP 404 | El repositorio no existe, ha cambiado de nombre o el token no tiene acceso a él (los repositorios privados deben seleccionarse en un token de permisos específicos). | Selecciona el repositorio de la lista o añádelo al acceso a repositorios del token. |
| HTTP 422 | GitHub rechazó un campo de la incidencia, normalmente una persona asignada que no es colaboradora, o un título o una etiqueta que GitHub no admite. | Borra la persona asignada en Configuración → Integraciones → Tickets, o añádela como colaboradora. |
| "<repo> tiene las incidencias desactivadas" | El repositorio tiene desactivada la función de incidencias. | Activa Configuración → Funciones → Incidencias en el repositorio, o elige otro. |
| "no se pudo conectar con GitHub (…)" o "no respondió a tiempo" | Este equipo no puede conectarse a api.github.com: hay una VPN o un proxy, o no hay conexión de red. | Abre github.com en un navegador en el mismo equipo y vuelve a intentar la comprobación. |
| Todas las comprobaciones son correctas, pero no aparece ninguna incidencia | GITHUB_ISSUES_ENABLED es false; o el resultado fue FLAKY o un resultado relacionado con el entorno; o fue una ejecución en un entorno aislado; o la prueba ya tiene una incidencia abierta (si vuelve a fallar, se añade un comentario). | Activa GITHUB_ISSUES_ENABLED y usa Crear ticket de prueba para verificar la conexión. |
Claves de configuración
| Clave | Qué hace | Valor válido | Cómo comprobarlo |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | Crear incidencias en GitHub para los fallos | true o false | Activa esta opción cuando Comprobar conexión dé un resultado correcto, y luego ejecuta Crear incidencia de prueba. |
GITHUB_ISSUES_TOKEN | Token de acceso de GitHub (secreto, guardado solo en este equipo) | Una sola línea, sin comillas ni espacios | Comprobar conexión: "se rechazó el token" significa que es incorrecto, ha caducado o se ha revocado. |
GITHUB_ISSUES_REPO | Repositorio de GitHub para incidencias | propietario/repositorio, como acme/web | Selecciónalo de la lista; Studio solo guarda un repositorio al que el token tenga acceso y que tenga las incidencias activadas. |
Más: todas las integraciones, la guía de configuración, solución de problemas. Otras guías: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
¿Sigues sin poder avanzar? Escribe a [email protected] e incluye la línea exacta del error que muestra Studio. No incluyas ningún token.