Azure Pipelines gebruiken met Slack
Azure DevOps Services
Met de Azure Pipelines-app voor Slack kunnen Slack-gebruikers eenvoudig de gebeurtenissen bijhouden die zich in hun pijplijnen voordoen. Met de app kunnen gebruikers abonnementen voor verschillende pijplijnevenementen opzetten en controleren, zoals builds, releases, goedkeuringen in behandeling en meer. Meldingen voor deze gebeurtenissen worden vervolgens rechtstreeks bezorgd bij de Slack-kanalen van gebruikers
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
- In Slack moet u gemachtigd zijn om een app te installeren in uw Slack-werkruimte.
- Voor Azure DevOps moet u zich in de groep Projectverzameling Beheer istrators of Project Beheer istrators bevinden om een Slack-abonnement in te stellen.
Azure Pipelines-app installeren
Navigeer naar de Slack-app van Azure Pipelines om de Azure Pipelines-app te installeren in uw Slack-werkruimte. Zodra dit is toegevoegd, ziet u een welkomstbericht van de app, zoals hieronder. Gebruik de /azpipelines ingang om te beginnen met de interactie met de app.
Verbinding maken naar uw pijplijn
Zodra de app is geïnstalleerd in uw Slack-werkruimte, kunt u de app verbinden met elke pijplijn die u wilt bewaken. U wordt gevraagd om u te verifiëren bij Azure Pipelines voordat u opdrachten uitvoert.
Gebruik de volgende slash-opdracht in een kanaal om alle pijplijnen in een project te bewaken:
/azpipelines subscribe [project url]
De project-URL kan een koppeling maken naar elke pagina binnen uw project (met uitzondering van URL's naar pijplijnen). Bijvoorbeeld: /azpipelines subscribe https://dev.azure.com/myorg/myproject/
U kunt ook een specifieke pijplijn bewaken met behulp van de volgende opdracht:
/azpipelines subscribe [pipeline url]
De pijplijn-URL kan een koppeling maken naar elke pagina in uw pijplijn met een definitionId of meer buildId/releaseId in de URL. Bijvoorbeeld: /azpipelines subscribehttps://dev.azure.com/myorg/myproject/_build?definitionId=123 , or: /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123& view=mine&_a=releases
Met de opdracht Abonneren kunt u standaard aan de slag met een paar abonnementen. Dit zijn de standaardmeldingen ingeschakeld voor het volgende pijplijntype:
| Pijplijnen bouwen | Release-pijplijnen | YAML-pijplijnen |
|---|---|---|
| Melding over voltooid bouwen | Release-implementatie gestart, release-implementatie voltooid en goedkeuring van release-implementatie in behandeling meldingen | Status van de uitvoeringsfase is gewijzigd en de uitvoeringsfase wacht op goedkeuringsmeldingen |
Abonnementen beheren
Gebruik de volgende opdracht om de abonnementen voor een kanaal te beheren: /azpipelines subscriptions
Met deze opdracht worden alle huidige abonnementen voor het kanaal weergegeven en kunt u abonnementen toevoegen of verwijderen.
Notitie
Teambeheerders kunnen geen abonnementen verwijderen of wijzigen die zijn gemaakt door Projectbeheerders.
Abonnementen aanpassen
Wanneer u zich abonneert op een pijplijn, worden standaard verschillende abonnementen gegenereerd waarop geen filters zijn toegepast. Het is echter gebruikelijk dat gebruikers deze abonnementen willen personaliseren op basis van hun voorkeuren. Gebruikers willen bijvoorbeeld alleen meldingen ontvangen voor mislukte builds of wanneer implementaties in productie worden genomen. De Azure Pipelines-app biedt de mogelijkheid om filters toe te passen, zodat gebruikers de berichten kunnen aanpassen die ze in hun kanaal ontvangen. Een abonnement aanpassen:
Voer de
/azpipelines subscriptionsopdracht uit om al uw abonnementen weer te geven.Selecteer Abonnement toevoegen.
Selecteer de gebeurtenis waarop u zich wilt abonneren en selecteer vervolgens de gewenste configuratie.
Kies Opslaan wanneer u klaar bent.
Voorbeeld: Meldingen alleen ontvangen voor mislukte builds
Implementaties goedkeuren
U kunt implementaties vanuit uw Slack-kanaal goedkeuren zonder naar de Azure Pipelines-portal te navigeren door u te abonneren op meldingen voor goedkeuring van release-implementatie in behandeling (klassieke releases) of de uitvoeringsfase die wacht op goedkeuringsmeldingen (YAML-pijplijnen). Beide abonnementen worden standaard gemaakt wanneer u zich abonneert op een pijplijn.
Met de Azure Pipelines-app voor Slack kunt u alle controles en goedkeuringsscenario's afhandelen die beschikbaar zijn in de Azure Pipelines-portal. Deze omvatten één fiatteur, meerdere goedkeurders en goedkeuring op basis van een team. U kunt aanvragen afzonderlijk of namens een team goedkeuren.
Alle abonnementen verwijderen
Als u uw kanaal wilt verwijderen, kunt u gebruikmaken van de volgende opdrachten om u af te melden voor alle pijplijnen binnen een project. Bijvoorbeeld: /azpipelines afmelden voor alle https://dev.azure.com/myorg/myproject.
/azpipelines unsubscribe all [project url]
Belangrijk
Deze opdracht kan alleen worden uitgevoerd door projectbeheerders.
Naslaginformatie over opdrachten
Hier volgen alle opdrachten die worden ondersteund door de Azure Pipelines-app voor Slack:
| Slash-opdracht | Functionaliteit |
|---|---|
| /azpipelines subscribe [pipeline url/ project URL] | Abonneren op een pijplijn of alle pijplijnen in een project om meldingen te ontvangen |
| /azpipelines-abonnementen | Abonnementen voor dit kanaal toevoegen of verwijderen |
| /azpipelines feedback | Een probleem melden of een functie voorstellen |
| /azpipelines help | Hulp krijgen bij de slash-opdrachten |
| /azpipelines signin | Aanmelden bij uw Azure Pipelines-account |
| /azpipelines signout | Afmelden bij uw Azure Pipelines-account |
| /azpipelines afmelden alle [project-URL] | Verwijder alle pijplijnen (behorend bij een project) en de bijbehorende abonnementen uit een kanaal |
Meldingen in privékanalen
Met de Azure Pipelines-app kunt u ook de activiteiten van pijplijnen in uw privékanalen bewaken. U moet de bot uitnodigen voor uw privékanaal met behulp van /invite @azpipelines. Zodra de bot is toegevoegd, kunt u uw meldingen op dezelfde manier configureren en beheren als voor een openbaar kanaal.
Notitie
- U kunt de Azure Pipelines-app alleen gebruiken voor Slack met een project dat op dit moment wordt gehost in Azure DevOps Services.
- De gebruiker moet een beheerder zijn van het project met de pijplijn om de abonnementen in te stellen
- Meldingen worden momenteel niet ondersteund in directe berichten
- Implementatiegoedkeuringen waarvoor de identiteit van fiatteur opnieuw wordt gevalideerd voordat het goedkeuringsbeleid is voltooid, worden niet ondersteund
- 'Toegang tot toepassingen van derden via OAuth' moet zijn ingeschakeld voor het ontvangen van meldingen voor de organisatie in Azure DevOps (Organisatie Instellingen -> Beveiliging -> Beleid)
Problemen oplossen
Als u de volgende fouten ondervindt bij het gebruik van de Azure Pipelines-app voor Slack, volgt u de procedures in deze sectie.
Er is iets fout gegaan. Probeer het opnieuw
De Azure Pipelines-app maakt gebruik van het OAuth-verificatieprotocol en vereist dat externe toepassingstoegang via OAuth is ingeschakeld. Als u deze instelling wilt inschakelen, gaat u naar Organisatie Instellingen> Beveiligingsbeleid> en schakelt u de toegang van toepassingen van derden in via OAuth voor de organisatie.
Configuratie is mislukt. Zorg ervoor dat de organisatie bestaat en of u over voldoende machtigingen beschikt
Meld u af bij Azure DevOps door naar deze URL te navigeren: https://aka.ms/VsSignout.
Open een privé-/incognitobrowservenster en navigeer naar https://aex.dev.azure.com/me en meld u aan. Selecteer de map die de organisatie bevat waar de pijplijn zich bevindt waarop u zich wilt abonneren.
Open in dezelfde browser een nieuw tabblad en ga naar https://slack.com. Meld u aan bij uw werkruimte met behulp van de webclient en voer vervolgens de /azpipelines signout opdracht uit gevolgd door de /azpipelines signin.
Selecteer de Sign in knop en u wordt omgeleid naar een toestemmingspagina, zoals wordt weergegeven in het onderstaande voorbeeld. Controleer of de map die naast uw e-mailadres wordt weergegeven, overeenkomt met de map die in de vorige stap is geselecteerd. Selecteer Accepteren om het aanmeldingsproces te voltooien.
Verwante artikelen:
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor