Dokumentation

Automatiseringar

Arbete som startar utan att någon behöver be om det varje gång, enligt ett schema eller när något händer – och var du hittar det.

En automatisering startar arbete utan att någon behöver be om det varje gång. Den körs enligt ett schema eller när något händer: en pull request öppnas, ett ärende skapas, en kontroll eller driftsättning misslyckas.

Alla automatiseringar visas i mjukvarufabriken under Automatiseringar, tillsammans med vad som startar dem och vad de gör. Skapa en under Nytt arbete: välj Automatisering och sedan när den ska köras.

  • SchemaTid
  • Händelsestyrd automatiseringNågot händer

En vanlig uppgift

Specifikation, planering, bygge, verifiering och granskning. Använder en agentplats – ge uppgiften lägre prioritet.

P2P3

En pull request

Den kan inte göra en merge på egen hand eller göra en commit till din basgren.

Du godkänner

Det enda som skiljer automatiseringarna åt är vad som utlöser dem. Det som startas är en vanlig uppgift i det vanliga flödet, så den använder faktisk kapacitet och avslutas med en pull request som du godkänner.

Två typer av utlösare

UtlösareKörningarExempel
Ett schemaVid en bestämd tid, med ett visst intervall eller en gång nuBe Sentry om nya fel varje timme och skapa en uppgift för varje
Något händerNär GitHub eller Coroid skickar händelsenGranska varje pull request som öppnas i ett projekt

Använd ett schema när det faktiskt är tiden som utlöser arbetet, eller när det du vill bevaka finns i ett annat system som inte skickar Coroid-händelser, till exempel Sentry eller Jira. Schemat frågar systemet via dina MCP-servrar och skapar arbete utifrån det som hittas. Se Scheman.

Använd en händelse när Coroid kan få veta direkt när något händer. Det innebär mindre onödigt arbete än ett schema som frågar om och om igen.

Händelser du kan välja under Nytt arbete

Från GitHub, som kräver appen GitHub App:

  • en pull request öppnas, uppdateras eller mergas
  • ett ärende öppnas
  • en kommentar nämner Coroid; avsändaren måste ha skrivbehörighet till repot för att kommentaren ska räknas

Från Coroid:

  • en uppgift, en plan, en kvalitetskontroll, en driftsättning eller en hälsokontroll av driftsättningen misslyckas
  • en version återställs

Meddelanden från Slack och Telegram, nya Jira-ärenden och händelser som utlöses av dina egna system kräver ett filter eller ett tjänstekonto. Starta dem från en mall under Inställningar, i Automatisering, eller ändra händelsen i automatiseringens redigerare. Se Hooks.

Vad den gör

När händelsen utlöses gör automatiseringen en av tre saker:

  • Granska pull request. Coroid Check granskar det och publicerar sin granskning på GitHub, med kommentarer på raderna som den flaggar och en kontrollkörning med namnet Coroid Granskning. Tillgängligt för pull requests som öppnas eller uppdateras.
  • Gör om det till arbete. Händelsen registreras som en förfrågan. När kvalificeringen har godkänt den skapar Coroid uppgiften eller planen. Tillgängligt för ärenden och kommentarer som nämner Coroid.
  • Följ instruktionerna. En agent följer instruktionerna du har skrivit, med skrivskyddad åtkomst, och kan skapa uppgifter. Tillgängligt för alla händelser.

Ingen av dem ändrar koden direkt. Arbete som startas av en automatisering följer samma process för specifikation, planering, bygge, verifiering och granskning som allt annat och avslutas med en pull request som du godkänner.

Granska varje pull request

Så här gör du för att låta Coroid granska pull requests som andra öppnar, inte bara sina egna:

  1. Öppna Nytt arbete och välj Automatisering.
  2. Välj projektet, eller lämna fältet tomt för att omfatta alla projekt.
  3. Under Utlösare väljer du Något händer. Under Händelse väljer du Pull request öppnad och sedan Granska pull request.
  4. Ange en titel och en kort instruktion och fortsätt sedan.

Automatiseringen granskar varje ny pull request och alla uppdateringar av den i projektet. Repot behöver appen GitHub, och projektet får inte vara inställt på Endast lokalt. Pull requests från Coroids egna uppgifter granskas inte igen: granskningen ingår i uppgiften.

Du kan också aktivera Pull requests för projektet under Kvalitetskontroll. Då körs projektets kontroller även på varje pull request, och Coroid Check granskar den som en del av samma körning.

Följ en automatisering

Öppna en automatisering i mjukvarufabriken för att se varje körning: när den kördes, vad den kostade, vad den skapade och varför en körning inte slutfördes. Därifrån kan ägare och administratörer pausa, testa, redigera eller ta bort den. Alla i organisationen kan se automatiseringarna och deras körningar.

Få automatiseringarna att göra nytta

Arbete som startas av en automatisering använder samma agentplatser som allt annat. En automatisering som utlöses ofta kan obemärkt förbruka din kapacitet.

  1. Ge den lägre prioritet än arbete som personer har bett om. P2 eller P3.
  2. Gör utlösaren specifik. ”En kontroll misslyckades” utlöses hela tiden i ett aktivt repo. ”Den här kontrollen misslyckades på basgrenen” utlöses när något faktiskt är fel.
  3. Granska resultatet. Om en automatisering skapade tjugo uppgifter och du mergade två, skapar den brus och kostnader, inte värde.

Det bästa måttet på en automatisering är hur stor andel av arbetet den startar som mergas, inte hur ofta den utlöses.

Sentinel

I tidigare versioner av den här dokumentationen beskrevs Sentinel som en övervakare som bevakar ett villkor. Det är ingen separat funktion. Ett villkor är antingen en händelse som en automatisering kan köras på, eller något som ett schema kontrollerar.