Azure Boards csatlakoztatása a GitHubhoz (felhő)

Azure DevOps Szolgáltatások

Csatlakoztassa az Azure Boards-projektet GitHub.com adattárakhoz, így a véglegesítési és lekéréses kérelmek automatikusan munkahelyi elemekhez kapcsolódnak. Ez az integráció lehetővé teszi, hogy megtervezze és nyomon kövesse a munkát az Azure Boardsban, miközben csapata a GitHubon fejlődik.

A csatlakozás után a következőt teheti:

• Véglegesítések, ágak és lekéréses kérelmek automatikus csatolása munkaelemekhez
• A fejlesztési folyamat figyelése közvetlenül az Azure Boardsból
• A GitHub Copilot használata munkaelemekkel az AI által támogatott fejlesztéshez

Note

Az Azure Boards támogatja a GitHub.com és a GitHub Enterprise Server integrációját is. Ha helyszíni Azure DevOps Serverről szeretne csatlakozni, olvassa el az Azure DevOps Server csatlakoztatása a GitHub Enterprise Serverhez című témakört.

Prerequisites

Category	Requirements
Jogosultságok	- A projektcsoport rendszergazdái csoport tagja Ha létrehozta a projektet, rendelkezik engedélyekkel. - Adminisztrátor vagy tulajdonos, aki csatlakozni szeretne a GitHub tárházhoz. Több GitHub adattárhoz is csatlakozhat, ha ön rendszergazda az adattárakhoz.
Projekttagság	Projektcsapattag.

Hitelesítési lehetőségek

A következő hitelesítési lehetőségek támogatottak azon GitHub platform alapján, amelyhez csatlakozni szeretne.

GitHub.com

GitHub vállalati kiszolgáló

• GitHub.com felhasználói fiók (ajánlott)
• Személyes hozzáférési jogkivonat (PAT)

• OAuth (előnyben részesített, regisztráció szükséges)
• PAT
• GitHub hitelesítő adatok

Note

Ha PAT-kapcsolattal csatlakozik, konfigurálja az egyszeri bejelentkezést (SSO) a GitHub-fiókjában. Az egyszeri bejelentkezés szükséges az SAML-hitelesítést használó szervezet adattárainak listázásához.

Azure Boards csatlakoztatása GitHub adattárhoz

