Forkar ”driver” inte iväg i tystnad. De förfaller tyst tills en hotfix landar uppströms, och då upptäcker du att din fork ligger 20 commits efter mitt under en release. Inte kul.
Det här är den typen av röra som drabbar byråägare som underhåller kundforkar, men interna plattformsteam känner av det också. Om du vill ha GitHub Telegram alerts som visar vilka forkar som ligger före eller efter (och med hur mycket), gör det här arbetsflödet kontrollen åt dig.
Du får se vad automatiseringen gör, vad du behöver för att köra den och vilka resultat du kan förvänta dig när den är på plats.
Så fungerar den här automatiseringen
Hela n8n-flödet, från trigger till slutresultat:
n8n Workflow Template: GitHub + Telegram: pålitliga fork drift-varningar
flowchart LR
subgraph sg0["When clicking ‘Execute workflow’ Flow"]
direction LR
n0@{ icon: "mdi:play-circle", form: "rounded", label: "When clicking ‘Execute workf..", pos: "b", h: 48 }
n1@{ icon: "mdi:swap-vertical", form: "rounded", label: "Loop Over Items", pos: "b", h: 48 }
n2["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/github.dark.svg' width='40' height='40' /></div><br/>get-repo-details"]
n3["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/telegram.svg' width='40' height='40' /></div><br/>Telegram"]
n4["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/telegram.svg' width='40' height='40' /></div><br/>Telegram Trigger"]
n5["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/code.svg' width='40' height='40' /></div><br/>Prepare Upstream URL"]
n6["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/httprequest.dark.svg' width='40' height='40' /></div><br/>Compare Branches API Call"]
n7["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/code.svg' width='40' height='40' /></div><br/>Process Comparison Result"]
n8["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/merge.svg' width='40' height='40' /></div><br/>Combine Results"]
n9["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/code.svg' width='40' height='40' /></div><br/>Format for Telegram"]
n10["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/code.svg' width='40' height='40' /></div><br/>Code"]
n11@{ icon: "mdi:swap-horizontal", form: "rounded", label: "If", pos: "b", h: 48 }
n12["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/github.dark.svg' width='40' height='40' /></div><br/>Get repos"]
n13@{ icon: "mdi:swap-horizontal", form: "rounded", label: "Filter forked repositories o..", pos: "b", h: 48 }
n11 --> n12
n10 --> n11
n12 --> n13
n8 --> n1
n1 --> n9
n1 --> n2
n4 --> n10
n2 --> n5
n9 --> n3
n5 --> n6
n6 --> n7
n7 --> n8
n13 --> n1
n0 --> n12
end
%% Styling
classDef trigger fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
classDef ai fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
classDef aiModel fill:#e8eaf6,stroke:#3f51b5,stroke-width:2px
classDef decision fill:#fff8e1,stroke:#f9a825,stroke-width:2px
classDef database fill:#fce4ec,stroke:#c2185b,stroke-width:2px
classDef api fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef code fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef disabled stroke-dasharray: 5 5,opacity: 0.5
class n0,n4 trigger
class n11,n13 decision
class n6 api
class n5,n7,n9,n10 code
classDef customIcon fill:none,stroke:none
class n2,n3,n4,n5,n6,n7,n8,n9,n10,n12 customIcon
Problemet: fork-drift blir till överraskningsjobb
Fork-drift är den långsammaste typen av teknisk skuld, eftersom den inte ser ut som skuld. Din fork bygger fortfarande. PR:er mergas fortfarande. Sedan släpper upstream en säkerhetsfix eller en brytande ändring, och plötsligt sitter du med att behöva stämma av veckor (eller månader) av divergens under tidspress. Än värre: ”statusen” för en fork är inte en siffra du kan ögna igenom. Den kan ligga före, efter eller både och, och du får veta det först när du pausar det du gör och börjar klicka runt i GitHub.
Friktionen byggs på. Här är det som oftast fallerar.
- Du kollar inte varje fork dagligen, så problemen upptäcks sent, ofta precis innan en deploy.
- Att jämföra brancher repo för repo är tidsödande, och så fort du blir avbruten tappar du bort var du var.
- ”Är den här forken säker att merga?” blir en Slack-tråd i stället för ett snabbt, gemensamt svar.
- Upstream-fixar missas, vilket innebär att du lägger riktiga timmar på att lösa problem som redan är lösta.
Lösningen: automatiska kontroller av fork-drift med en Telegram-rapport
Det här n8n-flödet övervakar forkarna i ett GitHub-konto och skickar ett strukturerat Telegram-meddelande när något hamnar ur synk. Det börjar med att hämta dina repositories från GitHub och filtrerar sedan listan till endast forkar. Därefter itererar det igenom varje fork i batchar, hämtar repo-detaljer och bygger rätt jämförelseanrop för forkens standardbranch mot upstream-repots standardbranch. Flödet anropar GitHubs compare-endpoint (via en HTTP-request), bearbetar resultatet för ”ahead/behind” och behåller bara forkar som inte är perfekt i linje. Till sist skapar det en lättläst rapport och skickar den till din Telegram-chatt, så att du kan agera innan drift blir en brandkårsutryckning.
Arbetsflödet startar när du triggar det i Telegram (eller kör det manuellt vid test). Därifrån validerar det din begäran, hämtar repos, loopar igenom de som är forkade och jämför brancher. Slutresultatet är en enda Telegram-uppdatering som visar vilka forkar som ligger före eller efter och med hur många commits.
Vad du får: automatisering vs. resultat
| Vad det här flödet automatiserar | Resultat du får |
|---|---|
|
|
Exempel: så här ser det ut
Säg att du underhåller 15 kundforkar. Att manuellt kontrollera drift brukar innebära att du öppnar varje repo, hittar upstream och kör en compare eller skannar i UI:t, vilket kanske är 2 minuter per repo en bra dag (alltså runt 30 minuter totalt). Med det här flödet skickar du ett snabbt Telegram-kommando, n8n kör jämförelserna i bakgrunden och du får ett enda meddelande tillbaka några minuter senare. Du går från en halvtimmes flik-hoppande till en enda ping som du kan läsa på under en minut.
Det här behöver du
- n8n-instans (testa n8n Cloud gratis)
- Alternativ för egen hosting om du föredrar det (Hostinger fungerar bra)
- GitHub för repo-åtkomst och data för branchjämförelser
- Telegram för att trigga kontroller och ta emot aviseringar
- GitHub personal access token (skapa den i GitHub Developer settings)
Svårighetsnivå: Nybörjare. Du klistrar in API-tokens, väljer ett GitHub-användarnamn och testar Telegram-meddelandet.
Vill du inte sätta upp det här själv? Prata med en automatiseringsexpert (gratis 15-minuterskonsultation).
Så fungerar det
Ett Telegram-meddelande triggar körningen. Du skickar ett kommando till din bot, och flödet tolkar indata så att det vet vilket konto som ska kontrolleras och hur många repos som ska behandlas.
Flödet validerar begäran och hämtar repos från GitHub. Det hämtar repo-listan för den ägare du anger och filtrerar sedan listan så att du bara behandlar forkar (inte allt under solen).
Varje fork jämförs mot sin upstream. n8n loopar igenom forkarna i batchar, hämtar repo-detaljer, bygger en compare-URL och gör en HTTP-request till GitHub för att ta reda på hur många commits forken ligger före eller efter.
En enda rapport landar i Telegram. Flödet slår ihop jämförelseresultaten, formaterar meddelandet så att det är lätt att skanna och skickar uppdateringen till ditt valda chatt-ID.
Du kan enkelt justera filtreringsreglerna för att ignorera arkiverade repos eller bara spåra vissa orgs utifrån dina behov. Se hela implementationsguiden nedan för anpassningsalternativ.
Steg-för-steg-guide för implementering
Steg 1: Konfigurera triggertypen
Det här arbetsflödet kan startas manuellt eller via kommandoinmatning i Telegram.
- Lägg till noden Manual Run Initiator för att möjliggöra manuella testkörningar.
- Lägg till noden Telegram Message Trigger för att ta emot inkommande kommandon från Telegram.
- I Telegram Message Trigger, behåll Updates inställt på
message. - Autentiseringsuppgifter krävs: Anslut era telegramApi-autentiseringsuppgifter i Telegram Message Trigger.
Steg 2: Anslut GitHub och hämta repositories
Konfigurera GitHub-åtkomst och definiera hur många repos som ska skannas genom kommandoparsning och validering.
- I Parse Command Input, behåll kommandologiken som den är för att parsa
/forkcheckoch extrahera antalet repos. - I Validate Repo Count, bekräfta att villkoret kontrollerar leftValue som
={{ $json.repos }}och operation somgtmed rightValue0. - Konfigurera Fetch User Repos med Limit inställt på
={{ $json.repos }}och Owner inställt på ert GitHub-användarnamn. - Autentiseringsuppgifter krävs: Anslut era githubApi-autentiseringsuppgifter i Fetch User Repos.
/forkcheck 50.Steg 3: Filtrera och batcha forkade repositories
Begränsa bearbetningen till forkade repositories och batcha dem för jämförelse och rapportering.
- I Filter Forked Repos, bekräfta att villkoret kontrollerar att
={{ $json.fork }}är lika medtrue. - Koppla Filter Forked Repos till Batch Iteration för att bearbeta repositories i batchar.
- Notera förgreningen: Batch Iteration skickar utdata både till Retrieve Repo Details och Compose Telegram Report parallellt.
Steg 4: Bygg och kör GitHub Compare-förfrågningar
Skapa upstream-jämförelse-URL:en, anropa GitHub Compare API och bearbeta svaret.
- I Retrieve Repo Details, säkerställ att Owner använder
={{ $json.owner.login }}och att Repository använder={{ $json.html_url }}. - Autentiseringsuppgifter krävs: Anslut era githubApi-autentiseringsuppgifter i Retrieve Repo Details.
- I Build Upstream Compare URL, behåll den medföljande JavaScript-koden för att generera
compareApiUrloch bädda inoriginal_repo_data. - I Compare Branches Request, sätt URL till
={{ $json.compareApiUrl }}och säkerställ att Authentication ärgenericCredentialTypemed genericAuthTypehttpHeaderAuth. - Autentiseringsuppgifter krävs: Anslut era httpHeaderAuth-autentiseringsuppgifter i Compare Branches Request.
- I Process Compare Output, behåll JavaScript-logiken som läser från Build Upstream Compare URL och sätter status, commitsBehind och commitsAhead.
- Koppla Process Compare Output till Merge Result Stream.
original_repo_data, kommer Process Compare Output att logga ett fel och returnera ERROR_PROCESSING_MERGE.Steg 5: Sätt ihop och skicka Telegram-rapporten
Sammanställ resultaten till en Telegram Markdown-rapport och skicka den till er chatt.
- I Compose Telegram Report, behåll JavaScript-koden för formatering av Markdown-tabell och sammanfattande antal.
- Bekräfta att utdata är ett enda item med
telegramMessage. - I Send Telegram Update, sätt Text till
={{ $json.telegramMessage }}och uppdatera Chat ID från[YOUR_ID]till ert Telegram-chatt-ID. - Autentiseringsuppgifter krävs: Anslut era telegramApi-autentiseringsuppgifter i Send Telegram Update.
Steg 6: Testa och aktivera ert arbetsflöde
Validera både manuella körningar och Telegram-triggade körningar innan ni aktiverar arbetsflödet.
- Klicka på Execute Workflow med Manual Run Initiator för att bekräfta att GitHub-data och Telegram-utdata genereras.
- Skicka ett Telegram-meddelande som
/forkcheck 25till er bot för att testa hela flödet från Telegram Message Trigger till Send Telegram Update. - En lyckad körning ska ge en formaterad rapport i Telegram med ahead/behind-antal och repo-länkar.
- Växla arbetsflödet till Active för produktionsanvändning.
Vanliga fallgropar
- GitHub-credentials kan gå ut eller sakna rätt scopes. Om något slutar fungera, kontrollera scopes för din Personal Access Token i GitHub Developer settings och uppdatera token i n8n-credentials.
- Om du använder Wait-noder eller extern rendering varierar processtiderna. Öka väntetiden om nedströmsnoder misslyckas på tomma svar.
- Telegram-meddelanden kan misslyckas om boten ännu inte får skicka meddelanden till dig. Öppna en chatt med din bot en gång och bekräfta sedan att chatt-ID:t i steget ”Send Report” matchar destinationen.
Vanliga frågor
Cirka 20 minuter om din GitHub-token och din Telegram-bot är redo.
Nej. Du kopplar konton och klistrar in en token. Den enda ”logiken” är att välja vilka repos som ska ingå och att testa meddelandeutdata.
Ja. n8n har ett gratis alternativ för egen hosting och en gratis provperiod på n8n Cloud. Molnplaner startar på 20 USD/månad för högre volym. Du behöver också räkna in användning av GitHub API (oftast gratis vid normala volymer).
Två alternativ: n8n Cloud (hanterat, enklast att komma igång) eller egen hosting på en VPS. För egen hosting är Hostinger VPS prisvärd och hanterar n8n bra. Egen hosting ger dig obegränsade körningar men kräver grundläggande serveradministration.
Ja, men du vill göra det på två ställen. Börja med att ändra filtreringslogiken i steget ”Filter Forked Repos” så att den bara behåller forkar som matchar en lista, ett org-namn eller ett namnmönster. Om du hellre vill styra det från Telegram, justera steget ”Parse Command Input” så att det tar emot en allowlist för repos och skicka sedan vidare den till filtret. Vanliga justeringar är att ignorera arkiverade forkar, exkludera repos baserat på topic och skicka separata rapporter per kund.
Oftast beror det på en token som gått ut eller har för snäva scopes. Skapa om din GitHub Personal Access Token, bekräfta att den kan läsa dina repos (och org-repos vid behov) och uppdatera sedan credential som används av ”Fetch User Repos” och compare-anropet. Om det bara fallerar för vissa repos handlar det ofta om behörigheter för privata repos eller SSO-auktorisering som inte godkänts.
Många – i praktiken beror det på din n8n-plan, GitHubs rate limits och hur många forkar du jämför per körning.
Ofta ja, eftersom det här flödet behöver iteration, filtrering och att slå ihop resultat till en rapport. n8n hanterar batching och branching snyggt, och egen hosting gör att du inte betalar per minimalt steg när du kontrollerar dussintals repos. Zapier och Make kan göra GitHub-aviseringar, men att bygga ”jämför varje fork, behåll bara de som driftat, och sammanställ sedan ett enda meddelande” blir lätt pilligt och kan bli dyrt vid volym. Om du bara har en eller två forkar kan en enklare tvåstegs-Zap räcka. Om du är osäker, prata med en automatiseringsexpert så tar vi fram det billigaste, pålitliga alternativet.
När det här väl kör, slutar fork-drift vara en smygande risk och blir i stället en enkel, lättläst Telegram-uppdatering. Sätt upp det en gång och gå tillbaka till att bygga.
Kontakta oss
Hör av dig, så diskuterar vi hur just din verksamhet kan dra nytta av alla fantastiska möjligheter som AI skapar.