Sdílet prostřednictvím


Instalace aplikace Azure Boards pro GitHub

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

V tomto rychlém startu nainstalujete aplikaci Azure Boards pro GitHub pro připojení Azure Boards k úložištím GitHub. Když propojíte Azure Boards projekty s úložišti GitHub.com, podporujete propojení mezi potvrzeními GitHub a žádostmi o přijetí změn s pracovními položkami. K plánování a sledování práce můžete použít GitHub pro vývoj softwaru při použití Azure Boards. Po instalaci aplikace Azure Boards pro GitHub do GitHub účtu nebo organizace zvolte, ke kterým GitHub úložištím se chcete z projektu připojit.

Přehled integrace, kterou aplikace Azure Boards pro GitHub podporuje, najdete v tématu Azure Boards-GitHub integrace.

Prerequisites

Category Requirements
Povolení - Člen skupiny správců kolekcí projektů . Pokud jste projekt vytvořili, máte oprávnění.
- Administrator nebo owner organizace GitHub pro instalaci aplikace Azure Boards.
oprávnění - Read pro úložiště GitHub.
Členství v projectu člen projektu.

Important

Pokud je úložiště již připojené pomocí jiného typu ověřování, jako je OAuth, musíte toto úložiště odebrat z existujícího připojení, než ho znovu připojíte pomocí aplikace GitHub. Před konfigurací aplikace GitHub postupujte podle kroků uvedených v Přidat nebo odebrat úložiště GitHub dále v tomto článku.

Pokud jste správcem těchto úložišť, můžete připojit Azure DevOps organizaci k více úložištím GitHub. Úložiště GitHub byste neměli připojit k více Azure DevOps organizaci.

Instalace a konfigurace aplikace Azure Boards

Vaše pořadí instalace se může lišit kvůli konfiguraci vašeho účtu. V případě potřeby postupujte podle pokynů na obrazovce mezi následujícími kroky.

  1. V GitHub Marketplace přejděte do aplikace Azure Boards.

  2. V části Plány a ceny vyberte v části Freemožnost Nainstalovat.

  3. V Instalace a autorizace Azure Boards zvolte úložiště, ke kterým chcete připojit Azure Boards, a poté vyberte možnost Instalovat a autorizovat.

    Tento příklad používá všechna úložiště:

    Snímek obrazovky se stránkou Instalovat a Autorizovat se všemi vybranými úložišti

  4. Zvolte Azure DevOps organizaci a Azure Boards projekt, ke kterému se chcete připojit k GitHub.com.

    Screenshot zobrazuje stránku s nastavením projektu Azure Boards, kde vyberete organizaci a project.

    Současně můžete připojit pouze jeden projekt. Pokud máte další projekty, které chcete připojit, můžete to udělat později, jak je popsáno v části Konfigurace jiných projektů nebo úložišť dále v tomto článku.

Udělení přístupu organizaci Azure Boards

V případě potřeby udělte GitHub přístup k organizaci Azure DevOps následujícím postupem.

  1. Na webovém portálu GitHub otevřete v nabídce profilu Nastavení.

    Snímek obrazovky s možností Nastavení ve vašem profilu

  2. V části Integrace vyberte Aplikace.

  3. Vyberte Authorized GitHub Apps>Azure Boards.

    Screenshot zobrazuje autorizované GitHub aplikace se zvýrazněnými Azure Boards.

  4. V části Přístup k organizaci vyřešte případné problémy. Výběrem možnosti Udělit udělíte přístup všem organizacím, které se zobrazují jako čekající na vyřízení žádosti o přístup.

    Snímek obrazovky znázorňující přístup organizace s organizacemi bez přístupu

Kontrola zásad přístupu k aplikacím třetích stran

Ujistěte se, že vaše organizace GitHub povoluje přístup k aplikacím třetích stran pro aplikaci Azure Boards. Pokud je přístup třetích stran omezený, přidání úložišť z Azure DevOps může zobrazit prázdný seznam nebo způsobit chybu.

Povolení přístupu:

  1. V GitHub otevřete organizaci a přejděte na Nastavení > zásady aplikace OAuth.

  2. Schvalte aplikaci Azure Boards konkrétně (doporučeno) nebo odeberte omezení pro všechny aplikace třetích stran.

    Snímek obrazovky ukazuje zásady přístupu k aplikacím třetích stran.

Poznámka:

Pokud chcete toto nastavení změnit, musíte být vlastníkem nebo správcem organizace.

Použijte připojení

