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

  • Pokud chcete nainstalovat aplikaci Azure Boards, musíte být správcem nebo vlastníkem organizace GitHubu.
  • Pokud se chcete připojit k projektu Azure Boards, musíte mít oprávnění ke čtení pro úložiště GitHub. Musíte být také členem skupiny Kolekce projektů Správa istrators. Pokud jste projekt vytvořili, máte oprávnění.

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

Následujícím postupem udělíte přístup k organizaci.

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

    Screenshot of open profile, choose Settings.

  2. V části Integrace vyberte Aplikace.

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

    Screenshot of Authorized OAuth Apps tab, choose 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.

    Screenshot of Organization access with organizations without access.

Instalace a konfigurace aplikace Azure Boards

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

  2. Vyberte Nastavit plán.

    Screenshot of GitHub Marketplace, Set up a plan button.

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

    Screenshot showing Install Azure Boards dialog.

  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.

    Screenshot showing all repositories selected.

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

    Screenshot of setting up connection dialog.

    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. Autorizovat organizaci Azure Boards pro připojení pomocí GitHub.com

    Screenshot of Azure Boards authorization dialog.

  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.

    Screenshot of Confirm your GitHub repositories dialog.

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á 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 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 a v části Přidat odkaz vyberte žádost o přijetí změn.

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

  4. Vyberte Přidat odkaz.

    Screenshot of Add link action in user story, showing repository selection and empty boxes for input of pull request ID and optional comment.

    Na pozadí probíhají následující akce.

    • 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.
  5. Z pracovní položky vyberte první odkaz na žádost o přijetí změn.

    Screenshot of issue form for pull request opened in GitHub.

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

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

    Screenshot of example pull request in GitHub.

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

    Screenshot of GitHub repo with badge added.

    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. Pokud chcete přidat nebo odebrat úložiště, zvolte Další možnosti připojení a v nabídce zvolte Přidat úložiště nebo Odebrat úložiště .

    Screenshot of GitHub connection menu of More options.

  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 .

    Screenshot of confirmation removal of GitHub connection.

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

    Screenshot of add or remove GitHub repos.

  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 .

    Screenshot of confirmation of GitHub connection removal dialog.

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

  1. Přihlaste se k webovému portálu pro vaši organizaci GitHub a otevřete nastavení účtu.

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

  2. Zvolte Nainstalované aplikace GitHubu a pak nakonfigurujte vedle Azure Boards.
    Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.

    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.

    Screenshot of Repository access, choose Only select repositories.

  5. Po dokončení 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čí.

    Screenshot of Azure Boards configuration, Danger zone section.

  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 .

    Screenshot of suspension confirmation.

    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 .

    Screenshot of uninstall confirmation.

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.

Screenshot of uninstalled Azure Boards GitHub app.

Další kroky