Delen via

Azure Pipelines gebruiken met Slack

Azure DevOps Services

In dit artikel leest u hoe u de Azure Pipelines-app voor Slack gebruikt om uw pijplijnactiviteiten te bewaken. U kunt abonnementen instellen en beheren voor pijplijnevenementen, zoals builds, releases en in behandeling zijnde goedkeuringen. Meldingen voor deze gebeurtenissen worden rechtstreeks aan uw Slack-kanalen bezorgd.

Notitie

Deze functie is alleen beschikbaar in Azure DevOps Services. Normaal gesproken worden eerst nieuwe functies geïntroduceerd in de cloudservice en vervolgens on-premises beschikbaar gesteld in de volgende primaire versie of update van Azure DevOps Server. Zie de tijdlijn voor Azure DevOps-functies voor meer informatie.

Vereisten

  • Een Slack-account met toestemming om een app te installeren in uw Slack-werkruimte.
  • Een Azure DevOps-project met beheerders van projectverzamelingen of machtigingen voor projectbeheerders .
  • Mag geen externe gebruiker zijn in Microsoft Entra.

De Azure Pipelines-app installeren

Installeer de Slack-app van Azure Pipelines in uw Slack-werkruimte. Zodra de app is geïnstalleerd, ziet u het volgende welkomstbericht. Voer in /azpipelines om te beginnen met interactie met de app.

Schermopname van het welkomstbericht van de Azure Pipelines-app.

Verbinding maken met uw pijplijn

Nadat u de app in uw Slack-werkruimte hebt geïnstalleerd, verbindt u de app met elke pijplijn die u wilt bewaken. Verifieer bij Azure Pipelines voordat u opdrachten uitvoert.

Schermopname van het aanmeldingspromptbericht.

Notitie

Als uw Azure DevOps-organisatie is verbonden met een Microsoft Entra ID-tenant, moet u zich aanmelden met een systeemeigen lid van die tenant. Externe gebruikers krijgen de volgende foutmelding als ze zich proberen aan te melden bij de Azure Pipelines-app: Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.

Abonneren op pijplijnen

Als u alle pijplijnen in een project wilt bewaken, voer /azpipelines subscribe <project url> in een kanaal in, waarbij u <project url> vervangt door de URL van uw Azure DevOps-project. De project-URL kan bijvoorbeeld een koppeling maken naar elke pagina binnen uw project, /azpipelines subscribe https://dev.azure.com/myorg/myproject/met uitzondering van pijplijnpagina's.

U kunt een specifieke pijplijn bewaken met behulp van /azpipelines subscribe <pipeline url>. De pijplijn-URL kan een koppeling maken naar elke pagina in uw pijplijn die een definitionId of een buildId/releaseId in de URL bevat. Voorbeeld:

  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases

Met subscribe de opdracht wordt u standaard geabonneerd op de volgende meldingen:

  • Voor YAML-pijplijnen:
    • Status van uitvoeringsfase gewijzigd
    • Wachtende uitvoeringsfase op goedkeuring
  • Voor klassieke build-pijplijnen is builds voltooid
  • Voor klassieke release-pijplijnen:
    • Release-implementatie gestart
    • Release-implementatie voltooid
    • Goedkeuring van release-implementatie in behandeling

Schermopname van het voorbeeld van een melding.

Abonnementen beheren

Als u de abonnementen voor een kanaal wilt beheren, voert u het volgende in /azpipelines subscriptions. Met deze opdracht worden alle huidige abonnementen voor het kanaal weergegeven en kunt u abonnementen toevoegen of verwijderen.

Schermopname van een lijst met abonnementen.

Notitie

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

Abonnementen aanpassen

Voor de standaardabonnementen zijn geen filters toegepast, maar u kunt deze abonnementen aanpassen op basis van uw voorkeuren. U wilt bijvoorbeeld alleen meldingen ontvangen voor mislukte builds of implementaties naar productie. U kunt filters toepassen om aan te passen welke berichten u in uw kanaal ontvangt.

Een abonnement aanpassen:

  1. Voer de /azpipelines subscriptions opdracht uit om al uw abonnementen weer te geven.
  2. Selecteer Abonnement toevoegen.
  3. Selecteer de gebeurtenis waarop u zich wilt abonneren en selecteer vervolgens de gewenste configuratie.
  4. Selecteer Opslaan.

Als u alleen meldingen wilt ontvangen voor mislukte builds, selecteert u Mislukt onder buildstatus.

Schermopname van het aanpassen van een abonnement.

Implementaties goedkeuren

U kunt implementaties vanuit uw Slack-kanaal goedkeuren zonder naar Azure Pipelines te gaan. Abonneer u op de meldingen uitvoeringsfase wacht op goedkeuring voor YAML-pijplijnen of op de meldingen release-implementatie wacht op goedkeuring voor klassieke releases. Beide abonnementen worden standaard gemaakt wanneer u zich abonneert op een pijplijn.

Schermopname van goedkeuring van pijplijn in Slack.

Met de Azure Pipelines-app voor Slack kunt u alle controles en goedkeuringsscenario's afhandelen die beschikbaar zijn in de Azure Pipelines-portal. Deze scenario's omvatten één goedkeurder, meerdere goedkeurders en goedkeuring op basis van een team. U kunt aanvragen afzonderlijk of namens een team goedkeuren.

Schermopname van een vooraf geïmplementeerde pijplijn die is goedgekeurd in Slack.

Alle abonnementen verwijderen

Als u uw kanaal wilt opruimen, gebruikt u de /azpipelines unsubscribe all <project url> opdracht om u uit te schrijven voor alle pijplijnen in een project. Bijvoorbeeld: /azpipelines unsubscribe all https://dev.azure.com/myorg/myproject.

Belangrijk

Alleen projectbeheerders kunnen deze opdracht uitvoeren.

Naslaginformatie over opdrachten

De Azure Pipelines-app voor Slack ondersteunt de volgende opdrachten:

Opdracht Beschrijving
/azpipelines subscribe <pipeline url or project url> Abonneer u op een pijplijn of alle pijplijnen in een project en ontvang meldingen.
/azpipelines subscriptions Abonnementen voor dit kanaal toevoegen of verwijderen.
/azpipelines feedback Meld een probleem of stel een functie voor.
/azpipelines help Hulp krijgen bij de opdrachten.
/azpipelines signin Meld u aan bij uw Azure Pipelines-account.
/azpipelines signout Meld u af bij uw Azure Pipelines-account.
/azpipelines unsubscribe all <project url> Verwijder alle projectpijplijnen en de bijbehorende abonnementen uit een kanaal.

Meldingen in privékanalen

De Azure Pipelines-app kan u ook helpen bij het bewaken van de activiteit van pijplijnen in uw privékanalen. U moet de bot uitnodigen voor uw privékanaal met behulp van /invite @azpipelines. Zodra u de bot hebt toegevoegd, kunt u uw meldingen op dezelfde manier configureren en beheren als voor een openbaar kanaal.

Probleemoplossing

Als u de volgende fouten krijgt bij het gebruik van de Azure Pipelines-app voor Slack, voert u de volgende procedure uit.

Configuratie mislukt. Zorg ervoor dat de organisatie bestaat en of u over voldoende machtigingen beschikt.

Als u deze fout ziet, bent u waarschijnlijk een gastgebruiker in de Microsoft Entra-tenant die is verbonden met uw Azure DevOps-organisatie. U moet een Microsoft Entra-lid hebben om de configuratiestappen te doorlopen.

  • Last updated on