GitHub commit-ek, pull kérések, ágak és hibák összekapcsolása az Azure Boards elemekkel.

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

Ebből a cikkből megtudhatja, hogyan csatolhat munkaelemeket GitHub véglegesítésekhez, lekéréses kérelmekhez, ágakhoz és buildekhez, miután csatlakoztatta a Azure Boards projektet egy GitHub-adattárhoz. Használhatja a #mention szintaxist a véglegesítésekhez és az ágakhoz, ! említésekkel hivatkozhat GitHub lekéréses kérelmekre a munkaelem-vitafórumokból, vagy hozzáadhat egy GitHub véglegesítési, lekéréses kérelmet vagy ághivatkozást közvetlenül a Azure Boards munkaelemből.

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.

Prerequisites

Category	Requirements
Jogosultságok	Contributor a Azure Boards projekthez és a GitHub adattárhoz.
Projektkapcsolat	Azure Boards projekt ahhoz a GitHub adattárhoz van csatlakoztatva, ahol megtalálhatók azok a commitok, lekéréses kérelmek és ágak, amelyeket összekapcsolni szeretne. További információ: Azure Boards-GitHub integráció.

Note

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

A AB# használatával hivatkozhat GitHub és Azure Boards munkaelemek között

Egy GitHub véglegesítés, lekéréses kérelem vagy probléma esetén az alábbi szintaxissal hozhat létre hivatkozást a Azure Boards munkaelemre. Í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álja egy munkafolyamat-kategóriához illeszteni, 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 hivatkozott munkaelemek az első, a Resolved kategóriával társított állapotba kerülnek. 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 Azure Boards hátralékokban és táblákban.

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	Hivatkozások az Azure Boards 123-as, 124-es és 126-os munkatárgyaira. 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	Hivatkozások az Azure Boards munkatárgyaira: 123-ra, 124-re és 126-ra. 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 probléma 123 és az Azure Boards 234-es munkaelemre mutató hivatkozások. Nincsenek átmenetek.

Note

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

Amikor AB# használatával egy munkaelemre mutató hivatkozást ad hozzá egy lekéréses kérelem leírásában, ezek a hivatkozások megjelennek a GitHub lekéréses kérelem Development szakaszában. Ezek a hivatkozások csak akkor érhetők el, ha a lekéréses kérelem leírásában használja AB# . Nem jelennek meg, ha közvetlenül a munkaelemből hivatkozik a lekéréses kérelemre. Ha eltávolítja a hivatkozást a AB# leírásból, azt is eltávolítja a Fejlesztés szakaszból.

GitHub ág létrehozása munkaelemből

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

1. A táblában keresse meg a GitHub ág létrehozásához használni kívánt munkaelemet.

2. Válassza a Munkaelem-műveletek>Új GitHub ág.

   

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

4. Válassza a Create gombot.

   

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

Munkaelem-hivatkozás hozzáadása GitHub ághoz, véglegesítéshez vagy lekéréses kérelemhez

1. Nyissa meg a munkaelemet, és lépjen a Fejlesztési területre.

2. Válassza a Hivatkozás hozzáadása lehetőséget. Az egyes legördülő menükben válassza ki a link típusát, GitHub adattárat és GitHub lekéréses kérelmet. Az adattárban kereshet és részletezhet egy adott lekéréses kérelmet vagy véglegesítést anélkül, hogy url-címet kellene másolnia és beillesztenie.

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

   

   Azure Boards ellenőrzi, hogy érvényes hivatkozást adott-e meg. A csatolt GitHub adattár must csatlakoztatható a Azure Boards projekthez vagy sikertelen az ellenőrzés.

Automatikus hivatkozásfrissítések

Számos esemény automatikusan frissíti a munkahelyi eleműrlap hivatkozásait, így nem kell manuálisan létrehoznia őket. Ezek az események 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 munkaelemre mutat.
Véglegesítés egyesítése	A lekéréses kérelem egyesítése után az eredményül kapott egyesítési véglegesítés automatikusan a munkaelemre hivatkozik.
Á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.

Hivatkozások megtekintése vagy megnyitása a Fejlesztés szakaszból

A munkaeleműrlap Fejlesztési szakasza felsorolja a GitHub véglegesítésre és lekéréses kérelmekre létrehozott hivatkozásokat a GitHub ikonnal.

