Coroid necesita acceso a un repositorio antes de poder realizar cualquier acción. Vinculas un proveedor de control de código fuente una vez a nivel de organización y luego asocias repositorios individuales a proyectos.
Las conexiones se gestionan en Configuración → Conexiones → Control de código fuente
(/settings/connections/source-control).
Proveedores compatibles
| Proveedor | Método de conexión | Disponibilidad |
|---|---|---|
| GitHub | Instalación de la aplicación de GitHub o un token de acceso personal | Disponible para todos |
| GitLab | Token de acceso personal | Vista previa privada |
GitHub: Instalación de la aplicación o token
Para GitHub, instalar la aplicación de Coroid para GitHub es la mejor opción. La aplicación otorga acceso por repositorio en lugar de por usuario, sigue funcionando cuando la persona que la configuró se vaya y permite que Coroid reciba eventos de webhook sin necesidad de sondear.
Elige un token de acceso personal cuando la instalación de la aplicación requiera una aprobación de administrador que no poseas.
Para instalar la aplicación, ve a Configuración → Conexiones → Control de código fuente, selecciona GitHub, y sigue el flujo de instalación. GitHub te preguntará a qué repositorios conceder acceso; puedes modificarlo más tarde desde la configuración propia de GitHub.
Conexión mediante un token de acceso personal
Crea el token en tu proveedor y luego pégalo en Configuración → Conexiones → Control de código fuente.
El token debe poder leer el contenido del repositorio y crear ramas y solicitudes de incorporación de cambios. En GitHub ese es el ámbito de un token clásico; en GitHub es repo ámbito para un token clásico; en GitLab es api.
Los tokens se cifran antes de almacenarse y nunca los devuelve API ni se muestran de nuevo en la interfaz después de guardarlos. También se excluyen de los paquetes de exportación de configuración: un paquete exportado contiene un marcador de posición y debes volver a introducir el secreto al importarlo en otro lugar.
Asociar un repositorio a un proyecto
Una conexión hace que los repositorios estén disponibles; un proyecto es en lo que realmente trabaja Coroid. Crea uno desde Proyectos → Nuevo, selecciona el repositorio vinculado y Coroid realizará un primer análisis del código para detectar lenguajes, comandos de compilación y comandos de prueba.
Ese primer análisis es lo que permite que un agente compile y pruebe tu proyecto, por lo que vale la pena comprobar el resultado. Puedes corregir cualquier error que haya inferido bajo la configuración del proyecto.
De qué rama trabaja Coroid
Coroid parte de tu rama predeterminada y abre solicitudes de incorporación de cambios contra ella. Puedes cambiar la rama base por proyecto en la configuración del repositorio del proyecto si fusionas en algo distinto a main.
Verificar la conexión
La conexión funciona cuando el repositorio aparece en la lista de creación de proyectos y el primer análisis del proyecto se completa. Si falta un repositorio que esperabas, las causas más comunes son:
- la aplicación de GitHub se instaló pero no se le concedió acceso a ese repositorio específico
- el ámbito del token es demasiado limitado para listar repositorios privados
- el repositorio pertenece a una organización distinta a la que vinculaste
Siguiente
Cómo una tarea se convierte en pull request — lo que ocurre después de que describas algún trabajo.