Dela via

Azure Repos med Slack

  • Artikel

Azure DevOps Services

Om du använder Slackkan du använda appen Azure Repos för Slack för att enkelt övervaka dina Azure Repos-lagringsplatser. Konfigurera och hantera prenumerationer för att ta emot meddelanden i kanalen när kod skickas eller checkas in och när en pull-begäran (PR) skapas, uppdateras eller sammanfogas. Den här appen stöder både Git- och Team Foundation Version Control-händelser (TFVC).

Förutsättningar

Not

  • Du kan bara länka Azure Repos-appen för Slack till ett projekt som finns i Azure DevOps Services just nu.
  • Aviseringar stöds för närvarande inte i direktmeddelanden.

Lägga till Azure Repos-appen till din Slack-arbetsyta

  1. Gå till Azure Repos Slack-appen och välj Lägg till i Slack.

    Skärmbild av Slack-appkatalogen, Azure Repos och knappen Lägg till i Slack.

    När du har lagt till får du något som liknar följande välkomstmeddelande.

    Skärmbild av välkomstmeddelande från Slack.

  2. Använd /azrepos Slack-handle för att interagera med appen. En fullständig lista över kommandon finns i avsnittet Kommandoreferens i den här artikeln.

Ansluta Azure Repos-appen till dina lagringsplatser

  1. Anslut och autentisera dig själv till Azure Repos med hjälp av kommandot /azrepos signin.

    Skärmbild av inloggningsprompten för Slack.

  2. Välj Logga in.

  3. Acceptera Azure Repos Slack-anslutningen.

    Skärmbild av knappen Acceptera i den resulterande inloggningsskärmen.

    En verifieringskod visas för användning i chattappen för att slutföra autentiseringen.

  4. Kopiera autentiseringskoden.

    Skärmbild av verifieringskod som tillhandahålls av Azure Repos.

  5. Välj Ange kod, klistra in koden och välj sedan Skicka.

    Skärmbild av den slutliga autentiseringsskärmen när verifieringskoden klistras in och sedan knappen Skicka väljs.

    Bekräftelse av inloggning visas i chatten.

    Skärmbild av inloggningsbekräftelse i chatten.

Om du vill börja övervaka alla Git-lagringsplatser i ett projekt använder du följande snedstreckskommando i en kanal:

/azrepos subscribe [project url]

Projekt-URL:en kan vara till valfri sida i projektet (förutom URL:er till lagringsplatser). Till exempel:

/azrepos subscribe https://dev.azure.com/myorg/myproject/

Du kan också övervaka en specifik lagringsplats med hjälp av följande kommando:

/azrepos subscribe [repository url]

Lagringsplatsens URL kan vara till valfri sida i din lagringsplats som har namnet på lagringsplatsen. För Git-lagringsplatser använder du till exempel:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

För TFVC-lagringsplatser använder du:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Not

Du kan bara prenumerera på offentliga lagringsplatser.

Med prenumerationskommandot kommer du igång med en standardprenumeration. För Git-lagringsplatser prenumererar kanalen på den Pull-begäran som skapats händelse (med målgrenen = main) och för TFVC-lagringsplatser prenumererar kanalen på den Kod som är incheckad händelsen.

Skärmbild som visar meddelandet om att skapa standardprenumerationer.

Hantera prenumerationer

Om du vill visa, lägga till eller ta bort prenumerationer för en kanal använder du följande subscriptions kommando:

/azrepos subscriptions

Det här kommandot visar alla aktuella prenumerationer för kanalen och gör att du kan lägga till nya prenumerationer eller ta bort befintliga prenumerationer. När du lägger till prenumerationer kan du anpassa de meddelanden du får med hjälp av olika filter, enligt beskrivningen i följande avsnitt.

Not

Teamadministratörer kan inte ta bort eller ändra prenumerationer som skapats av projektadministratörer.

Skärmbild som visar listan Över prenumerationer.

Använda filter för att anpassa prenumerationer

När en användare prenumererar på en lagringsplats med kommandot /azrepos subscribe skapas en standardprenumeration. Användarna behöver ofta anpassa dessa prenumerationer. Användarna kanske till exempel bara vill få aviseringar när PR:er har en specifik granskare.

Följande steg visar hur du anpassar prenumerationer.

  1. Kör kommandot /azrepos subscriptions.
  2. I listan över prenumerationer väljer du knappen Ta bort om det finns en prenumeration som är oönskad eller måste ändras (exempel: skapa brus i kanalen).
  3. Välj knappen Lägg till prenumeration.
  4. Välj den nödvändiga lagringsplatsen och önskad händelse.
  5. Välj lämpliga filter.

