Azure-opslagplaatsen met Slack

  • Artikel

Azure DevOps Services

Als u Slack gebruikt, kunt u de app Azure-opslagplaatsen voor Slack gebruiken om eenvoudig uw Opslagplaatsen voor Azure-opslagplaatsen te bewaken. Abonnementen instellen en beheren om meldingen in uw kanaal te ontvangen wanneer code wordt gepusht of ingecheckt en wanneer een pull-aanvraag (PR) wordt gemaakt, bijgewerkt of samengevoegd. Deze app ondersteunt zowel Git- als TFVC-gebeurtenissen (Team Foundation Version Control).

Vereisten

  • Als u abonnementen wilt maken in een Slack-kanaal voor gebeurtenissen die betrekking hebben op de opslagplaats, moet u lid zijn van de groep Project Beheer istrators of een teambeheerder zijn. Zie Machtigingen op projectniveau wijzigen of Een teambeheerder toevoegen om toe te voegen.
  • Als u meldingen wilt ontvangen, moet de toepassingstoegang van derden via de OAuth-instelling zijn ingeschakeld voor de organisatie. Zie Toegangsbeleid voor toepassingen voor uw organisatie wijzigen voor meer informatie.

Notitie

  • U kunt de App Azure-opslagplaatsen voor Slack op dit moment alleen koppelen aan een project dat wordt gehost in Azure DevOps Services.
  • Meldingen worden momenteel niet ondersteund in directe berichten.

De Azure-opslagplaats-app toevoegen aan uw Slack-werkruimte

  1. Ga naar de Slack-app azure-opslagplaatsen en selecteer Toevoegen aan Slack.

    Schermopname van slack-app-map, Azure-opslagplaatsen en -knop, Toevoegen aan Slack.

    Zodra dit is toegevoegd, ontvangt u ongeveer het volgende welkomstbericht.

    Schermopname van welkomstbericht van Slack.

  2. Gebruik de /azrepos Slack-ingang om met de app te communiceren. In de sectie Opdrachtreferentie van dit artikel vindt u een volledige lijst met opdrachten.

Verbinding maken de Azure-opslagplaats-app naar uw opslagplaatsen

  1. Verbinding maken en verifieer uzelf bij Azure-opslagplaatsen met behulp van /azrepos signin de opdracht.

    Schermopname van de aanmeldingsprompt voor Slack.

  2. Selecteer Aanmelden.

  3. Accepteer de Slack-integratie van Azure-opslagplaatsen.

    Schermopname van de knop Accepteren in het aanmeldingsscherm.

    Er wordt een verificatiecode weergegeven voor gebruik in uw chat-app om de verificatie te voltooien.

  4. Kopieer de verificatiecode.

    Schermopname van verificatiecode die wordt geleverd door Azure-opslagplaatsen.

  5. Selecteer Code invoeren, plak de code en selecteer Vervolgens Verzenden.

    Schermopname van het laatste verificatiescherm wanneer verificatiecode wordt geplakt en de knop Verzenden is geselecteerd.

    Bevestiging van aanmelding wordt weergegeven in de chat.

    Schermafbeelding van de aanmeldingsbevestiging in de chat.

Gebruik de volgende slash-opdracht in een kanaal om alle Git-opslagplaatsen in een project te controleren:

/azrepos subscribe [project url]

