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 Szolgáltatások | Azure DevOps Server | Azure DevOps Server 2022
Visual Studio 2019 | Visual Studio 2022
Jótanács
AI segítségével támogathatja az Azure DevOps feladatokat. Az első lépésekhez tekintse meg az Azure DevOps MCP Serverrel kapcsolatos AI-segítség engedélyezése című témakört.
Lekéréses kérelmek létrehozása a kód módosításához, áttekintéséhez és egyesítéséhez egy Git-adattárban. A PR-ket az upstream adattárban lévő ágakból vagy az adattár forkjában lévő ágakból hozhatja létre. A csapat áttekintheti a PRs-, és visszajelzést küldhet a változásokról. A véleményezők végiglépkedhetnek a javasolt módosításokon, megjegyzéseket hagyhatnak, és szavazhatnak a kérelemkérések jóváhagyására vagy elutasítására. Az ágszabályzatoktól és egyéb követelményektől függően előfordulhat, hogy a PR-nek különböző feltételeknek kell megfelelnie ahhoz, hogy befejezhesse a PR-t, és egyesítse a módosításokat a célágba.
A biztonsági eljárásokkal, például a fiókszabályzatokkal, az adattár hozzáférés-vezérlésével és a véglegesítési ellenőrzéssel kapcsolatos átfogó útmutatásért lásd: Biztonságos adattárak és lekéréses kérelmek.
A PR-irányelvekről és a menedzsment megfontolásokról a A lekéréses kérelmekrőlcímű részen olvashat.
Előfeltételek
| Kategória | Követelmények |
|---|---|
| hozzáférési szintek | - PR-k megtekintése vagy átnézése: Legalább alapszintű hozzáférés. Nyilvános projektek esetén a felhasználók teljes hozzáféréssel rendelkeznek az Azure-adattárakhoz , amennyiben ők az érdekelt felek. |
| Jogosultságok | - Közreműködés egy PR-ben: A Olvasók biztonsági csoport tagja vagy a megfelelő engedélyek. – Pr létrehozása és befejezése: A közreműködői biztonsági csoport tagja vagy a megfelelő engedélyek. |
| Szolgáltatások | Repók engedélyezve. |
| Eszközök | Azure DevOps parancssori felület. |
| Kategória | Követelmények |
|---|---|
| hozzáférési szintek | - PR-k megtekintése vagy átnézése: Legalább alapszintű hozzáférés. |
| Jogosultságok | - Közreműködés egy PR-ben: A Olvasók biztonsági csoport tagja vagy a megfelelő engedélyek. – Pr létrehozása és befejezése: A közreműködői biztonsági csoport tagja vagy a megfelelő engedélyek. |
| Szolgáltatások | Repók engedélyezve. |
További információ az engedélyekről és a hozzáférésről: Alapértelmezett Git-adattár és ágengedélyek és A hozzáférési szintek.
Lekéréses kérelem létrehozása
Létrehozhat egy új lekéréses kérelmet az Azure DevOps-projekt webhelyéről, a Visual Studióból, az Azure DevOps CLI-ből, vagy közvetlenül a Git parancssorából, miután leküldte az ágat. Amikor egy új ágat küld le Azure Repos (Azure DevOps Szolgáltatások) felé, a git push kimenet tartalmazhat egy közvetlen URL-címet egy lekéréses kérelem létrehozásához.
Az Azure DevOps projektwebhelyről létrehozhat egy új pr-t a következőkből:
- Lekéréses kérelmek lap.
- Funkcióág feltöltve az adattárba.
- Egy meglévő PR-t használva cherry-pick.
- Az Azure Boards-munkaelem csatolt fejlesztési vezérlője.
Hozz létre egy PR-t a Pull requestek oldalról
A projekt lekéréses kérelmek lapjáról bármilyen ághoz létrehozhat PRs-eket.
Az Adattárak>Lekéréses kérelmek oldalon válassza az Új lekéréses kérelem gombot a jobb felső sarokban.
Válassza ki a módosításokat tartalmazó ágat és azt az ágat, amelybe egyesíteni szeretné a módosításokat, például a főágat.
Adja meg a pr-adatokat, és hozza létre a pr-t.
Nyomott ágból PR létrehozása
Funkcióág feltöltése vagy frissítése után az Azure Repos megjelenít egy promptot a Pull Request létrehozására.
A Lekéréses kérelmek lapon:
A Fájlok oldalon:
Válassza a Pull Request létrehozása elemet, hogy egy olyan oldalra lépjen, ahol megadhatja a pull request részleteit, és létrehozhatja a PR-t.
Jegyzet
Ez a funkció csak Azure DevOps Szolgáltatásokban érhető el. Azure DevOps Server nem jeleníti meg a lekéréses kérelem URL-címét leküldéses kimenetben.
PR létrehozása csatolt munkaelemből
Közvetlenül egy ághoz kapcsolódó Azure Boards-munkaelemből is létrehozhat pull-kérelmet.
Az Azure Boards alkalmazásban a Munka nézetben a Hátralékok vagy a Lekérdezések részben nyisson meg egy, az ághoz társított munkaelemet.
A munkaelem Fejlesztési területén válassza a Lekéréses kérelem létrehozásalehetőséget.
A hivatkozás egy oldalra viszi, ahol megadhatja a pr-adatokat, és létrehozhatja a pr-t.
Frissítések hozzáadása cherry-pick használatával
Az egyik ágból a másikba commit-eket másolhat a cherry-pick használatával. Az egyesítéssel vagy újrabase-eléssel ellentétben a cherry-pick csak a kiválasztott commitok módosításait hozza el, nem az ág összes változását.
A lezárt PR módosításainak kiválasztásához válassza ki a Cherry-pick lehetőséget a PR Áttekintés lapján. Az aktív lekéréses kérelem módosításainak másolásához válassza a Cherry-pick elemet a PR További lehetőségek menüjéből. Ez a művelet létrehoz egy új ágat a másolt módosításokkal. Ezután létrehozhat egy új pull requestet az új ágból. Részletes útmutatásért lásd a Változtatások átmásolása cherry-pickkel oldalt.
A lekéréses kérelem forrás- és célágainak váltása
A PR első mentése előtt, az ágnevek melletti Forrás és célágak váltása ikont kiválasztva, válthat a PR forrás- és célágai között. Amint a PR aktív, ez az ikon eltűnik, de továbbra is módosíthatja a pull request célágát.
Lekéréses kérelemsablonok használata
A lekéréses kérelmek sablonja egy Markdown-szöveget tartalmazó fájl, amely kitölti a lekéréses kérelem leírását a lekéréses kérelem létrehozásakor. A jó PR-leírások közlik a pr-véleményezőkkel, hogy mire számíthatnak, és segíthetnek nyomon követni az olyan feladatokat, mint az egységtesztek hozzáadása és a dokumentáció frissítése. A csapat létrehozhat egy alapértelmezett PR-sablont, amely szöveget ad hozzá az adattár összes új pr-leírásához. Emellett választhat az ágspecifikus sablonok vagy a csapat által definiált egyéb sablonok közül is. A pr-sablonok létrehozásáról és használatáról további információt a Lekéréses kérelmek leírásának javítása sablonok használatávalcímű témakörben talál.
Ha az adattár alapértelmezett sablonnal rendelkezik, az adattárban lévő összes PRs rendelkezik az alapértelmezett sablon leírási szövegével a létrehozáskor. Más sablonok hozzáadásához válassza a Sablon hozzáadása lehetőséget, majd válasszon egy sablont a legördülő listából. A sablon szövegét szerkesztheti a leírásban, eltávolíthatja vagy más szöveget is hozzáadhat.
PiszkozatI-kérelmek létrehozása
Ha a pull-kérés nem áll készen a felülvizsgálatra, létrehozhat egy vázlatos pull-kérést, amely jelzi a folyamatban lévő munkát. Ha a lekéréses kérelem készen áll a felülvizsgálatra, közzéteheti, és megkezdheti vagy folytathatja a teljes felülvizsgálati folyamatot.
A vázlat PR-k a következő különbségekkel rendelkeznek a közzétett PR-khez képest:
A build-érvényesítési szabályzatok nem futnak automatikusan. Manuálisan is sorba állíthatja a buildérvényesítéseket a pull request több lehetőség menüjének kiválasztásával.
A szavazás a piszkozat módban le van tiltva.
A szükséges véleményezők nem lesznek automatikusan hozzáadva. Az értesítések csak azoknak a véleményezőknek lesznek elküldve, akiket Ön kifejezetten hozzáad a PR-tervezethez.
A piszkozat PR-ek a PR listában jelennek meg egy Piszkozat jelvénnyel.
Piszkozati pull request létrehozásához válassza a Létrehozás melletti nyilat, és kattintson a Létrehozás piszkozatként lehetőségre a pull request létrehozásakor. Nem kell címelőtagokat használnia, például WIP vagy DO NOT MERGE.
Ha készen áll a lekéréses kérelem áttekintésére és befejezésére, válassza a Közzététel lehetőséget a PR jobb felső sarkában. A PR közzététele hozzárendeli a szükséges véleményezőket, kiértékeli a szabályzatokat, és elindítja a szavazást.
Ha egy meglévő közzétett lekéréses kérelmet piszkozatra szeretne módosítani, válassza a Piszkozatként megjelölés lehetőséget. A PR piszkozattá jelölése eltávolítja az összes meglévő szavazatot.
Lekéréses kérelem címének és leírásának hozzáadása vagy szerkesztése
Az Új lekérési kérelem lapon adjon meg egy címet és egy részletes leírást a módosításairól, hogy mások lássák, milyen problémákat oldanak meg a módosítások. Új és meglévő lehívási kérelmeknél a Fájlok és a Commitek a lehívási kérelem külön lapjain jelennek meg. Véleményezőket, munkaelemeket és címkéket adhat hozzá a Pull Requesthez.
Ha készen áll a módosítások áttekintésére, válassza a Létrehozás lehetőséget a PR létrehozásához.
létrehozását bemutató képernyőkép
A PR létrehozásakor ne aggódjék, ha nem áll készen az összes munkaelem, véleményező vagy részlet. A PR létrehozása után hozzáadhatja vagy frissítheti ezeket az elemeket.
Pr cím és leírás szerkesztése
Tartsa naprakészen a PR címét és leírását, hogy a véleményezők megérthessék a PR-ben lévő változásokat.
A meglévő Pull Request címét a jelenlegi cím kiválasztásával és a szöveg módosításával frissítheti. A módosítások mentéséhez válassza a Mentés ikont, vagy a módosítások elvetéséhez válassza a Visszavonás ikont.
A PR leírásának szerkesztéséhez válassza a Szerkesztés ikont a Leírás szakaszban.
Véleményezők hozzáadása lekéréses kérelemhez
Véleményezőket az Véleményezők szakaszában adhat hozzá egy új vagy meglévő PR-hez. Az opcionális véleményezőket kötelezőre is módosíthatja, a szükséges véleményezőket opcionálisra módosíthatja, vagy eltávolíthatja őket, kivéve, ha a szabályzat megköveteli őket.
A fiókszabályzatok minimális számú véleményezőt igényelhetnek, vagy automatikusan belefoglalhatnak bizonyos választható vagy kötelező felülvizsgálókat a kérelembe. A fiókszabályzat által megkövetelt véleményezőket nem távolíthatja el, de igény szerint módosíthatja vagy eltávolíthatja őket.
Ha meg szeretné tekinteni az ágszabályzatot, amely automatikusan hozzáadta a véleményezőt, kattintson a jobb gombbal a véleményező mellett található További lehetőségek lehetőségre a Véleményezők szakaszban a PR Áttekintés oldalon.
Ha a lekérést felülvizsgálni kívánt felhasználó vagy csoport nem tagja a projektnek, vegyen fel őket a projektbe mielőtt bevenné őket a véleményezők közé.
Ha véleményezőket szeretne hozzáadni egy új lekéréses kérelemhez, hajtsa végre a következő lépéseket:
- Az Új lekéréses kérelem lapon, a Véleményezők területen válassza a Felhasználók és csoportok keresése lehetőséget, hogy véleményezőként hozzáadja őket.
- Amikor nevet vagy e-mail-címet ad meg, egy legördülő lista megjeleníti az egyező felhasználók és csoportok listáját. Válasszon neveket a listából, és adjon hozzá választható véleményezőkként.
- A szükséges véleményezők hozzáadásához válassza a Kötelező véleményezők hozzáadásalehetőséget, majd válassza a Keresés lehetőséget a szükséges véleményezők hozzáadásához, a nevek kereséséhez és kiválasztásához.
Ha véleményezőket szeretne hozzáadni egy meglévő lekéréses kérelemhez, hajtsa végre a következő lépéseket:
Az Áttekintés lap Véleményezők szakaszában válassza a hozzáadása lehetőséget, majd válassza Kötelező véleményező vagy Választható véleményezőlehetőséget.
Amikor megad egy nevet vagy e-mail-címet, megjelenik az egyező felhasználók vagy csoportok listája. Jelölje ki a véleményezőként hozzáadni kívánt neveket.
Ha módosítani szeretné a véleményezőt a kötelező és a választható lehetőségek között, vagy ha el szeretne távolítani egy véleményezőt, válassza a További lehetőségek (⋮) lehetőséget a véleményező nevéhez jobbra. A véleményezőként kijelölt csoport vagy csoport tagságának megtekintéséhez válassza a csoport ikonját.
Munkaelemek csatolása lekéréses kérelemhez
Ha a munkaelemeket egy új pull requesthez szeretné csatolni, végezze el a következő lépéseket:
- Az Új lekéréses kérelem lapon, a Kapcsolandó munkaelemekszakaszban válassza a Munkaelemek keresése azonosító vagy cím alapjánlehetőséget.
- Kezdje el beírni a munkaelem azonosítóját vagy címét, és válassza ki a hivatkozást a megjelenő legördülő listából.
- A cím szerinti keresés állapot szerint szűrt munkaelemeket ad vissza; A Befejezett és Eltávolított állapotú munkaelemek ki vannak zárva.
- Ezek a munkaelemek dátum és felhasználó szerint is szűrve lesznek, és csak az elmúlt 30 napban létrehozott vagy frissített elemek jelennek meg. Ezeket az aktuális felhasználónak kell létrehoznia, hozzárendelnie vagy engedélyeznie.
Ha munkaelemeket szeretne meglévő lekéréses kérelemhez kapcsolni, hajtsa végre a következő lépéseket:
A pr Áttekintés lap Munkaelemek területén válassza a +lehetőséget.
Adja meg a munkaelem azonosítóját, vagy keresse meg a munkaelem címét. Jelölje ki a munkaelemet a megjelenő listából.
A munkaelem hivatkozásának eltávolításához válassza a munkaelem melletti x ikont. A hivatkozás eltávolítása csak a munkaelem és a pull request közötti kapcsolatot távolítja el. Az ágban vagy véglegesítésekből létrehozott hivatkozások a munkaelemben maradnak.
Címkék hozzáadása lekéréses kérelemhez
Címkék használatával megjelenítheti a fontos részleteket, és segíthet a PRS-ek rendszerezésében. A címkék további információkat közölhetnek a véleményezőkkel, például hogy a pull request még fejlesztés alatt áll, vagy hogy ez egy sürgős javítás egy közelgő kiadáshoz.
Ha címkét szeretne hozzáadni egy PR létrehozásakor, írja be a címke nevét a Címkék feladatba. A pr létrehozása után a címkéket a Címkék szakaszban kezelheti.
Mellékletek hozzáadása lekéréses kérelmekhez
Fájlokat, köztük képeket is csatolhat a PR-hez a létrehozás során vagy után. Válassza ki a papírklip ikont a Leírás mező alatt, vagy húzza a fájlokat közvetlenül a Leírás mezőbe.
Aktív lekéréses kérelem célágának módosítása
A legtöbb csapat esetében szinte az összes PR egy alapértelmezett ágat céloz meg, például main vagy develop. Ha néha másik ágat kell megcéloznia, könnyen elfelejtheti módosítani a célágat a PR készítésekor. Ha ez történik, módosíthatja az aktív Pull Request célágát:
- Válassza a További műveletek lehetőséget a PR Áttekintés lapon, majd a legördülő menüben válassza a Célág módosítása lehetőséget.
- A Célág módosítása panelen válassza a Célág kiválasztásalehetőséget, jelölje ki az új ágat, majd válassza a módosítása lehetőséget.
E-mailes lekéréses kérelmek értesítésének küldése az érdekelt feleknek
A lekéréses kérelmet e-mailben is megoszthatja, hogy értesítse a véleményezőket, és kommunikáljon a csapattagokkal. Egy pull request megosztása:
Válassza a További beállítások lehetőséget a PR Áttekintés lapon, majd válassza a Lekéréses kérelem megosztásalehetőséget.
A Pull kérés megosztása képernyőn adja hozzá a címzetteket úgy, hogy beírja nevüket a Címzett: mezőbe, majd válasszon a megjelenő felhasználónevek közül. A címzetteket is eltávolíthatja.
Adjon hozzá egy nem kötelező üzenetet a Megjegyzés (Nem kötelező) mezőben, majd válassza a Küldéslehetőséget. A címzettek kapnak egy e-mailt, amely felhívja a figyelmüket, és hivatkozik a kérelemre.
Jegyzet
A beépített e-mail szolgáltatás használatakor csak az egyes projekttagok címére küldhet e-maileket. Csapatcsoport vagy biztonsági csoport hozzáadása a Címzett: sorhoz nem támogatott. Ha ismeretlen e-mail-címet ad hozzá, egy üzenet jelzi, hogy egy vagy több címzett nem rendelkezik engedéllyel a levélben küldött lekéréses kérelem olvasásához.
Az e-mail szolgáltatás működéséhez a rendszergazdának kell konfigurálnia egy SMTP-kiszolgálót.