GitHub & Asana | Producthandleiding

Overzicht

Met de Asana voor GitHub-integratie kunt u automatisch statusupdates voor GitHub pull-aanvragen synchroniseren met Asana-taken om cross-functional samenwerking te verbeteren.

Deze integratie helpt de zichtbaarheid en transparantie van engineeringwerk tussen technische en niet-technische teams te vergroten. Met deze nieuwe integratie kunnen ontwikkelaars moeiteloos communiceren via Asana om teams en cross-functional belanghebbenden op de hoogte te houden en te voorkomen dat werk door de mazen van het net valt.

De Asana voor GitHub-integratie is beschikbaar voor alle Premium-, Business-, en Enterprise-klanten.

Installatie voor Asana en GitHub Actions

Verbind Asana en GitHub om uw statussen voor pull-aanvragen te synchroniseren. Om de integratie te gebruiken, wordt de configuratie ingesteld in Asana en voor extra functies ook binnen GitHub.

• Selecteer GitHub door te klikken op +Toevoegen aan project.
• Volg de instructies om uw GitHub-account te autoriseren.
• De Asana voor GitHub-integratie wordt op projectniveau geïnstalleerd.

Gefeliciteerd, u kunt nu GitHub pull-aanvragen aan Asana-taken koppelen. Als u extra functionaliteit met de integratie wilt inschakelen, bekijk dan de volgende sectie. Anders gaat u verder naar belangrijke functionaliteit hieronder.

GitHub Actions configureren:

Deze sectie veronderstelt basiskennis van git en GitHub repository-geheimen. Als u geen toegang hebt om repositorygeheimen in te stellen, neem dan contact op met de repository-eigenaar.

Wij ondersteunen twee soorten GitHub Actions:

1. Automatiseren van meldingen van GitHub pull-aanvragen in Asana: Deze actie geeft de status van de pull-aanvraag op de Asana-taak. Het bevat de titel van de pull-aanvraag met een link naar de bijbehorende Asana-taak. Om dit in te stellen, gaat u naar de GitHub Action-pagina.
2. Verbind bijlagen van de pull-aanvragen vanuit beschrijvingen van de GitHub pull-aanvragen met Asana: Deze actie verbindt automatisch een GitHub pull-aanvraag met Asana-taken, door de URL van Asana-taken aan de beschrijving van de pull-aanvraag toe te voegen. Om dit in te stellen, ga je naar de GitHub Action-pagina.

Net als bij andere GitHub Actions, worden ze alleen uitgevoerd wanneer een gebeurtenis plaatsvindt in de repository waarvoor u de acties hebt ingesteld. U kunt bijvoorbeeld een actie instellen die elke keer wordt uitgevoerd wanneer iemand een pull-aanvraag samenvoegt of commentaar geeft.

Elk van deze GitHub Actions moet afzonderlijk ingesteld worden, tenzij er meerdere, identieke acties in dezelfde repository zijn. U kunt bijvoorbeeld een actie instellen om commentaar te geven op de taak in de beschrijving van de pull-aanvraag wanneer een test voltooid is, en een andere actie om een ander commentaar aan de taak toe te voegen wanneer de pull-aanvraag samengevoegd wordt.

GitHub Actions kunnen ook toegevoegd worden als onderdeel van een bestaande workflow. Raadpleeg de GitHub Actions-gids voor meer informatie.

Geheime tokens intrekken

Als je in de vorige sectie Github Actions hebt ingesteld, kun je geheime tokens intrekken. Ga naar deze instelpagina en selecteer Alles intrekken.

Dit zal alle bestaande GitHub Actions geheime tokens intrekken.

U kunt nog steeds pull-aanvraaginformatie zien in de bestaande Asana-projecten waar u deze integratie hebt toegevoegd.

Belangrijkste functionaliteit

Een pull-aanvraag toevoegen aan een Asana-taak (in Asana):

Na de GitHub-integratie in Asana geïnstalleerd te hebben, zult u nu een GitHub-veld kunnen zien bij elke taak in het bijbehorende project.

