Použití Azure Pipelines s Microsoft Teams

Služby Azure DevOps

Aplikace Azure Pipelines pro Microsoft Teams umožňuje monitorovat události pro vaše kanály. V kanálu Teams můžete nastavit a dostávat oznámení o vydaných verzích, čekajících schváleních, dokončených buildech atd. Vydané verze můžete také schválit v rámci kanálu Teams.

Poznámka:

Tato funkce je dostupná jenom v Azure DevOps Services. Nové funkce se obvykle zavádějí nejprve v cloudové službě a pak jsou k dispozici místně v příští hlavní verzi nebo aktualizaci Azure DevOps Serveru. Další informace najdete v tématu Časová osa funkcí Azure DevOps.

Požadavky

  • Musíte mít projekt Azure DevOps. Další informace najdete v části Vytvoření projektu.
  • Pokud chcete nastavit předplatná kanálu, musíte být project Správa istrator.

Nastavení aplikace Azure Pipelines

  1. V Microsoft Teams přejděte do Obchodu s aplikacemi , vyhledejte Azure Pipelines a pak vyberte Azure Pipelines.

    Snímek obrazovky s výběrem tlačítka Aplikace a tlačítkem Azure Pipelines

  2. Vyberte šipku rozevíracího seznamu Otevřít a pak vyberte Přidat do týmu.

    Snímek obrazovky s výběrem tlačítka Otevřít a následným tlačítkem Přidat do týmu

  3. Vyberte nebo zadejte název týmu a pak zvolte Nastavit robota.

    Výběr tlačítka Nastavit robota

  4. V podokně konverzace Teams zadejte @azurePipelines signin.

  5. Vyberte Přihlásit se a dokončit ověřování do Azure Pipelines.

Použití příkazů

Pomocí následujících příkazů můžete monitorovat všechny kanály v projektu nebo jenom konkrétní kanály.

  • Monitorujte všechny kanály v projektu. Adresa URL může být na libovolnou stránku v projektu s výjimkou adres URL na kanály. Například @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]
    
  • Monitorujte konkrétní kanál: Adresa URL kanálu může být na libovolnou stránku ve vašem kanálu, která obsahuje definitionId adresu URL nebo buildId/releaseId ji obsahuje. Například @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]
    

    Dalším příkladem kanálu verze, který je přihlášený k odběru nasazení vydané verze, zahájeného nasazení, dokončeného nasazení vydané verze a oznámení čekajících na schválení nasazení vydané verze je @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Poznámka:

  • Nepodporujeme schválení nasazení, která před dokončením zásad schválení použila identitu schvalovatele znovu.
  • Povolte přístup k aplikacím třetích stran prostřednictvím OAuth, abyste mohli dostávat oznámení pro organizaci v Azure DevOps.

Správa předplatných

Když se přihlásíte k odběru kanálu, vytvoří se ve výchozím nastavení několik předplatných bez použití filtrů. Tato předplatná můžete chtít přizpůsobit. Můžete například chtít dostávat oznámení jenom v případě, že sestavení selžou nebo když se nasazení nasdílí do produkčního prostředí. Aplikace Azure Pipelines podporuje filtry pro přizpůsobení toho, co vidíte ve vašem kanálu. Pokud chcete spravovat předplatná, proveďte následující kroky.

  1. Spusťte příkaz @azure pipelines subscriptions.

  2. Vyberte Zobrazit všechna předplatná. Pokud v seznamu předplatných nemáte nějaké předplatné, vyberte Odebrat. Zobrazení seznamu předplatných

  3. Posuňte se dolů a vyberte Přidat předplatné.

  4. Vyberte požadovaný kanál a událost.

  5. Vyberte příslušné filtry a pak uložte.

    Příklad 1: Získání oznámení o neúspěšných buildech

    Vizuál selhání sestavení v Teams

    Příklad 2: Oznámení získáte pouze v případě, že se nasazení do produkčního prostředí odešle.

    Vizuál oznámení o selhání

    Poznámka:

    • Týmové Správa istrátory nemůžou odebírat ani upravovat předplatná vytvořená Správa istrátory Projectu.
    • Oznámení nejsou podporována v chatu nebo přímých zprávách.

Schválení nasazení z kanálu

Nasazení můžete schválit z kanálu, aniž byste museli přejít na portál Azure Pipelines. Přihlaste se k odběru oznámení o schválení nasazení vydané verze čekající na nasazení pro klasické verze nebo fázi spuštění čekající na oznámení o schválení kanálů YAML. Obě tato předplatná se ve výchozím nastavení vytvoří při přihlášení k odběru kanálu.

V Teams si všimněte, že je připravený ke schválení.

Kdykoli je spuštění fáze čekající na schválení, zobrazí se v kanálu karta s oznámením s možnostmi schválení nebo odmítnutí žádosti. Schvalovatelé můžou zkontrolovat podrobnosti žádosti v oznámení a provést odpovídající akci. V následujícím příkladu bylo nasazení schváleno a na kartě se zobrazuje stav schválení.