V tuto chvíli je integrace Azure Boards-GitHub dokončena. Můžete přeskočit další kroky nebo si je projít, abyste porozuměli funkcím podporovaným připojením.

  1. Na panelu vyberte Nová pracovní položka a zadejte novou pracovní položku s názvem Přidat odznáček do souboru README – Problém (Základní), Uživatelský scénář (Agilní) nebo Položka backlogu produktu (Scrum) v závislosti na modelu procesu používaném vaším projektem Azure Boards.

    Na panelu se zobrazí pracovní položka s názvem Přidat odznáček k souboru README .

  2. Otevřete pracovní položku, přejděte do části Vývoj a vyberte Přidat odkaz.

  3. Z Typ odkazu vyberte GitHub Pull Request.

  4. Vyberte úložiště a zadejte ID žádosti o přijetí změn a volitelný komentář.

  5. Vyberte Přidat odkaz.

    Snímek obrazovky znázorňující akci Přidat odkaz v uživatelském scénáři zobrazující výběr úložiště a prázdná pole pro zadání ID žádosti o přijetí změn a volitelného komentáře

    Na pozadí dochází k následujícím akcím:

    • Přidá odznáček do souboru README prvního úložiště v seznamu připojených GitHub úložišť.
    • Vytvoří potvrzení GitHub pro aktualizaci provedenou přidáním odznáček do souboru README.
    • Vytvoří GitHub pull request ke sloučení změn v souboru README.
    • Prováže GitHub potvrzení a žádost o začlenění s pracovní položkou vytvořenou v kroku 1.
  6. Z pracovní položky vyberte první odkaz na pull request.

    Screenshot zobrazuje formulář problému pro žádost o přijetí změn otevřenou v GitHub.

    Pull request na GitHubu se otevře v nové kartě prohlížeče.

  7. Vyberte Sloučit žádost o přijetí.

    Screenshot ukazuje příklad žádosti o přijetí změn v GitHub.

  8. Přejděte do souboru README úložiště a podívejte se na odznáček, který byl přidán.

    Screenshot zobrazuje úložiště GitHub s přidaným odznáčkem.

    Další informace najdete v tématu Přidání odznáčků stavu úložiště GitHub.

Konfigurace jiných projektů nebo úložišť

Můžete nakonfigurovat další projekty Azure Boards/Azure DevOps, úložiště GitHub.com nebo změnit aktuální konfiguraci ze stránky aplikace Azure Boards. Další informace najdete v tématu Přidat nebo odebrat úložiště nebo odebrat připojení z Azure Boards.

Přidání nebo odebrání úložišť nebo odebrání připojení z Azure Boards

Pokud narazíte na problém s připojením, doporučujeme připojení odebrat a začít znovu s novým připojením.

  1. V projektu v Azure DevOps přejděte na Projektová nastavení>GitHub připojení.

  2. Pokud chcete přidat nebo odebrat úložiště, vyberte tři tečky Další možnosti pro připojení a v nabídce zvolte Přidat úložiště nebo Odebrat úložiště .

    Snímek obrazovky zobrazuje nabídku připojení z GitHubu v nabídce Další možnosti.

  3. Pokud chcete odebrat všechna úložiště a připojení, zvolte možnost Odebrat připojení . Potom potvrďte výběr možnosti Odebrat .

    Snímek obrazovky zobrazuje potvrzení odstranění připojení k GitHubu.

Změna přístupu k úložišti

  1. Na webovém portálu GitHub otevřete v nabídce profilu Nastavení.

  2. Vyberte Integrace>Aplikace. V části Instalované aplikace GitHub vyberte Konfigurovat.

    Screenshot zobrazuje nainstalované aplikace GitHub a Azure Boards a možnost Konfigurovat.

    Otevře se stránka konfigurace Azure Boards.

  3. Posuňte se dolů do části Přístup k úložišti.

  4. Zvolte požadovanou možnost, Všechna úložiště nebo Pouze vybrat úložiště.

    Pokud zvolíte Pouze vybraná úložiště, vyberte úložiště, které chcete zapojit do integrace s Azure Boards.

    Snímek obrazovky ukazuje přístup k úložišti, kde můžete vybrat vybraná úložiště.

  5. Vyberte Uložit.

Pozastavení nebo odinstalace integrace Azure Boards

  1. Od kroku 2 v předchozím postupu se posuňte dolů do části Zóna nebezpečí.

    Snímek obrazovky znázorňující část Zóna nebezpečí s možnostmi pozastavení a odinstalace

  2. Pokud chcete integraci pozastavit, zvolte Pozastavit. V potvrzovacím okně potvrďte pozastavení kliknutím na TLAČÍTKO OK .

    Snímek obrazovky s dialogovým oknem potvrzení pozastavení

    Pokud chcete integraci zrušit, zvolte Unsuspend.

  3. Pokud chcete aplikaci Azure Boards odinstalovat, zvolte Uninstall a pak v okně s potvrzením automaticky otevírané nabídky zvolte OK.

    Snímek obrazovky ukazuje potvrzovací dialogové okno odinstalace.

Aktualizace připojení mezi Azure Boards a GitHubem

Pokud změníte úložiště, která Azure Boards aplikace pro GitHub podporuje, můžete být přesměrováni na připojení Azure Boards GitHub. Osvědčeným postupem je odebrat úložiště v Azure Boards, která se už nemůžou připojit k GitHub. Další informace najdete v tématu Přidat nebo odebrat úložiště GitHub.

Pokud odinstalujete aplikaci Azure Boards pro GitHub, zobrazí se v Azure Boards následující zpráva v Nastavení projektu>GitHub připojeních. Pokud chcete odebrat všechna dříve vytvořená připojení GitHub, zvolte Remove connection. Další informace najdete v tématu Přidat nebo odebrat úložiště GitHub.

Screenshot zobrazuje neinstalovanou aplikaci Azure Boards GitHub.

Další kroky