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.
• In het volgende scherm kunt u extra projecten selecteren waaraan u deze integratie wilt toevoegen.

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, gaat u naar de pagina van GitHub Action.

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 u in de vorige sectie Github Actions hebt ingesteld, kunt u geheime tokens intrekken. Ga dan naar deze instelpagina en kies 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.