GitHub se conecta ya sea a través de la Coroid Aplicación GitHub o a un token de acceso personal. Configúrelo en Configuración → Conexiones → Control de código fuente.
Aplicación o token
Le recomendamos usar la aplicación. Esta otorga acceso por repositorio en lugar de por usuario, sigue funcionando cuando la persona que la configuró se vaya y recibe eventos de webhook sin necesidad de realizar consultas periódicas.
Utilice un token cuando la instalación de la aplicación requiera una aprobación de administrador de organización que no pueda obtener.
| Aplicación GitHub | Token de acceso personal | |
|---|---|---|
| Ámbito de acceso | Por repositorio | Todo lo que el usuario pueda ver |
| Sigue activo aunque el instalador se vaya | Sí | No |
| Eventos de webhook | Sí | Consultas periódicas |
| Atribución | La aplicación | El propietario del token |
Instalación de la aplicación
Seleccione GitHub en Configuración → Conexiones → Control de código fuente y siga el flujo de instalación. GitHub le preguntará qué repositorios conceder; podrá modificar esto más tarde desde la configuración propia de GitHub.
Si un repositorio no aparece al crear un proyecto, es muy probable que la aplicación no haya recibido permiso para ese repositorio específico; esta es la causa más común con diferencia.
Uso de un token
Cree un token clásico con el ámbito de repo , o un token de granularidad fina con permisos de lectura y escritura en contenidos y solicitudes de extracción; luego pégalo en la configuración de control de versiones.
Los tokens se cifran en reposo, nunca los devuelve API y nunca se incluyen en las exportaciones de configuración.
Incidencias de GitHub
La misma conexión permite importar incidencias como tareas. Consulte Importación de tareas.
Eventos que se convierten en tareas
Con la aplicación, una automatización de eventos puede enviar un pull request, una nueva incidencia o un comentario que mencione a Coroid a Qualification. Consulte Desencadenadores y destinos.
El trabajo cualificado procedente de estos eventos solo se inicia por sí mismo cuando su autor tiene permisos de escritura, mantenimiento o administración en el repositorio. Coroid solicita a GitHub para cada evento. En el caso de un pull request, el autor es la persona que lo abrió, no quien lo etiquetó o fusionó. El trabajo generado por otras personas se crea y espera a que alguien lo inicie. Un comentario que mencione a Coroid solo cuenta cuando su autor tenga permisos de escritura.
Revisión de solicitudes de extracción
Con la aplicación, Coroid verifica y revisa las solicitudes de extracción que abren personas y otras herramientas, no solo las propias de Coroid. El Control de Calidad de Coroid ejecuta las comprobaciones del proyecto y publica la comprobación de Control de Calidad de Coroid. La Revisión de Coroid publica una revisión con comentarios sobre las líneas que cuestiona, y una comprobación llamada Revisión de Coroid. Ambas se configuran en Control de Calidad, bajo Solicitudes de extracción. Consulte Solicitudes de extracción.
Qué hace Coroid en su repositorio
- lee el código para entenderlo y modificarlo
- crea una rama por tarea
- envía esa rama y abre una solicitud de extracción de pull request contra su rama base
Nunca realiza commits en su rama predeterminada ni fusiona por sí mismo. La fusión ocurre solo cuando una persona fusiona el pull request en GitHub o pulsa Aprobar y fusionar en Coroid.
Un proyecto configurado como Solo local realiza la primera de estas acciones y nada más: Coroid lee y extrae datos, y mantiene las ramas, revisiones y comprobaciones dentro de Coroid. No envía, abre ni comenta en solicitudes de extracción, ni publica ejecuciones de comprobaciones, incluso cuando la aplicación o el token lo permitieran. Consulte Sincronizado o solo local.
Su protección de ramas, comprobaciones obligatorias y reglas de revisión se aplican sin cambios. Aprobar y fusionar también fusiona a través de pull request, por lo que las mismas reglas determinan si tiene éxito. Consulte Fusión.
Seguridad
Seguridad utiliza la aplicación para publicar la comprobación de Coroid Security , y, con permisos opcionales, para importar las alertas de seguridad propias de GitHub y verificar las colas de fusión. Consulte Permisos de GitHub y la comprobación de Seguridad de Coroid.