Sdílet prostřednictvím


Instalace aplikace Azure Boards pro GitHub

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

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 projekty Azure Boards s GitHub.com úložišti, podporujete propojení mezi potvrzeními GitHubu a žádostmi o přijetí změn s pracovními položkami. GitHub můžete použít k vývoji softwaru při plánování a sledování práce pomocí Azure Boards. Po instalaci aplikace Azure Boards pro GitHub do účtu nebo organizace GitHubu zvolte úložiště GitHub, ke kterým se chcete připojit z projektu.

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

Prerequisites

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

Important

Pokud už je vaše úložiště připojené pomocí jiného typu ověřování, jako je OAuth, musíte toto úložiště před opětovným připojením odebrat z existujícího připojení pomocí aplikace GitHub. Před konfigurací aplikace GitHub postupujte podle kroků uvedených v části Přidání nebo odebrání úložišť GitHub dále v tomto článku.

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

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. Přejděte do aplikace Azure Boards na GitHub Marketplace.

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

  3. V části Instalace a autorizace Azure Boards zvolte úložiště, která chcete připojit k Azure Boards, a pak vyberte Nainstalovat 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 organizaci Azure DevOps a projekt Azure Boards, ke kterému se chcete připojit k GitHub.com.

    Snímek obrazovky znázorňující stránku nastavení projektu Azure Boards, kde vyberete organizaci a projekt

    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.

Poskytněte přístup k organizaci Azure Boards

V případě potřeby udělte GitHubu přístup k vaší organizaci Azure DevOps pomocí následujícího postupu.

  1. Na webovém portálu GitHub otevřete nastavení z nabídky profilu.

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

  2. V části Integrace vyberte Aplikace.

  3. Vyberte Autorizované aplikace GitHub>Azure Boards.

    Snímek obrazovky znázorňující autorizované aplikace GitHubu se zvýrazněnou možností 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 GitHubu 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. Na GitHubu otevřete svou organizaci a přejděte do Nastavení > zásady aplikací 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 Možnost 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. Vyberte Typ odkazu a zvolte 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 úložišť GitHub.
    • Vytvoří potvrzení GitHubu pro aktualizaci provedenou přidáním odznáček do souboru README.
    • Vytvoří pull request na GitHubu, který sloučí změny provedené v souboru README.
    • Spojí commit na GitHubu a žádost o přijetí změn s pracovní položkou vytvořenou v kroku 1.
  6. Z pracovní položky vyberte první odkaz na pull request.

    Snímek obrazovky znázorňující formulář problému pro žádost o přijetí změn otevřený na GitHubu

    GitHub pull request se otevře na nové kartě prohlížeče.

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

    Snímek obrazovky znázorňující ukázku žádosti o přijetí změn na GitHubu

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

    Snímek obrazovky znázorňující úložiště GitHub s přidaným odznakem

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

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

Můžete nakonfigurovat jiné projekty Azure Boards nebo Azure DevOps, GitHub.com úložiště nebo změnit aktuální konfiguraci ze stránky aplikace Azure Boards. Další informace najdete v tématu Přidání nebo odebrání úložišť nebo odebrání 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 Nastavení projektu>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 znázorňující nabídku připojení GitHubu s dalšími možnostmi

  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 ukazuje potvrzení odebrání připojení k GitHubu.

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

  1. Na webovém portálu GitHub otevřete nastavení z nabídky profilu.

  2. Vyberte Integrace>Aplikace. V části Nainstalované aplikace GitHubu vyberte Konfigurovat.

    Snímek obrazovky s nainstalovanými aplikacemi GitHubu s Azure Boards a možností Konfigurace

    Otevře se konfigurační stránka 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á se chcete účastnit 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 odinstalovat aplikaci Azure Boards, zvolte Odinstalovat a poté v automaticky otevíraném okně s potvrzením vyberte OK.

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

Aktualizace připojení Azure Boards–GitHub

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

Pokud odinstalujete aplikaci Azure Boards pro GitHub, zobrazí se v Azure Boards následující zpráva v nastavení projektu, Projektová nastavení>Připojení GitHub. Pokud chcete odebrat všechna dříve vytvořená připojení GitHubu, zvolte Odebrat připojení . Další informace najdete v tématu Přidání nebo odebrání úložišť GitHub.

Snímek obrazovky znázorňující odinstalovanou aplikaci Azure Boards na GitHubu

Další kroky