Solución de Problemas

​

¿La Revisión de Código de Kody No Funciona? Pasos para Solucionar Problemas Comunes

​

Problemas con el Token

• Usuarios de GitHub: Verifica que tu token esté habilitado para tu organización:
  1. Debes ser el propietario de la organización.
  2. Ve a la configuración de tu organización en GitHub:
     • Usa la siguiente URL y reemplaza YOUR_ORG_NAME con el nombre de tu organización: .
  3. En Tokens de Acceso Personal de Grano Fino, asegúrate de que “Permitir acceso mediante tokens de acceso personal de grano fino” esté seleccionado.
• Token de Acceso Personal (PAT): Confirma que tu token esté configurado para tu organización y tenga los permisos requeridos. Gestionar tokens.
• Vencimiento del Token: Asegúrate de que tu token esté activo. Verificar estado del token.

​

Problemas de Configuración

• Revisiones Automatizadas: Asegúrate de que Enable Automated Code Review esté activado en Code review → General en el alcance Global (abrir). Si están deshabilitadas, inicia las revisiones manualmente con @kody start-review.
• Categorías de Revisión: Asegúrate de que al menos una categoría (Bug, Performance, Security, Business Logic) esté activada para que Kody proporcione sugerencias, y revisa Minimum severity to post. Ambas opciones están en Code review → What to review (abrir).
• Revisiones de Ramas: Por defecto, Kody revisa los PRs mergeados en la rama predeterminada. Para incluir ramas adicionales, actualiza Base Branches en Code review → General (abrir).
• PRs Grandes: Ten en cuenta que los PRs con un alto número de cambios pueden tardar más en procesarse.

​

Configuración Global vs. de Repositorio

• Configuración Global: Aplicada a todos los repositorios por defecto.
• Configuración Específica del Repositorio: Si está configurada, anulará la configuración global para ese repositorio específico.

​

Pasos para Solucionar Problemas

1. Verificar la Configuración Global: Revisa y confirma que la configuración global sea correcta. Acceder a la Configuración Global.
2. Verificar la Configuración del Repositorio:
   • Abre el selector de alcance en la parte superior del grupo Code review en la barra lateral. Los repositorios (y directorios) con su propia configuración aparecen debajo de Global.
   • Confirma si hay configuraciones personalizadas para el repositorio en cuestión.
   • Comprueba también que el repositorio esté seleccionado para revisión en la página Repositories (barra lateral → Repositories).
3. Alinear o Limpiar Configuraciones:
   • Para aplicar la configuración global, limpia cualquier configuración específica del repositorio (el menú ⋯ del repositorio en el selector de alcance → Delete configuration).
   • Alternativamente, ajusta la configuración específica del repositorio para satisfacer tus necesidades.

​

Síntomas Comunes

• Las revisiones automatizadas no se activan para un repositorio.
• Kody aplica configuraciones o sugerencias inesperadas.
• La configuración global no se refleja en repositorios específicos.

​

Sin Respuesta o Sin Comentarios de Kody

1. ¿El PR contiene cambios de código revisables (no solo documentación o imágenes)? Kody puede omitir si no hay nada relevante para analizar.
2. ¿La rama está en alcance? Por defecto, solo se revisan los PRs que apuntan a la rama predeterminada, a menos que se configuren ramas base adicionales.
3. PRs Grandes: Kody revisa PRs con hasta 2.000 archivos revisables (después de aplicar Ignored files). Ejemplo: PR con 2.500 archivos totales pero 600 son archivos .lock → Kody revisa los 1.900 archivos restantes ✅
4. Modo: Si las revisiones automatizadas están deshabilitadas, actívalas manualmente con @kody start-review.
5. Cadencia de push: Si usas auto-pausa, espera el tiempo de enfriamiento o solicita una revisión manual.
6. Overrides del repositorio: Los ajustes específicos del repositorio pueden anular los globales. Límpialos o alinealos según sea necesario.