Az Azure Boards alkalmazás telepítése a GitHubhoz

  • Cikk

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

Telepítse a GitHubhoz készült Azure Boards alkalmazást az Azure Boards gitHub-adattárakhoz való csatlakoztatásához. Amikor Azure Boards-projekteket csatlakoztat GitHub.com adattárakhoz, támogatja a GitHub-véglegesítések és a lekéréses kérelmek munkahelyi elemekhez való csatolását. A GitHubot szoftverfejlesztésre használhatja, miközben az Azure Boards használatával megtervezheti és nyomon követheti a munkáját.

A GitHubhoz készült Azure Boards alkalmazás által támogatott integráció áttekintéséért tekintse meg az Azure Boards-GitHub-integrációt. Miután telepítette a GitHubhoz készült Azure Boards alkalmazást a GitHub-fiókjára vagy szervezetére, válassza ki, hogy mely GitHub-adattárakhoz szeretne csatlakozni a projektből.

Előfeltételek

  • Az Azure Boards alkalmazás telepítéséhez a GitHub-szervezet rendszergazdájának vagy tulajdonosának kell lennie.
  • Az Azure Boards-projekthez való csatlakozáshoz olvasási engedélyekkel kell rendelkeznie a GitHub-adattárhoz. Emellett a Project Collection Rendszergazda istrators csoport tagjának kell lennie. Ha létrehozta a projektet, akkor rendelkezik engedélyekkel.

Fontos

Ha az adattár már csatlakozik egy másik hitelesítési típuson, például az OAuthon keresztül, el kell távolítania ezt az adattárat a meglévő kapcsolatból, mielőtt újra csatlakoztatja a GitHub-alkalmazáson keresztül. A GitHub-alkalmazás konfigurálása előtt kövesse a Jelen cikk későbbi részében szereplő GitHub-adattárak hozzáadásának vagy eltávolításának lépéseit.

Egy Azure DevOps-szervezetet több GitHub-adattárhoz is csatlakoztathat, ha Ön az adattárak rendszergazdája. Egy GitHub-adattárat azonban nem szabad több Azure DevOps-szervezethez csatlakoztatnia.

Azure Boards-szervezet hozzáférésének biztosítása

A szervezeti hozzáférés biztosításához hajtsa végre az alábbi lépéseket.

  1. A GitHub webportálon nyissa meg a Gépház a profil menüjéből.

    Screenshot of open profile, choose Settings.

  2. Válassza az Alkalmazások lehetőséget az Integrációk területen.

  3. Válassza az Engedélyezett OAuth Apps>Azure Boards lehetőséget.

    Screenshot of Authorized OAuth Apps tab, choose Azure Boards.

  4. A Szervezeti hozzáférés csoportban oldja meg az esetlegesen megjelenő problémákat. Válassza a Grant lehetőséget, ha hozzáférést szeretne adni minden olyan szervezetnek, amely függőben lévő hozzáférési kérelemként jelenik meg.

    Screenshot of Organization access with organizations without access.

Az Azure Boards alkalmazás telepítése és konfigurálása

  1. Nyissa meg az Azure Boards alkalmazást a GitHub Marketplace-en.

  2. Válassza a Csomag beállítása lehetőséget.

    Screenshot of GitHub Marketplace, Set up a plan button.

  3. Válassza ki az Azure Boardshoz csatlakozni kívánt GitHub-szervezetet.

    Screenshot showing Install Azure Boards dialog.

  4. Válassza ki azokat az adattárakat, amelyekhez csatlakozni szeretne az Azure Boardshoz.

    Az alábbi példában úgy döntünk, hogy az összes adattárhoz csatlakozunk.

    Screenshot showing all repositories selected.

  5. Válassza ki azt az Azure DevOps-szervezetet és Azure Boards-projektet, amelyhez csatlakozni szeretne GitHub.com.

    Screenshot of setting up connection dialog.

    Egyszerre csak egy projektet csatlakoztathat. Ha más projektekhez is csatlakozni szeretne, ezt később is megteheti a jelen cikk későbbi, Más projektek vagy adattárak konfigurálása című szakaszában leírtak szerint.

  6. Engedélyezze az Azure Boards-szervezetnek, hogy csatlakozzon GitHub.com.

    Screenshot of Azure Boards authorization dialog.

  7. Erősítse meg a csatlakoztatni kívánt GitHub.com adattárakat. Jelölje ki azokat az adattárakat, amelyhez csatlakozni szeretne. Törölje az összes olyan adattár kijelölését, amelyet nem szeretne részt venni az integrációban.

    Screenshot of Confirm your GitHub repositories dialog.

A kapcsolat használata

