GitHub och Asana | Produktguide

Översikt

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.

Asana för GitHub-integreringen är tillgänglig för alla Premium-, Business- och Enterprise-kunder.

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.

skärmbild av hur en app läggs till från anpassa-menyn

Konfigurera i Asana:

  1. Gå till ett Asana-projekt där du vill installera Asana för GitHub-integreringen. Klicka på den nedrullningsbara menyn Anpassa i det övre högra hörnet.
  2. Bläddra ner till Appar och välj +Lägg till app.

Github-app

  • Välj GitHub genom att klicka på +Lägg till i projekt.
  • 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 funktionalitet 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 sidan för GitHub-åtgärder.
  2. Anslut bilagor relaterade till 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ågningens beskrivning. För att ställa in den här åtgärden 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. Om du vill ta reda på mer kan du läsa GitHub Actions resursguide.

Å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 Revoke all.

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-fält i uppgift

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.

länk till Github pull-förfrågan

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.

Beskrivning av Github pull-förfrågan

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.

uppdateringar

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?
  • 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.

Vi stöder tyvärr inte den här webbläsaren

Asana fungerar tyvärr inte med webbläsaren du använder. Använd i stället en av följande stödda webbläsare för att registrera dig.

Välj språk

När du väljer ett språk ändras språket och/eller innehållet på asana.com