Azure Pipelines gebruiken met Microsoft Teams

  • Artikel

Azure DevOps Services

Met de Azure Pipelines-app voor Microsoft Teams kunt u gebeurtenissen voor uw pijplijnen bewaken. U kunt meldingen instellen en ontvangen in uw Teams-kanaal voor releases, goedkeuringen in behandeling, voltooide builds, enzovoort. U kunt releases ook goedkeuren vanuit uw Teams-kanaal.

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

  • U moet een Azure DevOps-project hebben. Zie Een project maken voor meer informatie.
  • Als u pijplijnabonnementen wilt instellen, moet u een Project-Beheer istrator zijn.

De Azure Pipelines-app instellen

  1. Ga in Microsoft Teams naar de Apps Store, zoek naar Azure Pipelines en selecteer vervolgens Azure Pipelines.

    Schermopname van het selecteren van de knop Apps en vervolgens de knop Azure Pipelines.

  2. Selecteer de vervolgkeuzepijl Openen en selecteer vervolgens Toevoegen aan een team.

    Schermopname van het selecteren van de knop Openen en vervolgens toevoegen aan een teamknop.

  3. Selecteer of voer uw teamnaam in en kies vervolgens Een bot instellen.

    Selecteer de knop Een bot instellen.

  4. Voer in het gespreksvenster van Teams het volgende in @azurePipelines signin.

  5. Selecteer Aanmelden en voltooi de verificatie voor Azure Pipelines.

Opdrachten gebruiken

Gebruik de volgende opdrachten om alle pijplijnen in een project of alleen specifieke pijplijnen te bewaken.

  • Alle pijplijnen in een project bewaken. De URL kan naar elke pagina binnen uw project zijn, met uitzondering van URL's naar pijplijnen. Bijvoorbeeld: @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]

  • Een specifieke pijplijn bewaken: de pijplijn-URL kan naar elke pagina in uw pijplijn zijn die een definitionId of buildId/releaseId aanwezig is in de URL. Bijvoorbeeld: @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]

    Een ander voorbeeld van een release-pijplijn die is geabonneerd op de release-implementatie is gestart, de release-implementatie is voltooid en goedkeuringsmeldingen voor release-implementatie in behandeling zijn @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Notitie

  • We bieden geen ondersteuning voor implementatiegoedkeuringen die de identiteit van fiatteur opnieuw hebben toegepast voordat het goedkeuringsbeleid wordt voltooid.
  • Schakel 'Toegang van toepassingen van derden via OAuth' in om meldingen te ontvangen voor de organisatie in Azure DevOps.

Abonnementen beheren

Wanneer u zich abonneert op een pijplijn, worden er standaard enkele abonnementen gemaakt zonder dat er filters zijn toegepast. Mogelijk wilt u deze abonnementen aanpassen. U wilt bijvoorbeeld alleen een melding ontvangen wanneer builds mislukken of wanneer implementaties naar een productieomgeving worden gepusht. De Azure Pipelines-app ondersteunt filters om aan te passen wat u in uw kanaal ziet. Voer de volgende stappen uit om uw abonnementen te beheren.

  1. Voer de opdracht @azure pipelines subscriptions uit.

  2. Selecteer Alle abonnementen weergeven. Als er een abonnement is dat u niet wilt, selecteert u Verwijderen in de lijst met abonnementen. Weergave van lijst met abonnementen.

  3. Schuif omlaag en selecteer Abonnement toevoegen.

  4. Selecteer de vereiste pijplijn en gebeurtenis.

  5. Selecteer de juiste filters en vervolgens Opslaan.

    Voorbeeld 1: Meldingen ontvangen voor mislukte builds.

    Visual van buildfouten in Teams.

    Voorbeeld 2: Ontvang alleen meldingen als de implementaties naar de productieomgeving worden gepusht.

    Visual van foutmelding.

    Notitie

    • Team Beheer istrators kunnen geen abonnementen verwijderen of wijzigen die zijn gemaakt door Project Beheer istrators.
    • Meldingen worden niet ondersteund in chat-/directe berichten.

Implementaties vanuit uw kanaal goedkeuren

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

In Teams ziet u dat u klaar bent voor goedkeuring.

Wanneer het uitvoeren van een fase in behandeling is voor goedkeuring, wordt een meldingskaart met opties voor het goedkeuren of afwijzen van de aanvraag in het kanaal geplaatst. Goedkeurders kunnen de details van de aanvraag in de melding bekijken en de juiste actie ondernemen. In het volgende voorbeeld is de implementatie goedgekeurd en wordt de goedkeuringsstatus weergegeven op de kaart.

Kaart met goedgekeurde implementatie.

