Problemas de GitHub
Soluciona organizaciones ausentes, repos faltantes, webhooks fallidos, errores de permisos y discrepancias de branch en la integración GitHub de Jamdesk.
La mayoría de los problemas de integración con GitHub se deben a permisos, fallos de webhook o discrepancias de branch.
La organización no aparece durante la configuración
Durante el flujo de configuración inicial de la documentación, Jamdesk muestra tus organizaciones de GitHub para que elijas dónde crear el repositorio. La lista proviene de la API OAuth de GitHub, y GitHub oculta organizaciones de ella en dos casos:
- Restricciones de la app OAuth: tu organización restringe el acceso de apps de terceros (valor predeterminado de GitHub para organizaciones nuevas) y aún no ha aprobado Jamdesk.
- SAML SSO: tu organización requiere autenticación SAML antes de que la API la devuelva.
Si eres propietario de la organización, puedes aprobar Jamdesk de inmediato:
- Haz clic en grant Jamdesk access on GitHub debajo del selector de organización (o ve a GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
- En Organization access, haz clic en Grant junto a tu organización
- De vuelta en el flujo de configuración de Jamdesk, haz clic en refresh the list. Tu organización aparece de inmediato
Si eres miembro (no propietario), verás en su lugar un botón Request; al hacer clic se envía una solicitud de aprobación a los administradores de tu organización.
Si eres miembro sin permisos de propietario, primero envía una solicitud de aprobación a tus administradores:
- Ve a GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
- En Organization access, haz clic en Request junto a tu organización. Esto notifica a los administradores de tu organización
- Un administrador la aprueba en Settings → Third-party access → OAuth application policy de la organización (las solicitudes pendientes muestran un botón Approve)
- Regresa al flujo de configuración de Jamdesk y haz clic en refresh the list; tu organización debería aparecer ahora
Consulta la guía de GitHub sobre cómo aprobar apps OAuth para tu organización para ver los pasos detallados.
¿No quieres esperar la aprobación del administrador? Elige tu cuenta personal durante la configuración y transfiere el repo a tu organización después:
- Completa la configuración de Jamdesk usando tu cuenta personal
- Ve al repositorio creado en GitHub
- Navega a Settings → General → Danger Zone
- Haz clic en Transfer y selecciona tu organización como destino
- En Jamdesk, desconecta y vuelve a conectar el repositorio desde la página Settings de tu proyecto
Desconectar y volver a conectar genera una nueva URL de documentación (por ejemplo, your-project.jamdesk.app puede cambiar). Si ya compartiste tu URL o configuraste un dominio personalizado, contacta a soporte antes de desconectar para que podamos preservar tu configuración.
El repositorio no aparece
Si tu repositorio no aparece en la lista:
- Ve a GitHub → Settings → Applications → Jamdesk
- Verifica que el repositorio tenga el acceso otorgado
- Haz clic en Configure para agregar más repositorios
Para repos de organización:
- Un administrador de la organización debe aprobar Jamdesk
- Ve a la configuración de la organización → Third-party access
- Aprueba la solicitud de acceso de Jamdesk
Los repos privados requieren autorización de GitHub. Vuelve a autorizar Jamdesk si es necesario.
Los builds no se activan
Si los pushes no activan builds:
- Ve a tu repo en GitHub
- Navega a Settings → Webhooks
- Busca el webhook de Jamdesk
- Revisa "Recent Deliveries" en busca de errores
Los builds solo se activan en tu branch configurado. Revisa Settings en Jamdesk.
- Ve a Settings del proyecto en Jamdesk
- Haz clic en Re-sync GitHub
Errores de Webhook
404 Not Found
No se pudo alcanzar el endpoint del webhook.
Solución: Vuelve a sincronizar la conexión de GitHub en la configuración del proyecto.
401 Unauthorized
Falló la autenticación.
Solución:
- Ve a la configuración de tu cuenta de GitHub
- Navega a Applications → Authorized OAuth Apps
- Revoca Jamdesk
- Vuelve a autorizar en la configuración de Jamdesk
500 Server Error
Problema temporal de Jamdesk.
Solución: Espera unos minutos y vuelve a hacer push, o activa un rebuild manual.
Errores de permisos
"Repository not found" durante el build:
- Es posible que el repositorio haya sido eliminado o renombrado
- Jamdesk puede haber perdido el acceso
- Vuelve a autorizar tu conexión de GitHub
Problemas de branch
Se está compilando el branch incorrecto
Verifica tu branch configurado en Settings → Repository.
Branch renombrado o eliminado
Actualiza la configuración de tu branch para que coincida con el nuevo nombre del branch.