A hivatkozásra kattintva nyissa meg a véglegesítési vagy lekéréses kérelmet a GitHub.

GitHub lekéréses kérelmek elemzési adatai

A csatolt GitHub lekéréses kérelmek a Fejlesztési szakaszban további állapotadatokat mutatnak, így anélkül értékelheti az előrehaladást, hogy megnyitná a lekéréses kérelmet GitHub.

A lekéréses kérelmek elemzésének előfeltételei

A lekéréses kérelmek elemzéseinek megtekintéséhez nyissa meg a Azure Boards alkalmazást a GitHub és fogadja el a csekkekhez való olvasási és írási hozzáférés frissített engedélyeit.

Az Azure Boards GitHub alkalmazás jogosultsági párbeszédablakának képernyőképe, amely a frissített ellenőrzési jogosultságokat mutatja.

Lekéréses kérelem állapotának részleteinek megtekintése

1. Nyisson meg egy csatolt GitHub lekéréses kérelmet tartalmazó munkaelemet.

2. A Fejlesztés szakaszban keresse meg a csatolt lekéréses kérelmet. A lekéréses kérelem hivatkozása mellett az alábbi állapotadatok jelennek meg:

   • Piszkozat állapota: Azt jelzi, hogy a pull request még mindig piszkozat.
   • Áttekintés állapota: Azt mutatja, hogy a lekéréses kérelemnek felülvizsgálatra van-e szüksége, jóvá lett-e hagyva, vagy módosításokat kért.
   • Ellenőrzések állapota: Azt jelzi, hogy a CI-ellenőrzések áthaladnak-e, sikertelenek vagy függőben vannak-e.

   

3. Vigye az egérmutatót a státuszjelző fölé a további részletek megtekintéséhez, vagy válassza a lekéréses kérelem hivatkozását közvetlenül a GitHubon.

GitHub lekéréses kérelmek említése a ! használatával

A ! említésekkel hivatkozhat és tárgyalhatja GitHub lekéréses kérelmeket közvetlenül bármely munkaelem rich-text mezőjéből vagy vitafórum-megjegyzéséből. Amikor beírja a ! szöveget egy szövegmezőbe, megjelenik egy választó, amellyel megkereshet és kiválaszthat egy GitHub lekéréses kérelmet egy csatlakoztatott adattárból. A kijelölt lekéréses kérelem kattintható hivatkozásként lesz beszúrva.

Ez a funkció megkönnyíti a kapcsolódó lekéréses kérelmek hivatkozását a munkaelem-leírásokban, az elfogadási feltételekben vagy a vitafórum-szálakban az URL-címek manuális másolása nélkül.

Gif, amely bemutatja, hogyan használható az ! említés egy GitHub lekéréses kérelem hivatkozására egy munkaelem vitájából.

YAML-folyamatok buildállapotának megtekintése (buildbe integrált)

Ha Azure Pipelines YAML-et használ egy GitHub-adattárban üzemeltetett kód létrehozásához, automatikusan létrehozhat a buildben kapcsolódó munkaelemekre mutató hivatkozásokat. Ez a jellemző buildkövethetőséget biztosít GitHub adattárakhoz, elérve az Azure Repos-nál elérhető élménnyel való megfelelést.

A funkció engedélyezése:

1. Nyissa meg a YAML-folyamatot, válassza a További műveletek, majd a Beállítások lehetőséget.

2. A Folyamat beállításai párbeszédpanelen engedélyezze az új munkaelemek automatikus csatolását ebben a buildben.

   

Amikor a build befejeződik, az egyes társított munkaelemek fejlesztési szakaszában automatikusan megjelenik egy Beépített a buildbe hivatkozás, ezáltal a csapat teljes körű nyomon követhetőséget érhet el a munkaelemtől a buildig.

A beállítás konfigurálásával kapcsolatos további információkért lásd: Folyamatok konfigurálása a munkakövetés támogatásához.

GitHub objektumok megtekintése a táblán

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

Következő lépések

Állapotjelvények konfigurálása

Kapcsolódó tartalom

• Integrate Azure Boards with GitHub
• Folyamatok konfigurálása a munkakövetés támogatásához
• Értse meg, hogyan használhatók a munkafolyamat-kategóriaállapotok az Azure Boards hátralékokban és táblákban
• Munkaelemek csatolása objektumokhoz
• GitHub és Azure Boards integráció hibakeresése