Automatiseren met GitHub

Dit artikel is voor InfraNest-gebruikers die willen dat hun infrastructuurautomatiseringen reageren op activiteit in hun GitHub-repositories en automatisch actie ondernemen op GitHub — zonder programmeerwerk.

Overzicht

• Bouw automatiseringen die in de gaten houden wat er op GitHub gebeurt, zoals een mislukte workflow-run of een nieuwe pull request, en automatisch reageren.
• Trigger GitHub-acties — zoals het aanmaken van een issue of het mergen van een pull request — vanuit elke automatisering in InfraNest.
• Alles wordt visueel ingesteld in de automatiseringsbouwer, met GitHub-triggers en -acties.

NoteVoordat je GitHub-triggers of -acties kunt gebruiken, moet je je GitHub-account koppelen. Als je eerst een GitHub-trigger kiest, herinnert InfraNest je eraan om te koppelen.

GitHub verbinden

1. Ga naar Integraties.
2. Zoek GitHub en selecteer GitHub verbinden.
3. Kies Verbinden met {provider} of GitHub App installeren, en volg de stappen om toegang te autoriseren.
4. Zodra de koppeling is gemaakt, verschijnen GitHub-triggers en -acties gegroepeerd onder GitHub in de automatiseringsbouwer.

Reageren op GitHub-activiteit

1. Open Automatiseringen en selecteer Nieuwe automatisering.
2. Kies bij Wanneer dit gebeurt de optie Bij gebeurtenis.
3. Kies een GitHub-trigger, zoals:
   • GitHub-workflow-run — gestart, afgerond, mislukt of geslaagd
   • GitHub-issue of GitHub-issuecomment — geopend, gesloten, gelabeld, toegewezen of becommentarieerd
   • GitHub-push, GitHub branch/tag aangemaakt of GitHub branch/tag verwijderd
   • GitHub-pull request of GitHub PR-review — geopend, gemerged, gesloten, goedgekeurd of wijzigingen aangevraagd
   • GitHub-release — gepubliceerd
   • GitHub-deployment, GitHub-deploymentstatus, GitHub-commitstatus, GitHub check run of GitHub check suite
4. Gebruik Voorwaarde toevoegen om Alleen als-filters toe te voegen — bijvoorbeeld alleen voor de main-branch, een specifieke repository, alleen mislukkingen, of alleen je Organisatie-account in plaats van een persoonlijk account.
5. Begin met typen in het veld Repository (owner/repo) om te kiezen uit je gekoppelde repositories.

Actie ondernemen op GitHub

1. Ga in je automatisering naar Doe dit en selecteer Actie toevoegen.
2. Kies een GitHub-actie uit de lijst, zoals:
   • GitHub-workflow starten, GitHub-workflow opnieuw uitvoeren, Mislukte jobs opnieuw uitvoeren, of GitHub-run annuleren
   • GitHub-issue aanmaken, Reageren op GitHub-issue, GitHub-issue bijwerken, GitHub-issue sluiten, GitHub-issue heropenen, Labels toevoegen, Label verwijderen, of GitHub-issue toewijzen
   • Pull request mergen, of PR-review aanvragen van personen of een Teams-item
   • GitHub-deployment aanmaken, Deploymentstatus instellen
   • GitHub-release aanmaken
   • Commitstatus instellen
3. Vul de velden voor die actie in — bijvoorbeeld Repository (owner/repo), Workflow-bestand of id, Branch of tag, Omgeving, Labels (komma-gescheiden), Toegewezen personen (komma-gescheiden), of Reviewers.
4. Voor elk veld kun je direct een waarde typen, een suggestie kiezen uit je gekoppelde GitHub-account, of Waarde invoegen gebruiken om een placeholder uit de trigger over te nemen.
5. Selecteer opnieuw Actie toevoegen om meer stappen toe te voegen, of Automatisering opslaan als je klaar bent.

Voorbeelden

• SSL-verlenging mislukt → GitHub-issue aanmaken, voeg het label infrastructure toe, en gebruik GitHub-issue toewijzen om het toe te wijzen aan je DevOps-team.
• Een monitor is herstelt → Reageren op GitHub-issue, gevolgd door GitHub-issue sluiten.
• Een pull request is gemerged in main → GitHub-workflow uitvoeren om te deployen, gevolgd door Deploymentstatus instellen.
• Je productie-healthcheck is geslaagd → Commitstatus instellen op geslaagd.
• Er is een release gepubliceerd → Statuspagina-aankondiging plaatsen.

Tips

• Wanneer één actie iets aanmaakt — zoals een issue of een deployment — kunnen latere stappen in dezelfde automatisering dit automatisch herbruiken, zonder extra instellingen.
• Voor het aanvragen van een review van een Teams-item is een Organisatie-koppeling nodig, geen persoonlijk account.

TipSommige acties tonen een Pro-badge in de bouwer — deze vereisen een hoger abonnement om te gebruiken.

Problemen oplossen

• Als een GitHub-trigger nooit afgaat, controleer dan of GitHub correct is verbonden onder Integraties, en vraag je beheerder om te bevestigen dat de app is geabonneerd op dat type gebeurtenis.
• Als een automatisering Laatste uitvoering mislukt toont of Automatisch uitgeschakeld na herhaalde fouten wordt, open dan de automatisering en controleer Runhistorie voor details, en gebruik vervolgens Opnieuw proberen of Opnieuw uitvoeren indien nodig.