1. Jelentkezzen be a projektbe (https://dev.azure.com/{Your_Organization/Your_Project}).

2. Válassza a Projekt beállításai>GitHub kapcsolatok lehetőséget.

   

3. Első kapcsolat esetén válassza a GitHub-fiók csatlakoztatása a GitHub-hitelesítő adatokkal való hitelesítéshez.

   

   További kapcsolatok esetén válassza az Új kapcsolat lehetőséget, és válassza ki a hitelesítési módszert.

   Ha inkább PAT-kapcsolattal szeretne csatlakozni, olvassa el a GitHub-kapcsolat hozzáadása PAT használatával című témakört. A GitHub Enterprise Server esetében lásd: Azure DevOps regisztrálása a GitHubon OAuth-alkalmazásként.

GitHub kapcsolat hozzáadása GitHub hitelesítő adatokkal

Egy Azure Boards projekthez legfeljebb 1000 GitHub adattárat csatlakoztathat.

1. Jelentkezzen be a GitHub hitelesítő adataival. Válasszon egy fiókot, ahol Ön adattár-rendszergazda.

2. Válassza ki a csatlakozni kívánt GitHub-fiókot vagy -szervezetet. A listában csak az Ön tulajdonában vagy felügyelete alatt lévő szervezetek jelennek meg.

   Ha egy szervezet összes adattára már csatlakoztatva van, a következő üzenet jelenik meg:

   

3. Adja meg a GitHub hitelesítő adatait. Ha engedélyezve van a kéttényezős hitelesítés, írja be a GitHub által küldött kódot, és válassza az Ellenőrzés lehetőséget.

GitHub adattárak hozzáadása

A hitelesítés után válassza ki a csatlakoztatni kívánt adattárakat.

1. A GitHub-adattárak hozzáadása párbeszédpanel megjeleníti és előre kijelöli az összes olyan adattárat, ahol Ön rendszergazda a kijelölt szervezetben. Törölje az összes olyan adattárat, amelyhez nem szeretne csatlakozni.

   

   Tip

   Csatlakoztassa az egyes GitHub-adattárakat egyetlen Azure DevOps-szervezet projektjeihez, hogy elkerülje a váratlan AB# -említések összekapcsolását. További információ: Kapcsolati problémák megoldása.

   Ha az összes adattár már csatlakozik az aktuális vagy egy másik szervezethez, a következő üzenet jelenik meg:

   

2. Válassza az Mentésgombot.

A kapcsolat megerősítése

1. A GitHub lapon válassza a Jóváhagyás, telepítés és engedélyezés lehetőséget.

   

2. A megerősítéshez adja meg a GitHub hitelesítő adatait.

3. Az új kapcsolat megjelenik, a kiválasztott adattárak fel vannak sorolva.

A konfiguráció módosításáról vagy a GitHub Azure Boards alkalmazásának kezelésével kapcsolatban lásd: Az adattár hozzáférésének módosítása Azure Boards.

GitHub-kapcsolat hozzáadása PAT használatával

Important

Fontolja meg a biztonságosabb Microsoft Entra jogkivonatok használatát a magasabb kockázatú személyes hozzáférési jogkivonatokkal szemben. További információ: A PAT használatának csökkentése. Tekintse át a hitelesítési útmutatót , és válassza ki az igényeinek megfelelő hitelesítési mechanizmust.

Tip

A GitHub PAT létrehozásakor vegye fel a következő hatóköröket: repo, read:user, user:email, admin:repo_hook.

1. Válassza a Személyes hozzáférési jogkivonatot az Új kapcsolat párbeszédpanelen.

   

   GitHub PAT létrehozásához nyissa meg a GitHub Fejlesztői beállítások > Személyes hozzáférési jogkivonatokat.

2. Írja be a PAT-t, és válassza a Csatlakozás lehetőséget.

   

3. Válassza ki a csatlakoztatni kívánt adattárakat. További részletekért lásd: GitHub-adattárak hozzáadása.

4. Első alkalommal telepítse a GitHubhoz készült Azure Boards alkalmazást. Lásd : A kapcsolat megerősítése.

Azure DevOps regisztrálása GitHub OAuth-alkalmazásként

Ha az Azure DevOpsot az OAuth használatával szeretné csatlakoztatni a GitHub Enterprise Serverhez, regisztrálja az alkalmazást OAuth-alkalmazásként. További információ: OAuth-alkalmazás létrehozása.

Azure DevOps Services regisztrálása

1. Jelentkezzen be a GitHub Enterprise Server webportálra.

   

2. Nyissa meg a Beállítások>Fejlesztői beállítások>Oauth alkalmazások>Új OAuth alkalmazást.

   

3. Adja meg a regisztrációs adatokat.

   • Kezdőlap URL-címe – A szervezet URL-címe.
   • Engedélyezési visszahívás URL-címe – Használja a mintát {Organization URL}/_admin/oauth2/callback. Például: https://dev.azure.com/fabrikam/_admin/oauth2/callback

   

4. Válassza az Alkalmazás regisztrálása lehetőséget.

5. Másolja ki a regisztrált OAuth-alkalmazáshoz tartozó ügyfélazonosítót és ügyfélkulcsot .

   

OAuth-konfiguráció regisztrálása a Azure DevOps Servicesben

1. Jelentkezzen be az Azure DevOps Services webes portálra.

2. Válassza a Szervezeti beállítások>Oauth-konfigurációk>hozzáadása Oauth-konfigurációk lehetőséget.

   

3. Adja meg az adatait, és válassza a Létrehozás lehetőséget.

   

Azure DevOps-szolgáltatások csatlakoztatása GitHub Vállalati kiszolgálóhoz

Important

A GitHub Enterprise Servernek elérhetőnek kell lennie az internetről. Ellenőrizze, hogy az Azure DNS meg tudja-e oldani a kiszolgáló nevét, és hogy a tűzfal engedélyezi-e a hozzáférést az Azure Data Center IP-tartományaiból. Gyakori hiba a következő:

A távoli név nem oldható fel: "github-enterprise-server.contoso.com"

Ha ezt a hibát látja, ellenőrizze a kiszolgáló akadálymentességét. További információ: Azure DNS GYIK.

1. Válassza Projekt beállításai>GitHub kapcsolatok>GitHub Enterprise Server első kapcsolat esetén.

   

   További kapcsolatok esetén válassza a GitHub Enterprise Servert az Új GitHub kapcsolat párbeszédpanelen.

   Új GitHub kapcsolat párbeszédpanel képernyőképe, ahol válassza a GitHub Enterprise Server lehetőséget.

2. Válassza ki a hitelesítési módot.

   

   Csatlakozás az OAuth szolgáltatással – Válassza ki az OAuth-konfiguráció regisztrálásakor regisztrált OAuth-konfigurációt, majd válassza a Csatlakozás lehetőséget.

   

   Csatlakozás személyes hozzáférési jogkivonattal – Adja meg a GitHub Enterprise Server URL-címét és PAT-címét, majd válassza a Csatlakozás lehetőséget.

   

   Csatlakozás GitHub-hitelesítő adatokkal – Adja meg a GitHub Enterprise Server URL-címét és rendszergazdai hitelesítő adatait, majd válassza a Csatlakozás lehetőséget.

   

3. A párbeszédpanel felsorolja az összes olyan adattárat, ahol rendszergazdai jogosultságokkal rendelkezik. Váltson az Enyém és az Összes között további adattárak kereséséhez, jelölje ki a hozzáadni kívántakat, majd válassza a Mentés lehetőséget.

   

   Tip

   Minden kapcsolat csak egy GitHub-szervezetet támogat. Ha egy másik szervezet adattárait szeretné csatlakoztatni, adjon hozzá egy külön kapcsolatot.

4. Első alkalommal telepítse a GitHubhoz készült Azure Boards alkalmazást. Lásd : A kapcsolat megerősítése.

Kapcsolódási problémák elhárítása

Az Azure Boards–GitHub integráció több hitelesítési protokollt használ a kapcsolat fenntartásához. Az engedélytartományok vagy hitelesítő adatok módosítása leválaszthatja a csatolt GitHub-adattárakat.

Az integráció áttekintéséhez tekintse meg az Azure Boards-GitHub-integrációt.

Támogatott hitelesítési lehetőségek

A következő támogatott hitelesítési lehetőségek attól függenek, hogy melyik GitHub platformhoz csatlakozik:

Platform

GitHub.com

GitHub vállalati kiszolgáló

Azure DevOps Szolgáltatások

• GitHub.com felhasználói fiók
• Személyes hozzáférési jogkivonat (PAT)

• OAuth
• PAT
• GitHub hitelesítő adatok

Azure DevOps Server 2020

Nem alkalmazható

• PAT
• GitHub hitelesítő adatok

Note

GitHub integráció támogatása:

• Azure DevOps Services: GitHub.com és GitHub Enterprise Server-adattárakkal is integrálható a GitHub Azure Boards alkalmazáson keresztül.
• Azure DevOps Server 2020-ra és újabb verziókra: Csak GitHub Enterprise Server-adattárakkal való integrációt támogatja.
• Egyéb Git-adattárak: Az integráció nem támogatott.

Azure Boards szervezeti hozzáférés biztosítása

Ha az integráció nem a várt módon működik, ellenőrizze, hogy engedélyezte-e a szervezeti hozzáférést.

1. A GitHub webportálon nyissa meg a Beállítások lehetőséget a profil menüjében.
   

2. Válassza a Applications lehetőséget a Integrations>Authorized OAuth Apps>Azure Boards területen.

3. A Szervezeti hozzáférés csoportban válassza a hozzáférési kérelem függőben állapotú szervezetek esetében a Támogatás lehetőséget.

   

Hozzáférési problémák megoldása

Ha a GitHubhoz való Azure Boards-kapcsolat elveszíti a hozzáférést, a felhasználói felületen piros X riasztás jelenik meg. Vigye az egérmutatót a riasztás fölé, és győződjön meg arról, hogy a hitelesítő adatok már nem érvényesek. Távolítsa el a kapcsolatot, és hozzon létre egy újat.

• OAuth-kapcsolatok:

  • Az Azure Boards hozzáférése az egyik adattárhoz megtagadva.

  • Előfordulhat, hogy a GitHub vagy az Azure DevOps szolgáltatáskimaradás vagy hálózati probléma miatt nem érhető el. Állapot ellenőrzése: GitHub | Azure DevOps

    Törölje és hozza létre újra a kapcsolatot. A GitHub kéri, hogy újraauthorizálja az Azure Boardst.

• PAT-kapcsolatok:

  • A PAT-t visszavonták, vagy az engedély hatókörei nem elegendőek.

  • Előfordulhat, hogy a felhasználó nem rendelkezik rendszergazdai engedélyekkel a GitHub tárházban.

    Hozza létre újra a PAT-et a szükséges hatókörökkel: repo, read:user, user:email, admin:repo_hook. További információ: PAT-használatának ajánlott eljárásai.

Megszakadt GitHub Enterprise Server-kapcsolat feloldása

Ha az Azure DevOps Serverről egy meglévő GitHub Enterprise Server-kapcsolattal rendelkező Azure DevOps Servicesre migrált, előfordulhat, hogy a GitHubban a munkaelemek említése késik vagy hiányzik, mert a visszahívási URL-cím már nem érvényes.

• Távolítsa el és hozza létre újra a kapcsolatot – Kövesse az Azure DevOps Services és a GitHub Enterprise Server összekapcsolása című témakörben leírt lépéseket.

• A webhook URL-címének javítása – A GitHub-adattár beállításaiban frissítse a webhook URL-címét, hogy az a migrált szervezetre mutasson: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Csatlakozás több Azure DevOps szervezethez

Ha egy GitHub-adattárat több Azure DevOps-szervezet projektjeihez csatlakoztat (például dev.azure.com/Contoso és dev.azure.com/Fabrikam), az váratlan AB# -említési viselkedést okozhat. A munkaelem-azonosítók nem egyediek a szervezetekben, így az AB#12 bármelyik szervezetben megfelelhet egy munkaelemnek. Előfordulhat, hogy mindkét szervezet megpróbálja összekapcsolni a megfelelő azonosítót, ami zavart okoz.

A probléma elkerülése érdekében csatlakoztassa az egyes GitHub-adattárakat csak egy Azure DevOps-szervezethez.

Note

A GitHubhoz készült Azure Boards alkalmazás megakadályozza a több szervezethez való kapcsolódást. Ha egy adattár nem a megfelelő szervezethez van csatlakoztatva, kérje meg a szervezet tulajdonosát, hogy távolítsa el a kapcsolatot, mielőtt hozzáadja a megfelelő szervezethez.

Xml-definíciók frissítése munkaelem-típusok kiválasztásához

Ha a szervezet üzemeltetett XML- vagy helyszíni XML-folyamatmodellt használ, frissítse a munkaelem-típusok XML-definícióit a GitHub-hivatkozástípusok megjelenítéséhez a munkaelem-űrlapok Fejlesztési szakaszában.

Ha például felhasználói történeteket és hibákat szeretne összekapcsolni a GitHub véglegesítési és lekérési kéréseivel a Fejlesztési szakaszból, frissítse a munkaelem-típusok XML-definícióit.

Kövesse az üzemeltetett XML-folyamatmodell lépéseit. Minden munkaelemtípushoz keresse meg a Group Label="Development" szakaszt, és adja hozzá a következő sorokat a GitHub Véglegesítés és a GitHub lekéréses kérelem hivatkozástípusainak támogatásához:

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

A frissítés után a szakasznak a következőképpen kell megjelennie:

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

FAQs

K: Néhány felhasználóm Azure DevOps rendelkezik GitHub identitásokkal. Új GitHub felhasználóként kell hozzáadnom őket a szervezetemhez?

Válasz: Nem. Kérjük a felhasználókat, hogy jelentkezzenek ki, majd újra jelentkezzenek be a szervezetbe a GitHub-hitelesítő adataikkal egy új böngésző munkamenetben.

K: Szervezeti rendszergazda vagyok, és engedélyeztem a házirendet GitHub felhasználók meghívására. Miért nem tudok új GitHub felhasználókat meghívni?

V: Jelentkezzen ki az Azure DevOpsból, és jelentkezzen be újra a szervezetbe (dev.azure.com/{organizationName} vagy organizationName.visualstudio.com) a GitHub hitelesítő adataival egy friss böngésző munkamenetből.

K: Bejelentkeztem a GitHub hitelesítő adataimmal, de miért nem tudom meghívni GitHub felhasználókat?

Válasz: Csak a szervezet vagy a projektgazdák hívhatnak meg új felhasználókat. A rendszergazdával együttműködve kérjen engedélyeket, vagy kérje meg őket a felhasználó hozzáadására.

K: A nagyvállalati GitHub felhasználók ingyenes hozzáférést kapnak a Azure DevOps?

V: További információ: Felhasználók és engedélyek kezelése – gyakori kérdések/GitHub Enterprise.

Következő lépés

A GitHub véglegesítések, lekéréses kérelmek és ágak csatolása munkaelemekre

Kapcsolódó tartalom

• Az Azure Boards alkalmazás telepítése és konfigurálása a GitHub-hoz
• Konfigurációs állapotjelvények hozzáadása GitHub README-fájlokhoz
• GitHub és Azure Boards integráció hibaelhárítása
• GitHub-adattárak építése
• GitHub adattár hozzáférésének módosítása