Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
V tomto článku se dozvíte, jak propojit pracovní položky s GitHub commity, pull requesty, větvemi a sestaveními po připojení projektu Azure Boards k úložišti GitHub. Můžete použít syntaxi #mention pro potvrzení a větve, použít zmínky ! k odkazu na žádosti o přijetí změn na GitHubu z diskuzí pracovních položek nebo přidat odkaz na GitHub potvrzení, žádost o přijetí změn nebo větev přímo z pracovní položky na Azure Boards.
Note
podpora integrace GitHub:
- Azure DevOps Services: Integruje se s úložišti GitHub.com i GitHub Enterprise Server prostřednictvím aplikace Azure Boards pro GitHub.
- Azure DevOps Server 2020 a novější: Podporuje integraci pouze s úložišti GitHub Enterprise Server.
- Jiná úložiště Git: Integrace se nepodporuje.
Prerequisites
| Category | Requirements |
|---|---|
| Povolení | Contributor do projektu Azure Boards i úložiště GitHub. |
| Připojení projektu | Azure Boards projekt je propojený s GitHub úložištěm, kde existují commity, pull requesty a větev, ke kterým chcete vytvořit propojení nebo z nichž chcete propojení vycházet. Další informace najdete v tématu Azure Boards-GitHub integrace. |
Note
Pokud chcete zobrazit část Vývoj a typy propojení GitHub, vyžadují projekty, které používají model hostovaného procesu XML, aktualizace typů pracovních položek. Další informace naleznete v tématu Aktualizace definic XML pro vybrané typy pracovních položek.
Použijte AB# k propojení z GitHub do Azure Boards pracovních úkolů
Pomocí následující syntaxe z GitHub commit, pull request nebo issue vytvořte odkaz na pracovní položku Azure Boards. Zadejte AB#ID do textu zprávy potvrzení. Nebo v případě žádosti o přijetí změn nebo problému zadejte AB#ID do popisu. Použití AB#ID v komentáři nebo názvu žádosti o přijetí změn nevytvoří odkaz na pracovní položku.
AB#{ID}
Například AB#125 odkazuje na pracovní položku s ID 125.
Můžete také zadat zprávu potvrzení nebo žádosti o přijetí změn a převést pracovní položku. Systém rozpozná {state} nebo {state category}, společně s fix, fixes a fixed, a použije to na položku, která následuje po #-zmínce.
Pokud popis žádosti o přijetí změn obsahuje například platný název Closed AB#1234stavu, systém aktualizuje odkazovanou pracovní položku na tento konkrétní stav. Pokud název stavu není rozpoznán přímo, Azure Boards se pokusí přiřadit ho ke kategorii pracovního postupu, jako je Resolved nebo Completed. Pokud se najde shoda, pracovní položka přejde do prvního dostupného stavu definovaného v této kategorii.
Ve výchozím nastavení pracovní položky odkazované na fix, fixes nebo fixed přecházejí do prvního stavu přidruženého k kategorii Vyřešené. Pokud v aktuálním procesu žádný takový stav neexistuje, systém místo toho převede pracovní položku do prvního stavu v kategorii Dokončeno .
Important
Stále můžete propojit pracovní položky a cílit na jiné větve, ale pravidla přechodu stavu se neuplatní, pokud pull request není sloučena do výchozí větve.
Další informace najdete v tématu Jak se stavy kategorií pracovního postupu používají v backlogech a panelech Azure Boards.
Projděte si následující tabulku příkladů:
| Zpráva o potvrzení nebo žádosti o přijetí změn | Action |
|---|---|
Fixed AB#123 |
Propojí a přepojí pracovní položku do kategorie Vyřešený stav pracovního postupu nebo pokud není definována žádná, pak kategorie Dokončený stav pracovního postupu. |
Closed AB#123 |
Umožňuje propojit a převést pracovní položku do stavu Uzavřený pracovní postup. Pokud není definován žádný, neprovedou se žádné přechody. |
Adds a new feature, fixes AB#123. |
Propojí a přepojí pracovní položku do kategorie Vyřešený stav pracovního postupu nebo pokud není definována žádná, pak kategorie Dokončený stav pracovního postupu. |
Fixes AB#123, AB#124, and AB#126 |
Odkazy na pracovní položky Azure Boards 123, 124 a 126. Provede přechod pouze první položku, 123 do kategorie Vyřešený stav pracovního postupu, nebo pokud není definován žádný, pak kategorie Dokončeno stav pracovního postupu. |
Fixes AB#123, Fixes AB#124, Fixes AB#125 |
Odkazy na pracovní položky v Azure Boards 123, 124 a 126. Přemísí všechny položky do kategorie Vyřešený stav pracovního postupu nebo pokud není definována žádná, pak kategorie Dokončený stav pracovního postupu. |
Fixing multiple bugs: issue #123 and user story AB#234 |
Odkazy na problém GitHub 123 a pracovní položku Azure Boards 234. Neprovedou se žádné přechody. |
Note
Pokud jste připojili stejný repozitář GitHub k projektům definovaným ve dvou nebo více organizacích Azure DevOps, mohlo by se vám zobrazit neočekávané propojení zmínky AB#. Další informace najdete v tématu Řešení problémů s připojením. Z tohoto důvodu doporučujeme připojit pouze GitHub úložiště k projektům definovaným v jedné Azure DevOps organizaci.
Když přidáte odkaz na pracovní položku pomocí AB# v popisu žádosti o přijetí změn, zobrazí se tyto odkazy v části Development části žádosti o přijetí změn GitHub. Tyto odkazy jsou k dispozici pouze, když použijete AB# v popisu žádosti o schválení změn. Nezobrazí se, pokud odkazujete na pull request přímo z pracovní položky.
AB# Odebráním odkazu z popisu ho odeberete také z části Vývoj.
Vytvoření větve GitHub z pracovní položky
Pokud chcete vytvořit GitHub větev přímo z pracovní položky, postupujte takto:
Na panelu najděte pracovní položku, kterou chcete použít k vytvoření GitHub větve.
Vyberte
akce pracovních položek>nová GitHub větev.
V dialogovém okně Vytvoření větve GitHub zadejte název větve. Vyberte úložiště GitHub a základní větev.
Vyberte Vytvořit.
Azure Boards vytvoří větev v zadaném úložišti GitHub a propojí ji s pracovní položkou. Další informace najdete v tématu Azure Boards-GitHub integrace.
Přidání odkazu na pracovní prvek do GitHub větve, potvrzení nebo pull requestu
Otevřete pracovní položku a přejděte do oblasti Vývoj .
Vyberte Přidat odkaz. V každé rozevírací nabídce vyberte váš typ odkazu, GitHub úložiště a GitHub pull request. Můžete vyhledávat a procházet podrobnosti v úložišti a vyhledávat a vybírat konkrétní žádost o přijetí změn nebo potvrzení, aniž byste museli kopírovat a vkládat adresu URL.
Vyberte Přidat odkaz.
Azure Boards ověřuje, že jste zadali správný odkaz. Propojené úložiště GitHub musí být připojeno k projektu Azure Boards, jinak ověření selže.
Note
Pokud používáte Azure DevOps Server a GitHub Enterprise Server, při dokončování odkazů AB# dochází ke zpoždění. Tento proces používá model push-and-pull pro získání událostí z GitHubu každou hodinu na přírůstkové změny v Commitech, žádostech o přijetí změn a problémech.
Automatické aktualizace propojení
Několik událostí automaticky aktualizuje odkazy na formuláři pracovní položky, takže je nemusíte vytvářet ručně. Mezi tyto události patří:
| událost GitHub | Action |
|---|---|
| Odkaz na větev | Když se vytvoří pull request z větve, automaticky je propojena s pracovní položkou. |
| Potvrzení sloučení | Po začlenění pull requestu se výsledný merge commit automaticky propojí s pracovní položkou. |
| Odstranit větev | Pokud je větev odstraněna (obvykle po sloučení), její odkaz se automaticky odebere z pracovní položky. |
Zobrazení nebo otevření odkazů z části Vývoj
Část Vývoj ve formuláři pracovní položky uvádí odkazy vytvořené na GitHub commity a pull requesty pomocí ikony 
GitHub.
Výběrem odkazu otevřete potvrzení nebo žádost o přijetí změn v GitHub.
GitHub poznatky z pull requestů
Propojené GitHub žádosti o přijetí změn v části Vývoj zobrazují další podrobnosti o stavu, takže můžete posoudit průběh bez otevření žádosti o přijetí změn v GitHub.
Předpoklady pro pull request insights
Pokud chcete zobrazit podrobnosti o žádostech o přijetí změn, přejděte do aplikace Azure Boards na GitHubu a přijměte aktualizovaná oprávnění pro přístup ke čtení a zápisu do kontrol.
Zobrazení podrobností o stavu pull requestu
Otevřete pracovní položku, která má propojený GitHub pull request.
V části Vývoj vyhledejte propojenou žádost o přijetí změn. Vedle odkazu na žádost o přijetí změn se zobrazí následující podrobnosti o stavu:
- Stav konceptu: Zobrazuje, jestli je pull request stále ve fázi konceptu.
- Stav recenze: Zobrazuje, zda žádost o stažení vyžaduje přezkoumání, byla schválena, nebo zda jsou požadovány změny.
- Stav kontrol: Zobrazuje, jestli kontroly CI procházejí, selhávají nebo čekají na vyřízení.
Najeďte myší na indikátor stavu, abyste zobrazili další podrobnosti, nebo výběrem odkazu na žádost o přijetí změn ho otevřete přímo v GitHub.
Zmiňte GitHub pull requesty pomocí !
Pomocí zmínek ! můžete přímo z libovolného bohatého textového pole nebo diskusního komentáře pracovní položky odkazovat na žádosti o přijetí změn a diskutovat o nich v GitHubu. Když do textového pole zadáte !, zobrazí se rozbalovací nabídka, pomocí které můžete vyhledat a vybrat pull request na GitHubu z připojeného úložiště. Vybraná žádost o přijetí změn se vloží jako odkaz umožňující kliknutí.
Tato funkce usnadňuje odkazování na související žádosti o přijetí změn v popisech pracovních položek, kritériích přijetí nebo diskuzích bez ručního kopírování adres URL.
Zobrazení stavu sestavení pro kanály YAML (integrované v sestavení)
Když použijete Azure Pipelines YAML k sestavení kódu hostovaného v úložišti GitHub, můžete automaticky vytvořit odkazy Integrated v sestavení na přidružené pracovní položky. Tato funkce poskytuje sledovatelnost sestavení pro GitHub úložišť a dosahuje parity s prostředím dostupným pro Azure Repos.
Jak tuto funkci povolit:
Otevřete kanál YAML, vyberte
Další akce a pak vyberte Nastavení.V dialogovém okně Nastavení sestavení povolte automaticky propojit nové pracovní položky v této verzi.
Po dokončení sestavení se v části Vývoj každé přidružené pracovní položky automaticky zobrazí odkaz Integrovaný v sestavení, který týmu poskytne úplnou sledovatelnost od pracovní položky ke sestavení.
Další informace o konfiguraci tohoto nastavení najdete v tématu Konfigurace kanálů pro podporu sledování práce.
Zobrazení GitHub objektů na panelu
Povolením GitHub anotací na tabuli můžete rychle otevřít propojené GitHub commity, žádosti o přijetí změn nebo problémy a získat tak podrobnější informace. Další informace naleznete v tématu Přizpůsobení karet.
