Coroid behöver åtkomst till ett repository innan det kan göra något. Du ansluter en leverantör för källkodshantering en gång på organisationsnivå och kopplar sedan enskilda repositoryn till projekt.
Anslutningar hanteras under Inställningar → Anslutningar → Källkodshantering
(/settings/connections/source-control).
Anslut en leverantör
GitHub App eller en token
Inställningar → Anslutningar → Källkodshantering
Repos visas
De som anslutningen har åtkomst till
Appåtkomst eller tokenomfattning
Skapa ett projekt
Ett projekt per repository
Projekt → Nytt
Första analysen
Språk samt bygg- och testkommandon
Se det i projektinställningarna
Leverantörer som stöds
| Leverantör | Anslutningsmetod | Tillgänglighet |
|---|---|---|
| GitHub | GitHub App-installation eller personlig åtkomsttoken | Allmänt tillgänglig |
| GitLab | Personlig åtkomsttoken | Privat förhandsvisning |
GitHub: App-installation eller token
För GitHub är det bättre att installera Coroid GitHub App. Appen ger åtkomst per repository i stället för per användare, fortsätter att fungera när personen som konfigurerade den slutar, och gör att Coroid kan ta emot webhook-händelser utan polling.
Välj i stället en personlig åtkomsttoken när App-installationen kräver ett administratörsgodkännande som du inte har.
Gå till Inställningar → Anslutningar → Källkodshantering, välj GitHub, och följ installationsflödet. GitHub frågar vilka repositoryn som ska få åtkomst. Du kan ändra detta senare i GitHubs egna inställningar.
Anslut med en personlig åtkomsttoken
Skapa tokenen hos din leverantör och klistra sedan in den under Inställningar → Anslutningar → Källkodshantering.
Tokenen behöver kunna läsa repositoryinnehåll och skapa brancher och pull requests. På GitHub är det scope repo för en klassisk token; på GitLab är det api.
Token krypteras innan de lagras och returneras aldrig av API eller visas igen i gränssnittet när du har sparat dem. De tas också bort från exportpaket med inställningar — ett exporterat paket innehåller en platshållare, och du anger hemligheten igen när du importerar det någon annanstans.
Koppla ett repository till ett projekt
En anslutning gör repositoryn tillgängliga; ett projekt är den plats där Coroid faktiskt arbetar. Skapa ett från Projekt → Skapa, välj det anslutna repositoryt, så gör Coroid en första genomgång av kodbasen för att identifiera språk, byggkommandon och testkommandon.
Den första analysen gör att en agent kan bygga och testa ditt projekt, så det är värt att kontrollera resultatet. Du kan rätta sådant som har tolkats fel under projektets inställningar.
Testa Coroid utan att skriva till ditt repository
Välj Endast lokalt under Repositoryläge när du skapar projektet. Coroid läser då från repositoryt och behåller alla branches, commits och granskningar i Coroid; det pushar aldrig, kommenterar aldrig och öppnar aldrig pull requests. När du vill ha pull requests väljer du Börja synka på en granskning eller i projektets repositoryinställningar. Läs mer om Synkat eller endast lokalt.
Ett offentligt GitHub-repository kräver ingen anslutning: välj Anslut med URL, klistra in repositoryadressen och verifiera åtkomsten. Utan en GitHub-anslutning är Endast lokalt förvalt, eftersom Coroid kan läsa ett offentligt repository men inte har något att pusha med.
Vilken branch Coroid arbetar från
Coroid utgår från din standardbranch och öppnar pull requests mot den. Du kan ändra basbranchen per projekt i projektets repositoryinställningar om du mergar till något annat än main.
Verifiera anslutningen
Anslutningen fungerar när repositoryt visas i listan för att skapa projekt och projektets första analys är klar. Om ett repository som du förväntar dig saknas är de vanligaste orsakerna:
- GitHub App installerades men fick inte åtkomst till det specifika repositoryt
- tokenens scope är för begränsat för att lista privata repositoryn
- repositoryt tillhör en annan organisation än den du anslöt
Nästa
Så blir en uppgift en pull request — vad som händer efter att du har beskrivit ett arbete.