Ezen a ponton az Azure Boards-GitHub integrációja befejeződött. Kihagyhatja a következő lépéseket, vagy végighaladhat rajtuk a kapcsolat által támogatott funkciók megismeréséhez.

  1. A táblán válassza az Új elemet a "Jelvény hozzáadása a README-hez" – Probléma (alapszintű), felhasználói történet (Agile) vagy Termékhátrációs elem (Scrum) – az Azure Boards-projekt által használt folyamatmodelltől függően.

    Megjelenik a táblán egy jelvény hozzáadása a README-hez című munkaelem.

  2. Nyissa meg a munkaelemet, és válassza a lekéréses kérelmet a Hivatkozás hozzáadása területen.

  3. Válassza ki az adattárat, és adja meg a lekéréses kérelem azonosítóját és egy nem kötelező megjegyzést.

  4. Válassza a Hivatkozás hozzáadása lehetőséget.

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

    A háttérben a következő műveletek történnek.

    • Jelvényt ad hozzá az első adattár README-fájljához a csatlakoztatott GitHub-adattárak listájában.
    • Létrehoz egy GitHub-véglegesítést a frissítéshez úgy, hogy hozzáadja a jelvényt a README-fájlhoz.
    • Létrehoz egy GitHub-lekéréses kérelmet a README-fájl módosításainak egyesítése érdekében.
    • Csatolja a GitHub véglegesítési és lekéréses kérését az 1. lépésben létrehozott munkaelemhez.

  5. Válassza ki az első lekéréses kérelem hivatkozását a munkaelemből.

    Screenshot of issue form for pull request opened in GitHub.

    A GitHub lekéréses kérése megnyílik egy új böngészőlapon.

  6. Válassza a Lekéréses kérelem egyesítése lehetőséget.

    Screenshot of example pull request in GitHub.

  7. Nyissa meg az adattár README-fájlját, és tekintse meg a hozzáadott jelvényt.

    Screenshot of GitHub repo with badge added.

    További információ: Állapotjelvények konfigurálása GitHub README-fájlokhoz való hozzáadásához.

Egyéb projektek vagy adattárak konfigurálása

Konfigurálhat más Azure Boards-/Azure DevOps-projekteket, GitHub.com-adattárakat, vagy módosíthatja az aktuális konfigurációt az Azure Boards alkalmazás oldaláról. További információ: A GitHub-adattár hozzáférésének módosítása, illetve az integráció felfüggesztése vagy eltávolítása.

Adattárak hozzáadása vagy eltávolítása, illetve kapcsolat eltávolítása az Azure Boardsból

Ha problémát tapasztal egy kapcsolattal kapcsolatban, javasoljuk, hogy távolítsa el a kapcsolatot, és kezdje újra egy új kapcsolattal.

  1. Adattárak hozzáadásához vagy eltávolításához válassza a Kapcsolat További beállításai lehetőséget , majd válassza az Adattárak hozzáadása vagy Az adattárak eltávolítása lehetőséget a menüből.

    Screenshot of GitHub connection menu of More options.

  2. Az összes adattár és a kapcsolat eltávolításához válassza a Kapcsolat eltávolítása lehetőséget. Ezután válassza az Eltávolítás lehetőséget a megerősítéshez.

    Screenshot of confirmation removal of GitHub connection.

  1. Adattárak hozzáadásához vagy eltávolításához nyissa meg a kapcsolat műveletikonát, és válassza az Adattárak hozzáadása vagy Az adattárak eltávolítása lehetőséget a menüből.

    Screenshot of add or remove GitHub repos.

  2. Az összes adattár és a kapcsolat eltávolításához válassza a Kapcsolat eltávolítása lehetőséget. Ezután válassza az Eltávolítás lehetőséget a megerősítéshez.

    Screenshot of confirmation of GitHub connection removal dialog.

Tárház hozzáférésének módosítása

  1. Jelentkezzen be a GitHub-szervezet webes portáljára, és nyissa meg a fiókbeállításokat.

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

  2. Válassza a Telepített GitHub Apps lehetőséget , majd konfigurálja az Azure Boards mellett.
    Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.

    Megnyílik az Azure Boards konfigurációs oldala.

  3. Görgessen le az Adattár hozzáférési szakaszához.

  4. Válassza ki a kívánt beállítást, az Összes tárház vagy a Csak az adattárak lehetőséget.

    Ha a Csak az adattárak lehetőséget választja, válassza ki azokat az adattárakat, amelyeket az Azure Boardssal való integrációban szeretne részt venni.

    Screenshot of Repository access, choose Only select repositories.

  5. Ha elkészült, válassza a Mentés lehetőséget.

Az Azure Boards-integráció felfüggesztése vagy eltávolítása

  1. Az előző eljárás 2. lépésétől kezdve görgessen le a Veszélyzóna szakaszig.

    Screenshot of Azure Boards configuration, Danger zone section.

  2. Az integráció felfüggesztéséhez válassza a Felfüggesztés lehetőséget. Az előugró ablakban válassza az OK gombot a felfüggesztés megerősítéséhez.

    Screenshot of suspension confirmation.

    Az integráció nem megfelelő használatához válassza az Unsuspend lehetőséget.

  3. Az Azure Boards alkalmazás eltávolításához válassza az Eltávolítás lehetőséget, majd az előugró ablakban válassza az OK gombot .

    Screenshot of uninstall confirmation.

Azure Boards-GitHub-kapcsolatok frissítése

Ha módosítja azOkat az adattárakat, amelyeket a GitHubhoz készült Azure Boards alkalmazás támogat, átirányíthatja az Azure Boards GitHub-kapcsolatokra. Ajánlott eltávolítani azokat az Azure Boards-adattárakat, amelyek már nem tudnak csatlakozni a GitHubhoz. További információ: GitHub-adattárak hozzáadása vagy eltávolítása.

Ha eltávolítja a GitHubhoz készült Azure Boards alkalmazást, a következő üzenet jelenik meg az Azure Boardsban, a Project beállításai>GitHub-kapcsolatokban. Válassza a Kapcsolat eltávolítása lehetőséget az összes korábban létrehozott GitHub-kapcsolat eltávolításához. További információ: GitHub-adattárak hozzáadása/eltávolítása.

Screenshot of uninstalled Azure Boards GitHub app.

Következő lépések

GitHub-véglegesítések és lekéréses kérelmek csatolása munkaelemekhez