Instalace aplikace Azure Boards pro GitHub

služby Azure DevOps | 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

Kategorie oprávnění	Requirements
Azure DevOps	- Člen skupiny správců kolekcí projektů . Pokud jste projekt vytvořili, máte toto oprávnění. - Člen projektu v projektu Azure Boards.
GitHub	- Správce nebo vlastník organizace GitHubu, který může nainstalovat aplikaci Azure Boards - Oprávnění ke čtení pro úložiště GitHub

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

Následující kroky ukazují typickou sekvenci instalace. Podle pokynů na obrazovce dokončete nastavení.

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 vyberte úložiště, která chcete připojit k Azure Boards, a potom vyberte Instalovat a autorizovat.

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

   

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

   

   Současně můžete připojit pouze jeden projekt. Pokud chcete připojit jiné projekty, přečtěte si téma Konfigurace jiných projektů nebo úložišť.

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

Pokud chcete GitHub udělit přístup k Azure DevOps organizaci, proveďte následující kroky.

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

   

2. V části Integrace vyberte Aplikace.

3. Vyberte Authorized GitHub Apps>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.

   

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 do>nastavení zásad aplikace OAuth.

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

   

Poznámka:

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

Propojení pracovních položek s GitHub žádostmi o přijetí změn

Po konfiguraci integrace azure Boards-GitHub můžete pracovní položky propojit s GitHub žádostmi o přijetí změn a potvrzeními.

Následující příklad ukazuje integraci na vytvoření pracovní položky a jejím propojení s pull requestem:

1. Na panelu vyberte Možnost Nová pracovní položka a vytvořte pracovní položku. V tomto příkladu použijte název Přidat odznáček do souboru README. Typ pracovní položky závisí na vašem procesu: Problém (Základní), Uživatelský scénář (Agilní) nebo Položka backlogu produktu (Scrum).

   Nová pracovní položka se zobrazí na panelu.

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

3. Vyberte Přidat odkaz a potom v nabídce Typ odkazu vyberte GitHub Pull Request.

4. Vyberte úložiště a zadejte ID požadavku na přijetí změn. Můžete také přidat volitelný komentář.

5. Vyberte možnost Přidat odkaz a vytvořte připojení.

   Azure Boards na pozadí automaticky provede následující akce:

   • Přidá odznáček do souboru README prvního úložiště v seznamu připojených GitHub úložišť.
   • Vytvoří commit na GitHubu pro aktualizaci odznaku.
   • Vytvoří na GitHubu pull request ke sloučení změn v souboru README.
   • Propojí revizi na GitHubu a žádost o přijetí změn s vaší pracovní položkou.

6. V pracovní položce vyberte odkaz na žádost o přijetí změn a otevřete ho v GitHub.

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

8. V úložišti GitHub otevřete soubor README a ověřte, že byl odznáček přidán. Další informace najdete v tématu Konfigurace odznáček stavu pro přidání do GitHub souborů README.

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, odeberte připojení a začněte znovu s novým připojením.

1. V projektu v Azure DevOps vyberte Nastavení projektu>Připojení GitHubu.

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

   

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 .

   

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.

   

   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.

   

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čí.

   

2. Pokud chcete integraci pozastavit, vyberte Pozastavit. V potvrzovacím okně potvrďte pozastavení výběrem tlačítka OK .

   

   Pokud chcete integraci zrušit, vyberte Unsuspend.

3. Pokud chcete odinstalovat Azure Boards aplikaci, vyberte Odinstalovat a pak v automaticky otevírané okno s potvrzením vyberte OK.

   

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. Výběrem možnosti Odebrat připojení odeberete všechna dříve vytvořená připojení GitHub. Další informace najdete v tématu Přidat nebo odebrat úložiště GitHub.

Řešení potíží s integrací

Prázdný seznam úložišť při přidávání úložišť

Pokud se seznam úložiště zobrazí v Azure DevOps prázdný:

• Ověřte, že vaše organizace GitHub povolila přístup k aplikacím třetích stran.
• Ujistěte se, že jste Azure Boards udělili oprávnění k přístupu k vaší organizaci v Udělte Azure Boards přístup k organizaci.
• V GitHubu zkontrolujte nastavení organizace > Nainstalované aplikace GitHubu > Azure Boards > Přístup organizace. Pokud se jako stav zobrazuje „Žádost o přístup čeká na vyřízení“, vyberte Udělit a žádost schvalte.

Zaseknutý stav „Žádost o přístup čeká na vyřízení“

Pokud přístup k organizaci zůstane nevyřízený:

• Abyste mohli žádost schválit, musíte být vlastníkem nebo správcem organizace GitHub.
• V části Přístup k organizaci v nastavení autorizovaných aplikací vyberte Udělit.
• Pokud problém přetrvává, odinstalujte aplikaci Azure Boards a znovu ji nainstalujte podle kroků v části Instalace a konfigurace aplikace Azure Boards.

Odznak se po propojení pull requestu nezobrazuje

Pokud se po propojení pull requestu v souboru README nezobrazí odznak:

• Odznáček se zobrazí, jenom když propojíte žádost o přijetí změn a úložiště je první v připojeném seznamu.
• Ověřte, že PR, na které jste odkazovali, je stále otevřené (sloučená PR nespustí vytvoření odznaku).
• Zkontrolujte, že Azure Boards má k úložišti přístup pro zápis.

Chyby ověřování nebo oprávnění

Pokud se během instalace zobrazí chyby ověřování:

• Ověřte, že jste vlastníkem nebo správcem organizace v GitHub.
• Ujistěte se, že vaše organizace GitHub neomezila přístup k aplikacím třetích stran.
• Zkontrolujte, jestli máte oprávnění ke čtení v úložišti, ke kterému se chcete připojit.
• Zkuste se odhlásit z GitHub a znovu se přihlásit a pak zkusit znovu provést autorizaci.

Další krok

Propojte GitHub commity, pull requesty a větve s pracovními položkami

Související obsah

• Řídit vývoj Gitu z pracovní položky
• Změna přístupu k úložišti GitHub, nebo pozastavení či odinstalování integrace
• Konfigurování odznáček stavu pro přidání do GitHub souborů README