Exempel: Få bara meddelanden när mitt team finns i granskningslistan för en PR

En skärmbild som visar recenseraren med mitt team.

Exempel: Berätta när sammanslagningsförsök misslyckas på grund av en principöverträdelse

Skärmbild som visar misslyckat sammanslagningsförsök – på grund av principöverträdelse.

Notera

  • Alla filter är vanligtvis listrutor. Men om listrutan har fler än 100 objekt måste användarna ange värdena manuellt.
  • För tfvc-kod som checkas in i händelsen måste filtret under den sökvägen ha formatet $/myproject/path.

Url:er för förhandsgranskningsbegäran

När en användare klistrar in URL:en för en PR visas en förhandsgranskning som följande bild, vilket hjälper till att hålla PR-relaterade konversationer sammanhangsbaserade och korrekta.

Skärmbild som visar hur URL:en utvecklas.

När användarna har loggat in fungerar den här funktionen för alla kanaler på en arbetsyta.

Ta bort prenumerationer och lagringsplatser från en kanal

Använd följande kommando för att rensa kanalen genom att ta bort lagringsplatser och prenumerationer.

/azrepos unsubscribe all [project url]

Följande kommando tar till exempel bort alla prenumerationer som är relaterade till valfri lagringsplats i projektet och tar bort lagringsplatserna från kanalen. Endast projektadministratörer kan köra det här kommandot.

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

Kommandoreferens

I följande tabell visas alla /azrepos commands du kan använda i Slack-kanalen.

Snedstreckskommando Funktionalitet
/azrepos subscribe [lagringsplats-URL/projekt-URL] Prenumerera på en lagringsplats eller alla lagringsplatser i ett projekt för meddelanden
/azrepos-prenumerationer Lägga till eller ta bort prenumerationer för den här kanalen
/azrepos signin Logga in på din Azure Repos-organisation
/azrepos signout Logga ut från din Azure Repos-organisation
/azrepos feedback Rapportera ett problem eller föreslå en funktion
/azrepos avsluta prenumeration [projekt-URL] Ta bort alla lagringsplatser (som tillhör ett projekt) och deras associerade prenumerationer från en kanal

Meddelanden i privata kanaler

Azure Repos-appen kan också hjälpa dig att övervaka lagringsplatsens händelser i dina privata kanaler. Bjud in roboten till din privata kanal med hjälp av /invite @azrepos. Sedan kan du hantera dina meddelanden på samma sätt som för en offentlig kanal.

Felsöka

Om du får följande fel när du använder Azure Repos App for Slackföljer du procedurerna i det här avsnittet.

Något gick fel. Försök igen.

Azure Repos-appen använder OAuth-autentiseringsprotokollet och kräver programåtkomst från tredje part via OAuth för att organisationen ska aktiveras. Om du vill aktivera den här inställningen går du till Organisationsinställningar>Security>Policiesoch anger programåtkomst från tredje part via OAuth för organisationen inställningen till På.

Aktivera programåtkomst från tredje part via OAuth för organisationsinställningen

Konfigurationen misslyckades. Kontrollera att organisationen {organisationsnamn} finns och att du har tillräcklig behörighet.

Logga ut från Azure DevOps genom att gå till https://aka.ms/VsSignout med webbläsaren.

Öppna ett i privatläge eller inkognitoläge webbläsarfönster och navigera till https://aex.dev.azure.com/me för att logga in. I listrutan under profilikonen till vänster väljer du den katalog som innehåller den organisation som innehåller den lagringsplats som du vill prenumerera på.

Välj den katalog som innehåller den organisation som innehåller projektet

I samma webbläsarestartar du en ny flik, navigerar till https://slack.comoch loggar in på arbetsytan (använder webbklienten). Kör kommandot /azrepos signout följt av kommandot /azrepos signin.

Välj knappen Sign in så omdirigeras du till en medgivandesida som den i följande exempel. Kontrollera att katalogen som visas bredvid e-postmeddelandet är samma som den som valdes i föregående steg. Acceptera och slutför inloggningsprocessen.

Skärmbild som visar Medgivande till de begärda appbehörigheterna.

Om de här stegen inte löser ditt autentiseringsproblem kontaktar du oss på Developer Community.