GitHub ansluter antingen via Coroid GitHub-appen eller en personlig åtkomsttoken. Konfigurera den på Inställningar → Anslutningar → Versionshantering.
App eller token
Välj helst appen. Den ger åtkomst per repo i stället för per användare, fortsätter att fungera även om personen som konfigurerade den slutar och tar emot webhook-händelser utan att behöva polla.
Använd en token om installation av appen kräver ett godkännande från en organisationsadministratör som du inte kan få.
| GitHub-appen | Personlig åtkomsttoken | |
|---|---|---|
| Åtkomstomfattning | Per repo | Allt användaren har åtkomst till |
| Fungerar även om den som installerade den slutar | Ja | Nej |
| Webhook-händelser | Ja | Pollar |
| Attribuering | Appen | Tokenägaren |
Installera appen
Välj GitHub på Inställningar → Anslutningar → Versionshantering och följ installationsflödet. GitHub frågar vilka repos som ska få åtkomst. Du kan ändra det senare i GitHubs egna inställningar.
Om ett repo inte visas när du skapar ett projekt beror det nästan säkert på att appen inte har fått åtkomst till just det repot – det är den vanligaste orsaken med bred marginal.
Använda en token
Skapa en klassisk token med omfattningen repo eller en finkornig token med läs- och skrivbehörighet för innehåll och pull requests. Klistra sedan in den i inställningarna för källkontroll.
Token lagras krypterade och lämnas aldrig ut av API eller inkluderas i exporterade inställningar.
GitHub Issues
Samma anslutning stöder import av issues som arbete. Läs mer om Importera arbete.
Händelser som blir till arbete
Med appen kan en händelseautomatisering skicka en pull request, en ny issue eller en kommentar som nämner Coroid till Kvalificering. Se Utlösare och destinationer.
Kvalificerat arbete från dessa händelser startar automatiskt endast om upphovspersonen har skriv-, underhålls- eller administratörsåtkomst till repot. Coroid frågar GitHub för varje händelse. För en pull request är upphovspersonen den som skapade den, inte den som satte etiketten eller mergade den. Arbete från andra skapas och väntar på att någon ska starta det. En kommentar som nämner Coroid räknas bara om upphovspersonen har skrivåtkomst.
Granska pull requests
Med appen kontrollerar och granskar Coroid pull requests som personer och andra verktyg öppnar, inte bara Coroids egna. Coroids kvalitetskontroll kör projektets kontroller och publicerar kontrollen Coroid Quality Control. Coroid Review publicerar en granskning med kommentarer på rader som den ifrågasätter och en kontroll med namnet Coroid Review. Båda konfigureras under Pull requests i Kvalitetskontroll. Se Pull requests.
Vad Coroid gör i ditt repo
- läser kod för att förstå och ändra den
- skapar en branch per uppgift
- pushar branchen och öppnar en pull request mot din basbranch
Den gör aldrig commits till din standardbranch och mergar aldrig på egen hand. En merge sker bara när någon mergar pull request i GitHub eller trycker på Godkänn och merga i Coroid.
Ett projekt med inställningen Endast lokalt gör bara det första av följande: Coroid läser och hämtar ändringar, och håller brancher, granskningar och kontroller inom Coroid. Den pushar inte, öppnar eller kommenterar pull requests och publicerar inte kontroller, även om appen eller tokenen tillåter det. Se Synkroniserat eller endast lokalt.
Dina regler för branchskydd, obligatoriska kontroller och granskning gäller oförändrade. Godkänn och merga mergar också via pull request, så samma regler avgör om det lyckas. Se Mergning.
Säkerhet
Säkerhet använder appen för att publicera kontrollen Coroid Security och, med valfria behörigheter, importera GitHubs egna säkerhetsvarningar och kontrollera merge-köer.
Se GitHub-behörigheter och säkerhetskontrollen i Coroid.