Karta zobrazující schválené nasazení

Aplikace Azure Pipelines podporuje všechny scénáře kontroly a schválení na portálu Azure Pipelines. Žádosti můžete schválit jako jednotlivec nebo pro tým.

Hledání a sdílení informací o kanálu pomocí rozšíření pro psaní zpráv

Aby uživatelé mohli vyhledávat a sdílet informace o kanálech, aplikace Azure Pipelines pro Microsoft Teams podporuje rozšíření pro vytváření zpráv. Kanály teď můžete hledat podle ID kanálu nebo podle názvu kanálu. Aby rozšíření pro psaní fungovalo, musí se uživatelé přihlásit k projektu Azure Pipelines, který zajímá, buď spuštěním @azure pipelines signin příkazu, nebo přímým přihlášením k rozšíření pro psaní zpráv.

Vytvoření rozšíření

Náhledy adres URL kanálů

Když do Teams přidáte adresu URL kanálu, zobrazí se náhled podobný následujícím obrázkům. Verze Preview pomáhá udržovat konverzace související s kanály relevantní a aktuální. Můžete si vybrat mezi kompaktními a rozbalenými kartami.

Příklad 1: Build URL Preview

Vytvoření unfurling adresy URL

Příklad 2: Verze URL verze Preview

Unfurling adresy URL vydané verze

Po přihlášení tato funkce funguje pro všechny kanály v týmu v Microsoft Teams.

Odhlášení odběru kanálu

K odhlášení odběru všech kanálů v rámci projektu použijte následující příkaz.

@azure pipelines unsubscribe all [project url]

Příklad: Odhlášení odběru všech s adresou URL

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

Tento příkaz odstraní všechna předplatná související s jakýmkoli kanálem v projektu a odebere kanály z kanálu.

Důležité

Tento příkaz může spustit pouze projekt Správa istrátory.

Všechna oznámení propojená s konkrétním spuštěním kanálu se vzájemně propojí.

Příklad 1: Kompaktní zobrazení propojených oznámení

Kompaktní vlákno

Příklad 2: Rozšířené zobrazení propojených oznámení

Rozbalené vlákno

Použití příkazů v aplikaci Azure Pipelines

Projděte si následující příkazy podporované aplikací Azure Pipelines:

Příkaz s lomítkem Funkce
@azure Kanály se přihlásí k odběru [adresa URL kanálu/ adresa URL projektu] Přihlášení k odběru kanálu nebo všech kanálů v projektu pro příjem oznámení
@azure Předplatná kanálů Přidání nebo odebrání odběrů pro tento kanál
@azure Zpětná vazba ke kanálům Nahlášení problému nebo návrh funkce
@azure Nápověda ke kanálům Získání nápovědy k příkazům lomítka
@azure Přihlášení kanálů Přihlášení k účtu Azure Pipelines
@azure Odhlášení kanálů Odhlaste se z účtu Azure Pipelines
@azure kanály odhlásí odběr všech [adresa URL projektu] Odebrání všech kanálů (patřících do projektu) a jejich přidružených předplatných z kanálu

Připojení více tenantů

Pokud používáte jiný e-mail nebo tenanta pro Microsoft Teams a Azure DevOps, přihlaste se a připojte se podle vašeho případu použití pomocí následujících kroků.

Případ použití ID e-mailu a tenant v Microsoft Teams ID e-mailu a tenant v Azure DevOps Akce přihlášení
0 email1@abc.com (tenant 1) email1@abc.com (tenant 1) Vyberte Přihlásit.
2 email1@abc.com (tenant 1) email2@pqr.com (tenant 2) – Přihlaste se k Azure DevOps.
- Ve stejném prohlížeči spusťte novou kartu a přejděte na https://teams.microsoft.com/.
– Spusťte sign in příkaz a vyberte Přihlásit se.
3 email1@abc.com (tenant 1) email2@pqr.com (tenant 2) - Vyberte Přihlásit se s jinou e-mailovou adresou.
- V nástroji pro výběr ID e-mailu se přihlaste pomocí e-mailu2.
4 email1@abc.com (tenant 1) email2@pqr.com (jiný než výchozí tenant 3) V současné době se nepodporuje.

Odstraňování potíží

Ve stejném prohlížeči spusťte novou kartu a přihlaste se k https://teams.microsoft.com/. @Azure Pipelines signout Spusťte příkaz a pak příkaz spusťte @Azure Pipelines signin v kanálu, kde je nainstalovaná aplikace Azure Pipelines pro Microsoft Teams.

Sign in Vyberte tlačítko a budete přesměrováni na stránku se souhlasem, jako je ta v následujícím příkladu. Ujistěte se, že adresář zobrazený vedle e-mailu je stejný jako adresář, který jste zvolili v předchozím kroku. Přijměte a dokončete proces přihlášení.

Souhlas s požadovanými oprávněními aplikace

Pokud tyto kroky váš problém s ověřováním nevyřeší, obraťte se na nás na komunitu vývojářů.