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).
Conectar un proveedor
Aplicación GitHub o una clave
Configuración → Conexiones → Control de versiones
Los repositorios aparecen aquí
Los que la conexión puede alcanzar
Acceso de la aplicación o ámbito de la clave
Crear un proyecto
Un proyecto por repositorio
Proyectos → Nuevo
Primer análisis
Idiomas, comandos de compilación y prueba
Comprúbalo en la configuración del proyecto
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 leer el contenido del repositorio y crear ramas y solicitudes de incorporación de cambios.
En GitHub eso corresponde a 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.
Prueba Coroid sin escribir en tu repositorio
Selecciona Solo local en Modo de repositorio al crear el proyecto. Coroid entonces leerá del repositorio y mantendrá todas las ramas, commits y revisiones dentro de Coroid; nunca enviará cambios, comentarios ni abrirá pull requests. Cuando quieras pull requests, selecciona Iniciar sincronización en cualquier revisión o en la configuración del repositorio del proyecto. Consulta Sincronizado o solo local.
Un repositorio público de GitHub no necesita ninguna conexión: selecciona Conectar con URL, pegue la dirección del repositorio y valide el acceso. Sin una conexión de GitHub, Local only se selecciona de forma predeterminada, ya que Coroid puede leer un repositorio público pero no tiene nada para enviar.
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.