Problemas de GitHub
Soluciona organizaciones faltantes durante la configuración, repositorios faltantes, webhooks fallidos, errores de permisos y discrepancias de ramas con la integración de GitHub de Jamdesk.
La mayoría de los problemas con la integración de GitHub se deben a permisos, fallos en webhooks o discrepancias de ramas.
Organización no aparece durante la configuración
Durante el flujo de documentación inicial, Jamdesk muestra tus organizaciones de GitHub para que puedas elegir dónde crear el repositorio. Si tu organización no aparece en la lista, generalmente se debe a una de estas dos razones:
- Restricciones de apps OAuth: tu organización restringe el acceso de aplicaciones de terceros (el valor predeterminado de GitHub para nuevas organizaciones).
- SAML SSO: tu organización requiere autenticación SAML antes de que la API la devuelva.
Los administradores de la organización pueden otorgar acceso a Jamdesk:
- Ve a Configuración de tu organización de GitHub
- Selecciona Third-party access (en Seguridad)
- Busca Jamdesk en las solicitudes pendientes, o haz clic en Grant para aprobarlo
- Regresa al flujo de configuración de Jamdesk; tu organización debería aparecer ahora
Si no ves una solicitud pendiente, inicia primero el flujo de configuración de Jamdesk. GitHub envía automáticamente una solicitud de acceso a los administradores de tu organización cuando autorizas la app. Consulta la guía de GitHub sobre aprobar apps OAuth para tu organización para los pasos detallados.
¿No quieres esperar la aprobación del administrador? Elige tu cuenta personal durante la configuración y transfiere el repositorio 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 de 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.
Repositorio no aparece
Si tu repositorio no aparece en la lista:
- Ve a GitHub → Settings → Applications → Jamdesk
- Verifica que el repositorio tiene acceso otorgado
- Haz clic en Configure para agregar más repositorios
Para repositorios de organizaciones:
- 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 repositorios privados requieren autorización de GitHub. Vuelve a autorizar Jamdesk si es necesario.
Builds no se activan
Si los push no activan builds:
- Ve a tu repositorio 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 rama configurada. Verifica en Settings de 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: Resincroniza 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 acceso
- Vuelve a autorizar tu conexión de GitHub
Problemas de ramas
Rama incorrecta en el build
Verifica tu rama configurada en Settings → Repository.
Rama renombrada o eliminada
Actualiza la configuración de tu rama para que coincida con el nuevo nombre de rama.