Om een pull-aanvraag aan een Asana-taak toe te voegen, haalt u de URL voor de pull-aanvraag op en plakt u deze in het lege GitHub-veld. Er zou nu een widget met de volgende details moeten verschijnen op de Asana-taak: beoordelingsstatus, build-status, PR-status, lijnwijzigingen en aantal gesprekken binnen GitHub.

Een pull-aanvraag toevoegen aan een Asana-taak (in GitHub):

Nadat u de GitHub-integratie in Asana hebt geïnstalleerd en GitHub Actions hebt ingesteld, kunt u nu automatisch een pull-aanvraag aan een Asana-taak toevoegen vanuit een beschrijving van de GitHub pull-aanvraag.

Haal in uw beschrijving van de GitHub pull-aanvraag de URL van de Asana-taak op en plak die in de beschrijving. Er zou nu een widget met de volgende details moeten verschijnen wanneer u de taak in Asana bekijkt: beoordelingsstatus, build-status, PR-status en lijnwijzigingen.

Eventuele fouten moeten worden weergegeven op het tabblad GitHub Actions in GitHub.

Samenvoegingen van pull-aanvragen ontvangen en updates sluiten:

Pull-aanvragen kunnen in GitHub gesloten worden nadat de juiste teams de wijzigingen bekeken en samengevoegd hebben. De status in de Asana-widget wordt automatisch bijgewerkt.

Als u een nieuwe GitHub pull-aanvraag wilt toevoegen, kunt u de URL van de Asana-taak toevoegen aan de nieuwe beschrijving van de GitHub pull-aanvraag en de widget wordt automatisch vervangen, of u kunt de gesloten pull-aanvraag binnen Asana verwijderen door op het menu rechtsboven te klikken. Eenmaal verwijderd, kunt u een nieuwe URL voor GitHub pull-aanvragen invoeren.

Nadat u de GitHub-integratie in Asana hebt geïnstalleerd en GitHub Actions hebt ingesteld, zult u nu reacties op Asana-taken ontvangen met een open pull-aanvraag toegevoegd. Dit zal updates bevatten over of de pull-aanvragen al dan niet zijn samengevoegd of gesloten.

Veelgestelde vragen

• Kan hetzelfde gegenereerde geheim in meerdere repositories gebruikt worden?
  • Ja
• Kunnen mijn teamgenoten informatie zien over de pull-aanvragen die ik aan een Asana-taak toevoeg, zelfs als ze geen toegang hebben tot de pull-aanvraag?
  • Ja. Als u een pull-aanvraag aan een taak toevoegt, kan iedereen die de taak kan bekijken, de informatie in de widget zien.
• Maakt het genereren van een nieuw token mijn oude geheime token onbruikbaar?
  • Nee, uw oude geheime tokens zullen nog werken. Als u uw bestaande geheime tokens wilt uitschakelen, kunt u dat [hier] doen (https://github.integrations.asana.plus/auth?domainId=manage_tokens).
• Kan hetzelfde gegenereerde geheim in meerdere repositories gebruikt worden?
  • Ja
• Wanneer ik het workflow-bestand probeer te pushen, zegt git dat mijn token geen toegang heeft om workflows te maken. Wat moet ik doen?
  • Als u tweestapsverificatie gebruikt en op de commandoregel met GitHub communiceert, vereist GitHub dat u uw persoonlijke toegangstoken als wachtwoord gebruikt. Maak een nieuw GitHub persoonlijk toegangstoken met het workflowbereik.
• Waarom vragen wij deze GitHub-toestemmingen aan?
  • Wij lezen en schrijven alleen van pull-aanvragen in deze integratie. De toestemming op de authenticatiepagina is de meest beperkende toestemming die GitHub ons toestaat aan te vragen om pull-aanvragen te kunnen openen.
• Wat gebeurt er als de GitHub Action een pull-aanvraag toevoegt aan een taak in een project waarvoor de integratie niet geactiveerd is?
  • Een bijlage die naar de pull-aanvraag linkt, is zichtbaar in de sectie met taakreacties, maar de widget die de status van de pull-aanvraag synchroniseert, wordt niet weergegeven.