Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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.
Használja a AB# hivatkozást a GitHubról az Azure Boards munkaelemeire
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.
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:
A táblában keresse meg azt a munkaelemet, amelyből GitHub-ágat szeretne létrehozni.
Válassza a
Munkaelem-műveletek>Új GitHub-ág lehetőséget.
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.
Válassza a Create gombot.
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ó.
Munkaelem-hivatkozás hozzáadása GitHub ágakhoz, elkötelezésekhez vagy pull requestekhez.
Nyissa meg a munkaelemet, és lépjen a Hivatkozások lapra.
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á.
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.
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 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. |
Hivatkozások megtekintése vagy megnyitása a Fejlesztés szakaszbó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.
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.