Megosztás:


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

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Ebben a rövid útmutatóban telepíti 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. 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.

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.

Prerequisites

Category Requirements
Permissions - A Projektgyűjtemény rendszergazdái csoport tagja. Ha létrehozta a projektet, rendelkezik engedélyekkel.
- a GitHub szervezet rendszergazdája vagy tulajdonosa az Azure Boards alkalmazás telepítéséhez.
- A GitHub-adattár engedélyeinek olvasása.
Project-tagság Projektcsapattag.

Important

Ha az adattárhoz már csatlakozott egy másik hitelesítési módszer, például OAuth használatával, el kell távolítania azt a meglévő kapcsolatból, mielőtt újra csatlakoztatná a GitHub-alkalmazás használatával. 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 nem szabad több Azure DevOps-szervezethez csatlakoztatnia.

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

A telepítési sorrend a fiók konfigurációja miatt változhat. Ha szükséges, kövesse a képernyőn megjelenő utasításokat a következő lépések között.

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

  2. A Csomagok és díjszabás csoportban az Ingyenes területen válassza a Telepítés lehetőséget.

  3. Az Azure Boards telepítése és engedélyezése területen válassza ki azokat az adattárakat, amelyekhez csatlakozni szeretne az Azure Boardshoz, majd válassza a Telepítés & Engedélyezés lehetőséget.

    Ez a példa az Összes adattárat használja:

    Képernyőkép a Telepítés és engedélyezés lapról, amelyen az összes tárház ki van jelölve.

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

    Képernyőkép az Azure Boards-projekt beállítási oldalról, ahol kiválaszt egy szervezetet és projektet.

    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.

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

Ha szükséges, hogy a GitHub hozzáférést biztosítson az Azure DevOps-szervezethez, hajtsa végre az alábbi lépéseket.

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

    Képernyőkép a profil Beállítások lehetőségről.

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

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

    Képernyőkép az engedélyezett GitHub-alkalmazásokról az Azure Boards kiemelésével.

  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.

    Képernyőkép a szervezeti hozzáférésről, az olyan szervezetekkel, amelyek nem rendelkeznek hozzáféréssel.

Külső alkalmazás-hozzáférési szabályzat ellenőrzése

Győződjön meg arról, hogy a GitHub-szervezet engedélyezi a külső alkalmazások hozzáférését az Azure Boards alkalmazáshoz. Ha harmadik fél hozzáférése korlátozott, az Azure DevOps adattárainak hozzáadása üres listát jeleníthet meg, vagy hibát okozhat.

A hozzáférés engedélyezése:

  1. A GitHubon nyissa meg a szervezetet, és lépjen a Beállítások > OAuth alkalmazásszabályzatra.

  2. Hagyja jóvá az Azure Boards alkalmazást kifejezetten (ajánlott), vagy távolítsa el az összes külső alkalmazásra vonatkozó korlátozásokat.

    Képernyőkép a külső alkalmazás-hozzáférési szabályzatról.

Megjegyzés:

A beállítás módosításához szervezettulajdonosnak vagy rendszergazdának kell lennie.

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 az Új munkaelem lehetőséget választva adjon meg egy új munkaelemet "Jelvény hozzáadása a README-hez" – Probléma (Alapszintű), Felhasználói történet (Agile) vagy Termékelmaradási elem (Scrum) néven – 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, lépjen a Fejlesztés szakaszra, és válassza a Hivatkozás hozzáadása lehetőséget.

  3. A Hivatkozás típusában válassza a GitHub Pull Request-t.

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

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

    A képernyőkép a Hivatkozás hozzáadása műveletet mutatja a felhasználói történetben, az adattár kiválasztásával, valamint üres mezőkkel a pull request azonosító és az opcionális megjegyzés megadásához.

    A háttérben automatikusan 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-commitot a frissítéshez, amelyet a jelvény README-fájlhoz való hozzáadásával készítettek.
    • 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.
  6. Válassza ki az első lekéréses kérelem hivatkozását a munkaelemből.

    Képernyőkép a GitHubon megnyitott lekéréses kérelemhez tartozó probléma űrlapról.

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

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

    Képernyőkép egy például egy lekérési kérelemről a GitHubon.

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

    Képernyőkép a GitHub adattárról jelvény hozzáadásával.

    További információ: Állapotjelvények hozzáadása a GitHub-adattárhoz.

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ó: Adattárak hozzáadása vagy eltávolítása, illetve kapcsolat eltávolítása az Azure Boardsból.

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. Az Azure DevOpsban található projektből lépjen a Project settings>GitHub-kapcsolatokra.

  2. Adattárak hozzáadásához vagy eltávolításához válassza a kapcsolatnál a További lehetőségek gombot, majd az Adattárak hozzáadása vagy a Adattárak eltávolítása lehetőséget a menüből.

    Képernyőkép a További lehetőségek GitHub-kapcsolat menüjéről.

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

    Képernyőkép a GitHub-kapcsolat eltávolításának megerősítéséről.

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

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

  2. Válassza az Integrációs>alkalmazások lehetőséget. A Telepített GitHub-alkalmazások területen válassza a Konfigurálás lehetőséget.

    Képernyőkép a Telepített GitHub-alkalmazásokról az Azure Boards használatával és a Konfigurálás lehetőséggel.

    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, minden adattár vagy csak a kiválasztott adattárak közül.

    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.

    Képernyőkép az Adattár hozzáférésről, ahol kiválaszthatja a kiválasztott adattárakat.

  5. Válassza az Mentésgombot.

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.

    Képernyőkép a Veszélyzóna szakaszról, a felfüggesztési és eltávolítási lehetőségekkel.

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

    Képernyőkép a felfüggesztés megerősítését kérő párbeszédpanelről.

    Az integráció felfüggesztésének megszüntetéséhez válassza a Felfüggesztés megszüntetése 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 .

    Képernyőkép az eltávolítás megerősítését kérő párbeszédpanelről.

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 vagy eltávolítása.

Képernyőkép az eltávolított Azure Boards GitHub-alkalmazásról.

Következő lépések