Použití Azure Repos se Slackem

Služby Azure DevOps

Pokud používáteSlack, můžete k snadnému monitorování úložišť Azure Repos použít aplikaci Azure Repos pro Slack. Nastavte a spravujte odběry pro příjem oznámení v kanálu, kdykoli je kód odeslán nebo vrácen se změnami a kdykoli je požadavek na sloučení vytvořen, aktualizován nebo sloučen. Tato aplikace podporuje události správy verzí jak pro Git, tak pro Team Foundation Version Control (TFVC).

Požadavky

Kategorie Požadavky
Platforma Aplikace Slack pro Azure Repos funguje jenom se službou Azure DevOps Services (cloud); Azure DevOps Server ho nepodporuje.
Povolení Vytvoření odběrů v kanálu Slack pro události související s úložištěm: Člen skupiny Správci projektu nebo správce týmu. Další informace najdete v tématu Změna oprávnění na úrovni projektu nebo Přidání správce týmu.
Účet Microsoft Entra Pokud je vaše organizace připojená k tenantovi Microsoft Entra ID, přihlaste se pomocí účtu, který je nativním členem tohoto tenanta; Při přihlašování přes Slack může docházet k chybám ověřování hosta nebo externích účtů.

Přidání aplikace Azure Repos do pracovního prostoru Slack

  1. Přejděte na aplikaci Azure Repos Slack a vyberte Přidat do Slack .

    snímek obrazovky s adresářem aplikace Slack, Azure Repos a tlačítkem Přidat do Slacku

    Po přidání se zobrazí něco podobného jako následující uvítací zpráva.

    snímek obrazovky s uvítací zprávou ze Slacku

  2. K interakci s aplikací použijte uživatelské jméno /azrepos Slack. Úplný seznam příkazů je uveden v části Reference příkazů tohoto článku.

Připojení aplikace Azure Repos k úložištím

  1. Připojte se k Azure Repos a ověřte se pomocí příkazu /azrepos signin.

    snímek obrazovky s výzvou k přihlášení pro Slack

  2. Vyberte Přihlásit.

  3. přijmout integraci Azure Repos Slacku.

    snímek obrazovky s tlačítkem Přijmout ve výsledné přihlašovací obrazovce

    Zobrazí se ověřovací kód pro použití v chatovací aplikaci k dokončení ověřování.

  4. Zkopírujte ověřovací kód.

    snímek obrazovky s ověřovacím kódem poskytovaným službou Azure Repos

  5. Vyberte Zadejte kód, vložte kód a pak vyberte Odeslat.

    Snímek obrazovky s konečnou ověřovací obrazovkou při vložení ověřovacího kódu a vybrání tlačítka Odeslat

    Potvrzení přihlášení se zobrazí v chatu.

    snímek obrazovky potvrzení přihlášení v chatu

Pokud chcete začít monitorovat všechna úložiště Git v projektu, použijte v kanálu následující příkaz lomítko:

/azrepos subscribe [project url]

Adresa URL projektu může být libovolná stránka v projektu (s výjimkou adres URL pro úložiště). Například:

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

Konkrétní úložiště můžete monitorovat také pomocí následujícího příkazu:

/azrepos subscribe [repository url]

Adresa URL úložiště může být na libovolnou stránku ve vašem úložišti, která má název úložiště. Například pro úložiště Git použijte:

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

Pro úložiště TFVC použijte:

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

Poznámka

Můžete se přihlásit jenom k odběru veřejných úložišť.

Příkaz pro přihlášení k odběru vám pomůže začít s výchozím předplatným. U úložišť Git je kanál přihlášen k události vytvoření žádosti o přijetí změn s cílovou větví = main a pro úložiště TFVC je kanál přihlášen k události kontroly kódu .

Snímek obrazovky zobrazuje zprávu o vytvoření výchozích odběrů.

Správa předplatných

Pokud chcete zobrazit, přidat nebo odebrat odběry kanálu, použijte následující příkaz subscriptions:

/azrepos subscriptions

Tento příkaz zobrazí seznam všech aktuálních předplatných pro kanál a umožňuje přidat nová předplatná nebo odebrat existující. Při přidávání odběrů můžete oznámení, která dostanete, přizpůsobit pomocí různých filtrů, jak je popsáno v následující části.

Poznámka

Správci týmu nemůžou odebírat ani upravovat předplatná vytvořená správci projectu.

