Megosztás a következőn keresztül:


GitHub-commitek, pull kérelmek, ágak és feladatok összekapcsolása az Azure Boards munkaelemeivel

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

Ebből a cikkből megtudhatja, hogyan csatolhat munkaelemeket GitHub-véglegesítésekhez, lekéréses kérelmekhez és ágakhoz az Azure Boards-projekt GitHub-adattárral való összekapcsolása után. Használhatja a #mention szintaxist a véglegesítésekhez és ágakhoz, vagy felvehet egy GitHub-véglegesítést, lekéréses kérelmet vagy ághivatkozást közvetlenül az Azure Boards munkaeleméből.

Note

GitHub-integráció támogatása:

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

Prerequisites

Category Requirements
Permissions Közreműködő az Azure Boards-projektben és a GitHub-adattárban is.
Projektkapcsolat Az Azure Boards-projekt csatlakoztatva van a GitHub-adattárhoz, ahol a véglegesítések, pull-kérelmek és azok az ágak találhatók, amelyekhez vagy amelyekből kapcsolódni szeretne. További információ: Azure Boards-GitHub integráció.

Note

Az üzemeltetett XML-folyamatmodellt használó projekteknek frissítenie kell a munkaelem-típusokat a Fejlesztési szakasz és a GitHub-hivatkozástípusok megtekintéséhez. További információ: Xml-definíciók frissítése a munkaelemtípusok kiválasztásához.

GitHub-commitből, pull requestből vagy problémából az alábbi szintaxissal hozhat létre hivatkozást az Azure Boards munkatételre. Írja be a AB#ID véglegesítési üzenet szövegét. Lekéréses kérelem vagy probléma esetén pedig írja be a AB#ID-t a leírásba. Megjegyzés vagy lekéréses kérelem címének használata AB#ID nem hoz létre hivatkozást a munkaelemen.

AB#{ID}

Például a AB#125 125-ös munkaelem-azonosítóra mutató hivatkozások.

Megadhat kötelezettségvállalási üzenetet vagy húzási kérelem üzenetet a munkaelem állapotának változtatásához. A rendszer felismeri {state} vagy {state category}, továbbá fix, fixes, fixed, és alkalmazza a következő #említési elemre.

Ha például egy lekéréses kérelem leírása érvényes állapotnevet tartalmaz, Closed AB#1234a rendszer frissíti a hivatkozott munkaelemet az adott állapotra. Ha az állapot neve nem ismerhető fel közvetlenül, az Azure Boards megpróbál megegyezni egy munkafolyamat-kategóriával, például Resolved vagy Completed. Ha talál egyezést, a munkaelem átáll az adott kategória alatt definiált első elérhető állapotra.

Alapértelmezés szerint a `fix`, `fixes` vagy `fixed` hivatkozásokkal rendelkező munkaelemek átállnak a Feloldott kategóriához társított első állapotra. Ha az aktuális folyamatban nincs ilyen állapot, a rendszer ehelyett a munkaelemet a Kész kategória első állapotára helyezi át.

Important

Továbbra is összekapcsolhatja a munkaelemeket, és célba veheti a többi ágat, de az állapotátmeneti szabályok csak akkor érvényesek, ha a lekéréses kérelem az alapértelmezett ágba kerül egyesítésre.

További információ: A munkafolyamat-kategóriaállapotok használata az Azure Boards hátralékaiban és tábláiban.

Tekintse át a következő példatáblát:

Véglegesítési vagy pull request üzenet Action
Fixed AB#123 A munkaelem csatolása és átállítása a Megoldott munkafolyamat-állapotkategóriára, vagy ha nincs ilyen, akkor a Kész munkafolyamat-állapotkategóriára.
Closed AB#123 A munkaelemet átirányítja és átállítja a lezárt állapotba. Ha nincs definiálva, a rendszer nem végez áttűnéseket.
Adds a new feature, fixes AB#123. A munkaelem csatolása és átállítása a Megoldott munkafolyamat-állapotkategóriára, vagy ha nincs ilyen, akkor a Kész munkafolyamat-állapotkategóriára.
Fixes AB#123, AB#124, and AB#126 Az Azure Boards munkafeladatok 123, 124 és 126 hivatkozásai. Az első elemet, a 123-at átteszi az Megoldott munkafolyamat állapot kategóriába, vagy ha nincs definiálva, akkor a Kész munkafolyamat állapot kategóriába.
Fixes AB#123, Fixes AB#124, Fixes AB#125 Az Azure Boards munkafeladatok 123, 124 és 126 hivatkozásai. Az összes elemet áthelyezi a Feloldott munkafolyamat állapota kategóriára, vagy ha nincs ilyen meghatározva, akkor a Kész munkafolyamat állapota kategóriára.
Fixing multiple bugs: issue #123 and user story AB#234 A GitHub 123. számú hibájára és az Azure Boards 234. számú munkaelemére mutató hivatkozások. Nincsenek átmenetek.