De project-URL kan naar elke pagina binnen uw project zijn (behalve URL's naar opslagplaatsen). Voorbeeld:

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

U kunt ook een specifieke opslagplaats bewaken met behulp van de volgende opdracht:

/azrepos subscribe [repository url]

De URL van de opslagplaats kan zijn op elke pagina in uw opslagplaats met de naam van de opslagplaats. Gebruik bijvoorbeeld voor Git-opslagplaatsen:

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

Voor TFVC-opslagplaatsen gebruikt u:

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

Notitie

U kunt zich alleen abonneren op openbare opslagplaatsen.

Met de opdracht Abonneren kunt u aan de slag met een standaardabonnement. Voor Git-opslagplaatsen wordt het kanaal geabonneerd op de gebeurtenis voor het maken van een pull-aanvraag (met doelbranch = main) en voor TFVC-opslagplaatsen wordt het kanaal geabonneerd op de code die is ingecheckt.

Schermopname van het bericht Voor het maken van standaardabonnementen.

Abonnementen beheren

Gebruik de volgende subscriptions opdracht om abonnementen voor een kanaal weer te geven, toe te voegen of te verwijderen:

/azrepos subscriptions

Met deze opdracht worden alle huidige abonnementen voor het kanaal weergegeven en kunt u nieuwe abonnementen toevoegen of bestaande abonnementen verwijderen. Wanneer u abonnementen toevoegt, kunt u de meldingen die u ontvangt aanpassen met behulp van verschillende filters, zoals beschreven in de volgende sectie.

Notitie

Teambeheerders kunnen geen abonnementen verwijderen of wijzigen die zijn gemaakt door Projectbeheerders.

Schermopname van de lijst met abonnementen.

Filters gebruiken om abonnementen aan te passen

Wanneer een gebruiker zich abonneert op een opslagplaats met behulp van de /azrepos subscribe opdracht, wordt er een standaardabonnement gemaakt. Vaak moeten gebruikers deze abonnementen aanpassen. Gebruikers willen bijvoorbeeld alleen een melding ontvangen wanneer pull-aanvragen een specifieke revisor hebben.

In de volgende stappen ziet u hoe u abonnementen aanpast.

  1. Voer de opdracht /azrepos subscriptions uit.
  2. Als er in de lijst met abonnementen een abonnement is dat ongewenst is of moet worden gewijzigd (bijvoorbeeld: ruis maken in het kanaal), selecteert u de knop Verwijderen .
  3. Selecteer de knop Abonnement toevoegen.
  4. Selecteer de vereiste opslagplaats en de gewenste gebeurtenis.
  5. Selecteer de juiste filters.

Voorbeeld: Ontvang alleen meldingen wanneer mijn team in de lijst met revisoren voor een pull-aanvraag staat

Schermopname van Revisor heeft mijn team.

Voorbeeld: Laat me weten wanneer samenvoegpogingen mislukken vanwege een beleidsschending

Schermopname van een mislukte samenvoegingspoging, vanwege een schending van het beleid.

Notitie

  • Alle filters zijn meestal vervolgkeuzelijsten. Maar als de vervolgkeuzelijst groter is dan 100 items, moeten gebruikers de waarden handmatig invoeren.
  • Voor de TFVC-code ingecheckt, moet het filter Onder pad de indeling $/myproject/pathhebben.

URL's voor pull-aanvragen bekijken

Wanneer een gebruiker de URL van een pull-aanvraag plakt, wordt een voorbeeld weergegeven zoals in de volgende afbeelding, waarmee pr-gerelateerde gesprekken contextueel en nauwkeurig kunnen worden bewaard.

Schermopname van het uitsplitsen van URL's.

Zodra gebruikers zich hebben aangemeld, werkt deze functie voor alle kanalen in een werkruimte.

Abonnementen en opslagplaatsen verwijderen uit een kanaal

Gebruik de volgende opdracht om uw kanaal op te schonen door opslagplaatsen en abonnementen te verwijderen.

/azrepos unsubscribe all [project url]

Met de volgende opdracht worden bijvoorbeeld alle abonnementen verwijderd die betrekking hebben op een opslagplaats in het project en worden de opslagplaatsen uit het kanaal verwijderd. Alleen projectbeheerders kunnen deze opdracht uitvoeren.

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

Naslaginformatie over opdrachten

De volgende tabel bevat alle items die /azrepos commands u in uw Slack-kanaal kunt gebruiken.

Slash-opdracht Functionaliteit
/azrepos subscribe [repository URL/ project URL] Abonneren op een opslagplaats of alle opslagplaatsen in een project voor meldingen
/azrepos subscriptions Abonnementen voor dit kanaal toevoegen of verwijderen
/azrepos signin Aanmelden bij uw Azure-opslagplaatsorganisatie
/azrepos signout Afmelden bij uw Azure-opslagplaatsenorganisatie
/azrepos feedback Een probleem melden of een functie voorstellen
/azrepos afmelden alle [project-URL] Verwijder alle opslagplaatsen (behorend bij een project) en de bijbehorende abonnementen uit een kanaal

Meldingen in privékanalen

Met de Azure-opslagplaats-app kunt u ook de gebeurtenissen in de opslagplaats in uw privékanalen bewaken. Nodig de bot uit voor uw privékanaal met behulp van /invite @azrepos. Vervolgens kunt u uw meldingen op dezelfde manier beheren als voor een openbaar kanaal.

Problemen oplossen

Als u de volgende fouten ondervindt bij het gebruik van de Azure-opslagplaats-app voor Slack, volgt u de procedures in deze sectie.

Er is iets fout gegaan. Probeer het opnieuw.

De Azure-opslagplaats-app maakt gebruik van het OAuth-verificatieprotocol en vereist dat toepassingstoegang van derden via OAuth wordt ingeschakeld voor de organisatie . Als u deze instelling wilt inschakelen, gaat u naar Organisatie Instellingen> Beveiligingsbeleid> en stelt u de toegang van de toepassing van derden in via OAuth voor de organisatieinstelling op Aan.

Toegang tot toepassingen van derden inschakelen via OAuth voor de organisatie-instelling

Configuratie is mislukt. Zorg ervoor dat de organisatie {organization name} bestaat en of u over voldoende machtigingen beschikt.

Meld u af bij Azure DevOps door te navigeren naar https://aka.ms/VsSignout uw browser.

Open een privé- of incognitobrowservenster en navigeer naar en meld u aanhttps://aex.dev.azure.com/me. Selecteer in de vervolgkeuzelijst onder het profielpictogram aan de linkerkant de map met de organisatie met de opslagplaats waarop u zich wilt abonneren.

Selecteer de map met de organisatie die het project bevat

Start in dezelfde browser een nieuw tabblad, navigeer naar en meld u aan https://slack.combij uw werkruimte (gebruik de webclient). Voer de /azrepos signout opdracht uit gevolgd door de /azrepos signin opdracht.

Selecteer de Sign in knop en u wordt omgeleid naar een toestemmingspagina, zoals in het volgende voorbeeld. Zorg ervoor dat de map die naast het e-mailbericht wordt weergegeven, hetzelfde is als de map die in de vorige stap is gekozen. Accepteer en voltooi het aanmeldingsproces.

Schermopname van Toestemming voor de aangevraagde app-machtigingen.

Als deze stappen uw verificatieprobleem niet oplossen, neemt u contact met ons op bij de Developer Community.