Sdílet prostřednictvím


Instalace aplikace Azure Boards pro GitHub

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Nainstalujte 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.

Přehled integrace, kterou aplikace Azure Boards pro GitHub podporuje, najdete v tématu Integrace Azure Boards-GitHub. Po instalaci aplikace Azure Boards pro GitHub na účet nebo organizaci GitHub zvolte úložiště GitHub, ke kterým se chcete připojit z projektu.

Požadavky

Oprávnění:

  • Pokud chcete nainstalovat aplikaci Azure Boards, buďte správcem nebo vlastníkem organizace GitHubu.
  • Mít oprávnění ke čtení pro úložiště GitHub.
  • Buďte členem skupiny Správci kolekcí projektů. Pokud jste projekt vytvořili, už tato oprávnění máte.

Důležité

Pokud už je vaše úložiště připojené prostřednictvím 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 přes aplikaci 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. Neměli byste ale připojit úložiště GitHub k více než jedné organizaci Azure DevOps.

Udělení přístupu k organizaci Azure Boards

Pokud chcete gitHubu udělit přístup k vaší organizaci Azure DevOps, postupujte následovně.

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

    Snímek obrazovky s otevřeným profilem a zvolte Nastavení.

  2. V části Integrace vyberte Aplikace.

  3. Vyberte Autorizované aplikace GitHubu>v Azure Boards.

    Snímek obrazovky s kartou Autorizované aplikace OAuth a zvolte Azure Boards.

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

    Snímek obrazovky s přístupem organizace s organizacemi bez přístupu

Instalace a konfigurace aplikace Azure Boards

  1. Přejděte do aplikace Azure Boards na GitHub Marketplace.

  2. Vyberte Nastavit plán.

    Snímek obrazovky s GitHub Marketplace a tlačítkem Nastavit plán

  3. Zvolte organizaci GitHubu, ke které se chcete připojit k Azure Boards.

    Snímek obrazovky s dialogovým oknem Nainstalovat Azure Boards

  4. Zvolte úložiště, ke kterým se chcete připojit ke službě Azure Boards.

    V následujícím příkladu se rozhodneme připojit ke všem úložištím.

    Snímek obrazovky zobrazující všechna vybraná úložiště

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

    Snímek obrazovky s nastavením dialogového okna připojení

    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.

  6. Pokud se chcete připojit pomocí GitHub.com, povolte organizaci Azure Boards.

    Snímek obrazovky s dialogovým oknem autorizace azure Boards

  7. Potvrďte GitHub.com úložiště, ke kterým se chcete připojit. Vyberte každé úložiště, ke kterému se chcete připojit. Zrušte výběr všech úložišť, která se nechcete účastnit integrace.

    Snímek obrazovky s dialogovým oknem Potvrdit úložiště GitHub

Použití 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. V rozevírací nabídce Typ odkazu vyberte Žádost o přijetí změn GitHubu.

  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 s akcí 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ří žádost o přijetí změn GitHubu, která sloučí změny provedené v souboru README.
    • Prováže potvrzení GitHubu a žádost o přijetí změn na pracovní položku vytvořenou v kroku 1.
  6. Z pracovní položky vyberte první odkaz na žádost o přijetí změn.

    Snímek obrazovky s formulářem problému pro žádost o přijetí změn otevřenou na GitHubu

    Žádost o přijetí změn GitHubu se otevře na nové kartě prohlížeče.

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

    Snímek obrazovky s ukázkou žádosti o přijetí změn na GitHubu

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

    Snímek obrazovky úložiště GitHub s přidaným odznáček

    Další informace najdete v tématu Konfigurace odznáček stavu pro přidání do souborů README GitHubu.

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 Změna přístupu k úložišti GitHub nebo pozastavení nebo odinstalace integrace.

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 připojení GitHubu k nastavení>projectu.

  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 s nabídkou 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 s potvrzením odebrání připojení GitHubu

  1. Pokud chcete přidat nebo odebrat úložiště, otevřete ikonu akcí pro připojení a v nabídce zvolte Přidat úložiště nebo Odebrat úložiště .

    Snímek obrazovky s přidáním nebo odebráním úložišť GitHub

  2. 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 s potvrzením dialogového okna pro odebrání připojení GitHubu

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

  1. Přihlaste se k GitHubu a otevřete nastavení profilu vaší organizace.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Přejděte na Nainstalované aplikace GitHubu>a nakonfigurujte Azure Boards.>
    Snímek obrazovky s otevřeným účtem organizace, nainstalovanými aplikacemi GitHubu, Azure Boards a konfigurací

    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 vybrat úložiště, vyberte úložiště, která chcete účastnit integrace s Azure Boards.

    Snímek obrazovky s přístupem k úložišti a zvolte Pouze vybrat úložiště.

  5. Zvolte 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 s konfigurací Azure Boards, částí Zóna nebezpečí

  2. Pokud chcete integraci pozastavit, zvolte Pozastavit. V okně s potvrzením automaticky otevírané nabídky potvrďte pozastavení kliknutím na tlačítko OK .

    Snímek obrazovky s potvrzením pozastavení

    Pokud chcete integraci zrušit, zvolte Unsuspend.

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

    Snímek obrazovky s potvrzením 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 s připojením GitHubu v nastavení>projektu. 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 s odinstalovanou aplikací Azure Boards na GitHubu

Další kroky