Snímek obrazovky se seznamem předplatných

Přizpůsobení předplatných pomocí filtrů

Když se uživatel přihlásí k odběru úložiště pomocí příkazu /azrepos subscribe, vytvoří se výchozí předplatné. Uživatelé často potřebují tato předplatná přizpůsobit. Uživatelé například můžou chtít dostávat oznámení pouze tehdy, když pull requesty mají konkrétního revizora.

Následující kroky ukazují, jak přizpůsobit předplatná.

  1. Spusťte příkaz /azrepos subscriptions.
  2. Pokud je v seznamu předplatných nežádoucí nebo je nutné ho upravit (příklad: vytvoření šumu v kanálu), vyberte tlačítko Odebrat .
  3. Vyberte tlačítko Přidat předplatné.
  4. Vyberte požadované úložiště a požadovanou událost.
  5. Vyberte vhodné filtry.

Příklad: Dostávat oznámení pouze v případě, že je můj tým na seznamu recenzentů pro PR

Snímek obrazovky ukazuje, že revidující má můj tým.

Příklad: Řekněte mi, když pokusy o sloučení selžou kvůli porušení zásad

snímek obrazovky ukazuje neúspěšný pokus o sloučení – kvůli porušení zásad.

Poznámka

  • Všechny filtry jsou obvykle rozevírací nabídky. Pokud ale rozevírací seznam obsahuje více než 100 položek, musí uživatelé zadat hodnoty ručně.
  • U události TFVC Kód zařazený do verzí musí mít filtr .

Náhled URL adres pull requestů

Když uživatel vloží adresu URL pull requestu, zobrazí se náhled podobný následujícímu obrázku, který pomáhá udržovat kontext a přehlednost konverzací souvisejících s pull requestem.

snímek obrazovky ukazuje rozfouření adresy URL.

Po přihlášení uživatelů tato funkce funguje pro všechny kanály v pracovním prostoru.

Odebrání předplatných a úložišť z kanálu

Pomocí následujícího příkazu vyčistíte kanál odebráním úložišť a předplatných.

/azrepos unsubscribe all [project url]

Následující příkaz například odstraní všechna předplatná související s jakýmkoli úložištěm v projektu a odebere úložiště z kanálu. Tento příkaz můžou spustit jenom správci projektu.

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

Referenční informace k příkazům

V následující tabulce jsou uvedeny všechny /azrepos commands, které můžete použít v kanálu Slack.

Příkaz Lomítko Funkčnost
/azrepos subscribe [repository url/ projektová URL] Přihlášení k odběru úložiště nebo všech úložišť v projektu pro oznámení
/azrepos předplatná Přidání nebo odebrání odběrů pro tento kanál
/azrepos signin Přihlášení k organizaci Azure Repos
/azrepos signout Odhlaste se z organizace Azure Repos
/azrepos zpětná vazba Nahlášení problému nebo návrh funkce
/azrepos odhlásit odběr všech [adresa URL projektu] Odebrání všech úložišť (patřících do projektu) a jejich přidružených předplatných z kanálu
/azrepos help Získání nápovědy k příkazům

Oznámení v privátních kanálech

Aplikace Azure Repos vám může pomoct také monitorovat události úložiště ve vašich privátních kanálech. Pozvěte robota do svého privátního kanálu pomocí /invite @azrepos. Pak můžete oznámení spravovat stejným způsobem jako u veřejného kanálu.

Řešit problémy

Pokud při používání aplikace Azure Repos pro Slack dochází k následujícím chybám, postupujte podle pokynů v této části.

Konfigurace se nezdařila. Ujistěte se, že organizace {název organizace} existuje a že máte dostatečná oprávnění.

Odhlaste se z Azure DevOps tak, že přejdete na https://aka.ms/VsSignout pomocí prohlížeče.

Otevřete v privátním nebo anonymním okně prohlížeče a přejděte na https://aex.dev.azure.com/me a přihlaste se. V rozevíracím seznamu pod ikonou profilu vlevo vyberte adresář, který obsahuje organizaci obsahující úložiště, ke kterému chcete přihlásit odběr.

Vyberte adresář, který obsahuje organizaci s projektem

V stejném prohlížečiotevřete novou kartu, přejděte na https://slack.coma přihlaste se k pracovnímu prostoru (použijte webového klienta). Spusťte příkaz /azrepos signout následovaný příkazem /azrepos signin.

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

  • Last updated on