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 på ett schema eller när något händer: en pull request öppnas, ett ärende skapas, en kontroll eller driftsättning misslyckas.

Alla automatiseringar finns listade i mjukvarufabriken under Automatiseringar, tillsammans med vad som startar dem och vad de gör. Skapa en under Nytt arbete: välj Automation och ange sedan när den ska köras och vad den ska göra, med egna ord.

  • 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 schemaVarannan timme eller varje dag, vecka eller månadBe Sentry leta efter nya fel varje timme och skapa en uppgift för vart och ett
Något händerNär GitHub eller Coroid skickar händelsenNär en uppgift misslyckas tar du reda på varför och skapar en uppgift som åtgärdar problemet

Använd ett schema när utlösaren faktiskt är tiden, 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 meddelas i samma ögonblick som något händer. Det innebär mindre onödigt arbete än ett schema som fortsätter att fråga.

Händelser du kan välja under Nytt arbete

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

  • en pull request öppnas, uppdateras eller mergas
  • ett ärende öppnas
  • en kommentar nämner Coroid; det räknas bara om den som skrev kommentaren har skrivbehörighet till repositoryt

Från Coroid:

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

Händelser som dina egna system skickar kräver ett tjänstekonto. Händelser från Slack, Telegram och Jira kräver ett filter: ändra händelsen för en automatisering i dess redigerare. Se Hooks.

Vad den gör

En agent följer dina instruktioner. Den kan läsa projektets kod och skapa uppgifter, men ändrar ingenting direkt. Arbete som den skapar följer samma flöde för specifikation, planering, byggande, verifiering och granskning som allt annat och resulterar i en pull request som du godkänner.

En automatisering kan också köra dina webbläsartester mot en testmiljö enligt ett schema.

Återkommande automatiseringar som Coroid skapar åt dig är reglage under Kvalitetskontroll, inte något du skapar under Nytt arbete:

  • Granska pull requests. Kvalitetskontrollens Pull requests -grupp kör projektets kontroller för varje pull request (Coroid Kvalitetskontroll) och låter Coroid Review kommentera den.
  • Gör om meddelanden och ärenden till förfrågningar. Meddelanden från Slack och Telegram, GitHub-kommentarer som nämner Coroid och nya Jira-ärenden blir förfrågningar när deras källa aktiveras under Före arbetet börjar i Kvalitetskontroll. Se Ärendehanteringssystem för Jira.
  • Följ upp misslyckanden. Ett misslyckat arbete, en misslyckad driftsättning och en återställd release har var sitt reglage under När något går fel.
  • Rensa upp gammal teknisk skuld. Ett projekts Veckovis rensning av teknisk skuld är ett reglage på raden Anti-slop.

På sidan för en automatisering som hanteras av ett reglage i Mjukvarufabrik står det vilket reglage det gäller, med en länk till reglaget. Pausa automatiseringen där eller stäng av den. Om du ändrar instruktionerna blir den din egen när du har bekräftat.

Automatiseringar som skapades tidigare och skapar förfrågningar fortsätter att köras och finns listade under Automatiseringar. Automatiseringar som granskade pull requests pausades när Kvalitetskontroll tog över Coroid Review.

Mallar under Nytt arbete

Tidigare fanns det mallar under Nytt arbete. De uppgifter de skötte har flyttats till reglagen ovan, och de två som publicerade till Slack kan du skriva med egna ord och ange kanalen. De publicerar via en MCP-server som du ansluter under Anslutningar i Inställningar. Schemalagda automatiseringar kan använda den, liksom händelsestyrda automatiseringar när du tillåter MCP-verktyg i redigeraren under Mjukvarufabrik. Automatiseringar som du skapade från en mall fortsätter att köras som förut. En gammal länk till en mall öppnar reglaget som ersatte den eller Nytt arbete.

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 automatiseringar och deras körningar.

Se till att automatiseringar fortsätter vara användbara

Arbete som en automatisering skapar konkurrerar om samma agentplatser som allt annat. En automatisering som utlöses ofta kan i det tysta förbruka din kapacitet.

  1. Ge den lägre prioritet än arbete som någon har bett om. P2 eller P3.
  2. Gör utlösaren specifik. ”En kontroll misslyckades” utlöses hela tiden i ett aktivt repository. ”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 är hur mycket av arbetet som automatiseringen skapar som mergas som visar dess verkliga värde, inte hur ofta den utlöses.

Sentinel

I tidigare versioner av dokumentationen beskrevs Sentinel som en bevakare som håller utkik efter ett villkor. Det är ingen separat funktion. Ett villkor är antingen en händelse som en automatisering kan reagera på eller något som kontrolleras enligt ett schema.