De Azure Pipelines-app ondersteunt alle controles en goedkeuringsscenario's die aanwezig zijn in de Azure Pipelines-portal. U kunt aanvragen goedkeuren als persoon of voor een team.

Pijplijngegevens zoeken en delen met behulp van de compose-extensie

Om gebruikers te helpen bij het zoeken en delen van informatie over pijplijnen, biedt de Azure Pipelines-app voor Microsoft Teams ondersteuning voor het opstellen van extensies. U kunt nu zoeken naar pijplijnen op pijplijn-id of op naam van de pijplijn. Gebruikers moeten zich aanmelden bij het Azure Pipelines-project waarin ze geïnteresseerd zijn door een opdracht uit te voeren @azure pipelines signin of door zich rechtstreeks aan te melden bij de compose-extensie.

Extensie opstellen.

Voorbeelden van pijplijn-URL's

Wanneer u een pijplijn-URL aan Teams toevoegt, ziet u een voorbeeld dat vergelijkbaar is met de volgende afbeeldingen. De preview helpt om pijplijngerelateerde gesprekken relevant en up-to-date te houden. U kunt kiezen tussen compacte en uitgevouwen kaarten.

Voorbeeld 1: Preview van build-URL

Bouw-URL opheffen.

Voorbeeld 2: Preview van release-URL

Release-URL opheffen.

Zodra u bent aangemeld, werkt deze functie voor alle kanalen in een team in Microsoft Teams.

Afmelden voor een pijplijnkanaal

Gebruik de volgende opdracht om u af te melden voor alle pijplijnen binnen een project.

@azure pipelines unsubscribe all [project url]

Voorbeeld: Alles afmelden met URL

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Met deze opdracht worden alle abonnementen verwijderd die betrekking hebben op een pijplijn in het project en worden de pijplijnen uit het kanaal verwijderd.

Belangrijk

Alleen Project Beheer istrators kunnen deze opdracht uitvoeren.

Alle meldingen die zijn gekoppeld aan een bepaalde uitvoering van een pijplijn, worden gekoppeld.

Voorbeeld 1: Compacte weergave van gekoppelde meldingen.

Compacte thread

Voorbeeld 2: Uitgebreide weergave van gekoppelde meldingen.

Uitgevouwen thread

Opdrachten gebruiken in de Azure Pipelines-app

Bekijk de volgende opdrachten die worden ondersteund door de Azure Pipelines-app:

Slash-opdracht Functionaliteit
@azure pijplijnen abonneren op [pijplijn-URL/ project-URL] Abonneren op een pijplijn of alle pijplijnen in een project om meldingen te ontvangen
@azure pijplijnenabonnementen Abonnementen voor dit kanaal toevoegen of verwijderen
@azure Feedback over pijplijnen Een probleem melden of een functie voorstellen
@azure Hulp bij pijplijnen Hulp krijgen bij de slash-opdrachten
@azure Aanmelding voor pijplijnen Aanmelden bij uw Azure Pipelines-account
@azure Afmelding voor pijplijnen Afmelden bij uw Azure Pipelines-account
@azure pijplijnen afmelden voor alle [project-URL] Verwijder alle pijplijnen (behorend bij een project) en de bijbehorende abonnementen uit een kanaal

Verbinding maken multitenants

Als u een andere e-mail of tenant gebruikt voor Microsoft Teams en Azure DevOps, voert u de volgende stappen uit om u aan te melden en verbinding te maken op basis van uw use-case.

Gebruiksscenario E-mail-id en tenant in Microsoft Teams E-mail-id en tenant in Azure DevOps Aanmeldingsactie
1 email1@abc.com (tenant 1) email1@abc.com (tenant 1) Selecteer Aanmelden
2 email1@abc.com (tenant 1) email2@pqr.com (tenant 2) - Meld u aan bij Azure DevOps.
- Start in dezelfde browser een nieuw tabblad en ga naar https://teams.microsoft.com/.
- Voer de sign in opdracht uit en selecteer Aanmelden.
3 email1@abc.com (tenant 1) email2@pqr.com (tenant 2) - Selecteer Aanmelden met een ander e-mailadres.
- Gebruik in de e-mail-idkiezer de e-mail2 om u aan te melden.
4 email1@abc.com (tenant 1) email2@pqr.com (niet-standaardtenant 3) Momenteel niet ondersteund.

Problemen oplossen

Start in dezelfde browser een nieuw tabblad en meld u aan bij https://teams.microsoft.com/. Voer de @Azure Pipelines signout opdracht uit en voer vervolgens de @Azure Pipelines signin opdracht uit in het kanaal waar de Azure Pipelines-app voor Microsoft Teams is geïnstalleerd.

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 u in de vorige stap hebt gekozen. Accepteer en voltooi het aanmeldingsproces.

Toestemming geven voor de aangevraagde app-machtigingen

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