GitHub och Asana integrering

Gå till vår prissättningssida för mer information.

Med Asana + GitHub-integreringen kan du automatiskt synkronisera statusuppdateringar för GitHub pull-förfrågningar till Asana-uppgifter och därigenom förbättra tvärfunktionellt samarbete.

Den här integreringen bidrar till att öka synligheten och transparensen kring tekniskt arbete mellan tekniska och icke-tekniska team. Med den här nya integreringen kan utvecklare enkelt kommunicera via Asana för att hålla team och tvärfunktionella intressenter informerade och förhindra att arbete glöms bort.

Denna integration stödjer inte GitHub Enterprise Server.

Installation för Asana och GitHub Actions

Anslut Asana och GitHub för att synkronisera statusen på dina pull-förfrågningar. Om du vill använda integreringen ställer du in konfigurationen i Asana och för ytterligare funktioner även i GitHub.

screen of adding app with customize menu

Konfigurera I Asana:

  1. Gå till ett Asana-projekt där du vill installera Asana för GitHub-integreringen. Klicka på knappen Anpassa i det övre högra hörnet.
  2. Rulla nedåt till Appar och välj + Lägg till app
Github app
  • Välj GitHub
  • Följ instruktionerna för att godkänna ditt GitHub-konto.
  • GitHub + Asana-integreringen kommer att installeras på projektnivå.

Grattis, du kan nu ansluta GitHub-pull-förfrågningar till Asana-uppgifter. Om du vill aktivera ytterligare funktioner med integreringen kan du läsa nästa avsnitt. I annat fall kan du gå vidare till Huvudfunktioner nedan.

Konfigurera GitHub Actions:

Det här avsnittet förutsätter att man är bekant med grunderna i git och GitHub-kataloghemligheter. Om du inte har den åtkomst som krävs för att ställa in hemligheter för katalogen kan du kontakta katalogens ägare.

Vi stöder två sorters GitHub Actions:

  1. Automatisera aviseringar för GitHub-pull-förfrågningar i Asana: Den här åtgärden kommenterar statusen för pull-förfrågningar på Asana -uppgiften. Den innehåller titeln på pull-förfrågan med en länk till den associerade Asana-uppgiften. För att ställa in den går du till åtgärdssidan i GitHub.
  2. Ansluta bilagor relaterade till beskrivningar av beskrivningar av GitHub-pull-förfrågningar till Asana: Den här åtgärden kopplar automatiskt en GitHub pull-förfrågan till en eller flera Asana uppgifter genom att lägga till Asana uppgiftens webbadresser till pull-förfrågans beskrivning. För att ställa in den går du till åtgärdssidan i GitHub.

I likhet med andra GitHub Actions utförs de endast när en händelse inträffar i den katalog som du har ställt in åtgärderna för. Du kan till exempel ställa in en åtgärd som utförs varje gång någon sammanfogar eller kommenterar en pull-förfrågan.

Var och en av dessa GitHub Actions måste konfigureras individuellt, om det inte finns flera identiska åtgärder i samma katalog. Du kan till exempel konfigurera en åtgärd om att kommentera uppgiften i pull-förfrågningens beskrivning när ett test är slutfört och en ytterligare åtgärd om att lägga till en annan kommentar till uppgiften när pull-förfrågningen sammanfogas.

GitHub Actions kan också läggas till som en del av ett befintligt arbetsflöde. Läs mer i GitHub Actions resursguide med referens.

Återkalla hemliga token

Om du konfigurerade Github Actions i föregående avsnitt kan du återkalla hemliga token. Gå till den här inställningssidan och välj Återkalla alla.

Det här återkallar alla befintliga hemliga token för GitHub Actions.

Du kommer fortfarande att kunna se information om pull-förfrågan i de befintliga Asana projekt där du har lagt till den här integreringen.

Huvudfunktioner

Bifoga en pull-förfrågan till en Asana-uppgift (i Asana):

