Dokumentation

Inställningar för repository och branch

Vilken branch Coroid utgår från, vart pull requests hamnar och hur brancher namnges.

Varje projekt är kopplat till ett repository. Repository-inställningarna styr hur Coroid interagerar med din branch-modell.

Du hittar dem under projektets inställningar.

Synkat eller endast lokalt

Repositoryläget avgör om Coroid får skriva till GitHub eller GitLab.

  • Synkat (standard): Coroid pushar en branch för varje uppgift och öppnar pull requests mot din basbranch.
  • Endast lokalt: Coroid klonar och hämtar ändringar från repositoryt, men skriver aldrig till det. Inga pushar, inga brancher på fjärrservern, inga pull requests, kommentarer, granskningar, checkkörningar eller webhooks, inga mergar och inga pipelinekörningar. Brancher, commits, granskningar, QA och förhandsvisningar sker alla i Coroid.

Synkroniserat

CoroidGitHub
  • Hämtar från GitHub
  • Pushar grenar och öppnar pull requests

Endast lokalt

CoroidGitHub
  • Hämtar från GitHub
  • Pushar aldrig, lämnar aldrig kommentarer och öppnar aldrig pull requests
  • Du hämtar dess grenar från Git i Coroid
Med lokalt läge kan du testa Coroid på ett riktigt repository: det läser från GitHub och håller alla grenar, commits och granskningar inom Coroid. Börja synka när du vill skapa pull requests.

Välj läge när du skapar projektet och ändra det under projektets inställningar. Ett projekt med läget Endast lokalt visar Endast lokalt bredvid repositorynamnet.

Endast lokalt är ett säkert sätt att testa Coroid med ett riktigt repository. Uppgifter och planer körs hela vägen fram till granskning. Där en pull request skulle finnas visar granskningen Sparas i Coroid och en åtgärd, Börja synka. För att godkänna krävs ett synkat projekt, eftersom godkännandet mergar ändringar till din basbranch. I en plan samlas uppgifterna fortfarande på planens branch i Coroid. Coroids kopia av din basbranch är alltid identisk med fjärrversionen, så inget når den utan att du har öppnat en pull request.

Om du vill granska arbetet på din egen dator öppnar du Klona och exportera i repositoryinställningarna, skapar en åtkomsttoken och hämtar Coroids brancher från dess eget git:

git remote add coroid https://coroid@git.coroid.ai/git/<project-id>.git
git fetch coroid

Börja synka ändrar projektet till Synkat. Därefter pushas nytt arbete och får pull requests. Arbete som redan sparats i Coroid ligger kvar där: öppna dess pull request från granskningssidan (Skapa pull request för en uppgift, Öppna pull request för en plan). Om du byter tillbaka till Endast lokalt börjar det gälla direkt.

I läget Endast lokalt påverkas ingenting av hur din token är begränsad: Coroid vägrar alla skrivningar till själva repositoryt, oavsett vad anslutningen annars tillåter. Läget följer med projektets branchinställningar i portabilitet för inställningar.

Basbranch

Coroid utgår från din basbranch och öppnar pull requests mot den. Som standard används repositoryts standardbranch.

Ändra den om du mergar någon annanstans — till exempel till en develop branch, en release train eller en långlivad integrationsbranch. Detta är det vanligaste konfigurationsfelet och märks genom att pull requests riktas mot en branch som ingen granskar.

När målbranchen ändras

En plan registrerar basbranchens commit som den utgår från. Om basbranchen ändras innan planens pull request mergas stoppar Coroid mergningen. Se När basbranchen uppdateras. Den här inställningen avgör vad som händer sedan:

  • Pausa för granskning (standard) – någon granskar de nya commit­sen och godkänner dem eller ber Coroid att merga in dem och verifiera igen.
  • Merga och verifiera igen – Coroid mergar ändringarna till planens lane-branch och kör utvecklaren, QA-agenten och granskaren igen utan att invänta någon. Det förbrukar agenttimmar. Om mergningen eller verifieringen misslyckas går beslutet tillbaka till en person.

Oavsett vilket mergas inget förrän planen har kontrollerats mot den aktuella basbranchen eller en person har godkänt avvikelsen. Inställningen ingår i projektets branchinställningar och följer därför med dem i portabilitet för inställningar.

Arbetsbrancher

Varje uppgift arbetar på sin egen branch. Brancher skapas för varje uppgift och pushas när arbetet är klart (ett projekt med läget Endast lokalt sparar dem i Coroid), så två uppgifter som körs samtidigt delar aldrig branch och kan inte se varandras pågående arbete.

Inget committas någonsin direkt till din basbranch. Det är inte en inställning, utan en egenskap hos hur Coroid fungerar.

En gren per uppgift. Uppgifter delar aldrig gren.

Dina obligatoriska granskningar och statuskontroller gäller precis som vanligt.

Du mergear till main

Varje uppgift får en egen gren utifrån din basgren. Arbetet kommer tillbaka endast som en pull request, enligt de skyddsregler för grenar som redan finns.

Branchskydd

Ditt befintliga branchskydd gäller oförändrat. Coroid öppnar en vanlig pull request, så obligatoriska granskningar, obligatoriska statuskontroller och begränsningar för vem som får merga fungerar exakt som för ditt team.

Om dina skyddsregler kräver en signerad commit eller en specifik statuskontroll som Coroid inte kan skapa öppnas pull request och förblir sedan omöjlig att merga — det är dina regler som fungerar, inte ett fel i Coroid.

Rensning

Brancher för slutfört arbete kan rensas bort efter att deras pull request har mergats eller stängts. Om du använder branchnamn för granskning eller releaseverktyg bör du kontrollera detta innan du aktiverar det.

Ändra anslutningen

Om anslutningen till det underliggande repositoryt ändras — en token roteras, en app installeras om eller ett repository byter namn — behåller projektet sin identitet och historik. Peka om det till den nya anslutningen i stället för att skapa ett nytt projekt, så att du inte förlorar kontext, inställningar och tidigare arbete.

Inställningar för releasepipeline

Basgrenen styr var Coroid öppnar pull requests. Deployment använder en separat projektkonfiguration för Releaser konfiguration: en miljö, dess beredskapspolicy och valfritt en GitHub Actions- eller GitLab-pipeline-ref och ett deployment-jobb. Refen måste hänvisa till releasens låsta commit innan Coroid begär en körning. Konfigurera en callback-autentiseringsuppgift som är bunden till miljön så att pipelinen kan rapportera resultatet; enbart repoanslutningen bevisar inte vad som distribuerades. Externa pipelines kan rapportera händelser utan att aktivera körningar från Coroid.