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 hämta dem regelbundet.
Använd en token om installationen 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 kan se |
| Fungerar även om den som installerade den slutar | Ja | Nej |
| Webhook-händelser | Ja | Regelbunden hämtning |
| Attribution | 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 har appen nästan säkert inte fått åtkomst till just det repot – det är överlägset den vanligaste orsaken.
Använda en token
Skapa en klassisk token med behörigheten repo , eller en finkornig token med läs- och skrivåtkomst till innehåll och pull requests. Klistra sedan in den i inställningarna för källkontroll.
Token lagras krypterade, lämnas aldrig tillbaka av API och inkluderas aldrig i inställningsexporter.
GitHub-ärenden
Samma anslutning har stöd för att importera ärenden som arbete. Läs mer om Importera arbete.
Händelser som blir arbete
Med appen kan en händelseautomatisering skicka en pull request, ett nytt ärende eller en kommentar som nämner Coroid till kvalificering. Läs mer om Utlösare och destinationer.
Kvalificerat arbete från dessa händelser startas automatiskt endast om den som skapade händelsen 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 den som skapade den personen som öppnade den, inte den som satte en etikett på den eller slog ihop 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 den som skrev den har skrivåtkomst.
Granska pull requests
Med appen kontrollerar och granskar Coroid pull requests som öppnas av personer och andra verktyg, inte bara sina 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 ställs in under Pull requests i Kvalitetskontroll. Läs mer om Pull requests.
Vad Coroid gör i din källkod
- läser kod för att förstå och ändra den
- skapar en branch för varje uppgift
- pushar branchen och öppnar en pull request mot din basbranch
Den gör aldrig commits till din standardbranch och slår aldrig ihop något på egen hand. En merge sker bara när någon slår ihop pull request i GitHub eller trycker på Godkänn och slå ihop i Coroid.
Ett projekt inställt på Endast lokalt gör det första av detta och inget annat: Coroid läser och hämtar, och håller brancher, granskningar och kontroller inom Coroid. Den pushar inte, öppnar eller kommenterar pull requests och publicerar inte kontrollkörningar, även om appen eller token skulle tillåta det. Läs mer om Synkat eller endast lokalt.
Dina regler för branchskydd, obligatoriska kontroller och granskning gäller oförändrade. Godkänn och slå ihop gör även en merge via pull request, så samma regler avgör om den lyckas. Läs mer om Slå ihop.