När du har installerat GitHub-integreringen i Asana kan du se ett GitHub-fält i varje uppgift i det associerade projektet.

Github field on task

Om du vill bifoga en pull-förfrågan till en Asana-uppgift hämtar du pull-förfrågningens webbadress och klistrar in den i det tomma GitHub-fältet. En widget med följande information bör nu synas i Asana-uppgiften: granskningsstatus, status för bygge (Build), PR-status, radändringar och antal konversationer inom GitHub.

Github pull request link

Bifoga en pull-förfrågan till en Asana-uppgift (i GitHub):

När du har installerat GitHub-integreringen i Asana och konfigurerat GitHub Actions kan du automatiskt bifoga en pull-förfrågan till en Asana-uppgift från en beskrivning av en GitHub pull-förfrågan.

Github pull request description

I beskrivningen för din GitHub-pull-förfrågan hämtar du Asana-uppgiftens webbadress och klistrar in den i beskrivningen. En widget med följande information bör nu visas när du visar uppgiften i Asana: granskningsstatus, status för bygge, PR-status och radändringar.

Eventuella fel bör återspeglas på fliken GitHub Actions i GitHub.

Hur man får uppdateringar om sammanfogningar och stängningar av en pull-förfrågan:

Pull-förfrågningar kan stängas i GitHub efter att de berörda teamen har granskat och sammanfogat ändringarna. Statusen i Asana-widgeten uppdateras automatiskt.

Om du vill bifoga en ny GitHub-pull-förfrågan kan du lägga till Asana-uppgiftens webbadress till beskrivningen av den nya GitHub-pull-förfrågan så att widgeten automatiskt ersätts, eller så kan du ta bort den stängda pull-förfrågan i Asana genom att klicka på menyn uppe till höger. När du har tagit bort den kan du ange en ny webbadress för GitHub-pull-förfrågan.

När du har installerat GitHub-integreringen i Asana och konfigurerat GitHub Actions får du kommentarer till Asana-uppgifter med en öppen pull-förfrågan bifogad. De kommer att innehålla uppdateringar om huruvida pull-förfrågningar har sammanfogats eller stängts.

updates

Vanliga frågor

Kan samma genererade hemlighet användas i flera arkiv?

Ja

Kan mina teamkollegor se information om de pull-förfrågningar jag bifogar till en Asana-uppgift, även om de inte har åtkomst till pull-förfrågningen?

Ja. När du bifogar en pull-förfrågan till en uppgift kan alla som kan se uppgiften se informationen i widgeten.

Inaktiverar genereringen av en ny token min gamla hemliga token?

Nej, dina gamla hemliga token fungerar fortfarande. Om du vill inaktivera dina befintliga hemliga token kan du göra det här.

Kan samma genererade hemlighet användas i flera arkiv?

Ja

När jag försöker skicka arbetsflödesfilen säger git att min token inte har åtkomst till att skapa arbetsflöden. Vad ska jag göra?

Om du använder tvåfaktorsautentisering och interagerar med GitHub på kommandoraden kräver GitHub att du använder din personliga åtkomsttoken som lösenord. Skapa en ny personlig GitHub-åtkomsttoken med arbetsflödets omfattning.

Varför begär vi de här GitHub-behörigheterna?

Vi läser och skriver endast från pull-förfrågningar i den här integreringen. Behörigheten på autentiseringssidan är den mest restriktiva behörighet som GitHub tillåter oss att begära för att få åtkomst till pull-förfrågningar.

Vad händer om en GitHub Action bifogar en pull-förfrågan till en uppgift i ett projekt som inte har integreringen aktiverad?

En bifogad fil som länkar till pull-förfrågan kommer att vara synlig i uppgiftens kommentarsfält, men widgeten som synkroniserar statusen för pull-förfrågan kommer inte att visas.

Gillar du det du ser? Börja med en 30-dagars gratis Asana -provperiod i dag. Prova gratis.

Var denna artikel till hjälp?

Thanks for your feedback