Note

Ha ugyanazt a GitHub-adattárat két vagy több Azure DevOps-szervezetben meghatározott projektekhez kapcsolta, előfordulhat, hogy váratlan AB# -említés csatolása jelenik meg. További információ: Kapcsolati problémák megoldása. Ezért azt javasoljuk, hogy csak egyetlen Azure DevOps-szervezetben meghatározott projektekhez csatlakoztassa a GitHub-adattárat.

Amikor egy munkaelemre mutató hivatkozást ad hozzá az AB# használatával, ezek a hivatkozások megjelennek a lekéréses kérelem Fejlesztési szakaszában.

Képernyőkép a GitHub lekéréses kérelem fejlesztési szakaszában található AB#-hivatkozásokról.

GitHub-ág létrehozása munkaelemből

Ha közvetlenül egy munkaelemből szeretne GitHub-ágat létrehozni, hajtsa végre az alábbi lépéseket:

  1. A táblában keresse meg azt a munkaelemet, amelyből GitHub-ágat szeretne létrehozni.

  2. Válassza a Munkaelem-műveletek>Új GitHub-ág lehetőséget.

    Képernyőkép egy munkaelem

  3. A GitHub-ág létrehozása párbeszédpanelen adja meg az ág nevét, majd válassza ki a GitHub-adattárat és az alapágat.

  4. Válassza a Create gombot.

    Képernyőkép a GitHub-ág létrehozása párbeszédpanelről.

    Az Azure Boards létrehozza az ágat a megadott GitHub-adattárban, és a munkaelemhez csatolja. További információ: Azure Boards-GitHub integráció.

  1. Nyissa meg a munkaelemet, és lépjen a Hivatkozások lapra.

    Képernyőkép a munkaelem űrlapról, a Hivatkozások lapról, a Probléma hivatkozásának hozzáadása lapról.

  2. A Hivatkozás hozzáadása párbeszédpanelen válassza ki az egyik GitHub-hivatkozástípust , válasszon egy GitHub-adattárat, írja be a GitHub-ág URL-címét, véglegesítse vagy lekérje a kérelmet, majd válassza a Hivatkozás hozzáadása lehetőséget.

    Az alábbi példában egy GitHub-lekéréses kérelemre mutató hivatkozást adunk hozzá.

    Képernyőkép a munkaelem űrlapról, a Hivatkozások lapról, a Hivatkozás hozzáadása párbeszédpanelről, a GitHub lekéréses kérelem hivatkozástípusának kiválasztásáról.

    Az Azure Boards egy ellenőrzést végez annak ellenőrzéséhez, hogy érvényes hivatkozást adott-e meg. A csatolt GitHub-adattárnak csatlakoznia kell az Azure Boards-projekthez , vagy az érvényesítés sikertelen.

Note

Ha az Azure DevOps Servert és a GitHub Enterprise Servert használja, az AB#-hivatkozások végrehajtása késik. Van egy 'push-and-pull' kialakításunk, amely óránként lekéri a GitHub eseményeket a Commit-ek, PR-ek (pull requestek) és Issue-k (problémák) növekményes változásairól.

Számos esemény automatikusan frissíti a munkahelyi eleműrlap hivatkozásait, így nem kell manuálisan létrehoznia őket. Ezek a következők:

GitHub-esemény Action
Csatolás az ághoz Amikor egy lekéréses kérelem egy ágból jön létre, az automatikusan a munkaelemhez lesz csatolva.
Véglegesítés egyesítése A lekéréses kérelem egyesítése után a rendszer automatikusan csatolja az eredményül kapott egyesítési véglegesítést a munkaelemhez.
Ág törlése Ha az ág törlődik (általában az egyesítés után), a rendszer automatikusan eltávolítja a hivatkozást a munkaelemből.

A munkaelem-űrlap Fejlesztési szakasza a GitHub ikon mellett a GitHub commit-ekhez és pull kéréshez létrehozott hivatkozásokat sorolja fel.

Képernyőkép a munkaelem űrlapról, a Fejlesztés szakaszban a GitHub-hivatkozások láthatók.

Válassza ki a megadott hivatkozást a véglegesítési vagy lekéréses kérelem GitHubon való megnyitásához.

GitHub-objektumok megtekintése egy táblán

Ha engedélyezve vannak a GitHub-széljegyzetek a táblán, a további részletekért gyorsan megnyithatja a csatolt GitHub-véglegesítéseket, lekéréses kérelmeket vagy problémákat. A további információkért lásd: Kártyák testreszabása.

Képernyőkép a gitHub-hivatkozások munkahelyi elemkártyákon való ábrázolásáról.

Következő lépések