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

Lekéréses kérelmek létrehozása

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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 PRS-eket a felsőbb rétegbeli adattárban lévő ágakból vagy az adattár elágaztató 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 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

  • Hozzáférés:
    • Alapszintű hozzáférés: A PRS-ek megtekintéséhez vagy áttekintéséhez legalább alapszintű hozzáféréssel rendelkező Azure DevOps-projekt tagja lehet.
    • Érdekelt felek hozzáférése: Nyilvános projektek esetében az érdekelt feleknek hozzáférést biztosító felhasználók teljes hozzáféréssel rendelkeznek az Azure-adattárakhoz.
  • engedélyek:
    • Adattárak engedélyezve: A projektben engedélyezni kell az adattárakat. Ha a Repos hub és a társított lapok nem jelennek meg, tekintse meg a(z) Az Azure DevOps szolgáltatás be- és kikapcsolása útmutatót, hogy újra engedélyezze a Repos szolgáltatást.
    • Project-tagság:
      • Ha nincs projektje, hozzon létre egyet vagy regisztráljon ingyen.
      • Ha ön nem projekttag, lesz hozzáadva.
    • Olvasók biztonsági csoportja: Ahhoz, hogy hozzájárulhasson egy PR-hez, legyen tagja az Olvasók biztonsági csoportnak, vagy rendelkezzen a megfelelő engedélyekkel.
    • Közreműködők biztonsági csoport: Ahhoz, hogy létrehozzon és befejezzen egy pull-kérelmet, legyen a Közreműködők biztonsági csoport tagja, vagy rendelkezzen a megfelelő engedélyekkel.
  • eszközök:
  • Hozzáférés:
    • Alapszintű hozzáférés: A PRS-ek megtekintéséhez vagy áttekintéséhez legalább alapszintű hozzáféréssel rendelkező Azure DevOps-projekt tagja lehet. Ha ön nem projekttag, lesz hozzáadva.
  • engedélyek:
    • A tárolók engedélyezve vannak: A tárolókat engedélyezni kell a projektben. Ha a Repos központ és a hozzá tartozó lapok nem jelennek meg, olvassa el a Azure DevOps szolgáltatás be- és kikapcsolása bekezdést, hogy hogyan lehet a Repos szolgáltatást újra engedélyezni.
    • Olvasók biztonsági csoport: Ahhoz, hogy hozzájárulhasson egy PR-hez, az Olvasók biztonsági csoport tagjának kell lennie, vagy rendelkeznie kell a megfelelő engedélyekkel.
    • Közreműködők biztonsági csoport: A lekéréses kérelem létrehozásához és befejezéséhez a Közreműködők biztonsági csoport tagjának kell lennie, vagy rendelkeznie kell a megfelelő engedélyekkel.

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 pr-t az Azure DevOps projektwebhelyről, a Visual Studióból vagy az Azure DevOps CLI-ből.

Az Azure DevOps projektwebhelyről létrehozhat egy új pr-t a következőkből:

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.

  1. A Adattárak>Lekéréses kérelmek lapon válassza Új lekéréses kérelem a jobb felső sarokban.

    Képernyőkép az Új lekéréses kérelem gombról.

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

    P R forrás- és célágainak képernyőképe az Azure-adattárakban.

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

    Képernyőkép, amely az Azure Repos Lekérési kérelmek lapján lévő P R létrehozására vonatkozó kérést jeleníti meg.

  • A Fájlok oldalon:

    Képernyőkép, amelyen egy P R létrehozására vonatkozó kérés látható az Azure-adattárAk Fájlok lapján.

Válassza a Lekéréses kérelem létrehozása lehetőséget egy olyan oldalra való ugráshoz, ahol megadhatja a lekéréses kérelmek adatait, és létrehozhatja a lekéréses kérelmet.

PR létrehozása csatolt munkaelemből

Közvetlenül egy ághoz kapcsolódó Azure Boards-munkaelemből is létrehozhat pull-kérelmet.

  1. Az Azure Boards ban, a Munka nézetben, a Hátralékok vagy Lekérdezések közül nyissa meg azt a munkaelemet, amelyik az ághoz van kapcsolva.

  2. A munkaelem Fejlesztési területén válassza a Lekéréses kérelem létrehozásalehetőséget.

    Egy csatolt ággal rendelkező munkaelem fejlesztési területéről lekéréses kérelem létrehozásának képernyőképe.

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: Módosítások másolása cherry-pick.

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. Ha a pr aktív, ez az ikon eltűnik, de továbbra is módosíthatja a lekéréses kérelem célágát.

Képernyőkép a kapcsoló forrásáról és a célágak ikonról.

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.

Képernyőkép, amely azt mutatja, hogyan adhatunk hozzá sablont P R létrehozásakor.

PiszkozatI-kérelmek létrehozása

Ha a lekéréses kérelem nem áll készen a felülvizsgálatra, létrehozhat egy pr-tervezetet, 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 lekéréses kérelem további beállítások 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.

    Képernyőkép, amely megjeleníti a P R piszkozatát a P R listában.

Jegyzet

A piszkozat-kérelmek létrehozásához az Azure DevOps Server 2019.1-es vagy újabb verziójára van szükség.

Piszkozat lekéréses kérelem létrehozásához kattintson a Létrehozás melletti nyílra, és válassza a Létrehozás piszkozatként a lekérés létrehozásakor. Nem kell olyan címelőtagokat használnia, mint a WIP vagy a DO NOT MERGE.

Létrehozás piszkozat P R.

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.

Képernyőkép a PR közzétételéről.

Ha egy meglévő közzétett lekéréses kérelmet piszkozatra szeretne módosítani, válassza a Megjelölés piszkozatkéntlehetőséget. A lekéréses kérelem piszkozatként való megjelölése eltávolítja az összes meglévő szavazatot.

Képernyőkép, amelyen a Megjelölés piszkozatként látható.

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ása lehetőséget a kérelem létrehozásához.

Új P R. létrehozását bemutató képernyőkép

Részletek hozzáadása egy új PR-hez.

A PR létrehozásakor ne aggódjék, ha nem áll készen az összes munkaelem, véleményező vagy részlet. A lekéréses kérelem 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ő lekéréses kérelem címét az aktuális cím kiválasztásával és a szöveg frissítésével 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.

Képernyőkép a P R címének szerkesztését és a leírás Szerkesztés gombjának kiválasztását ábrázoló képernyőképről.

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. Meglévő választható véleményezőket kötelezővé is tehet, a kötelező véleményezőket választhatóvá vagy eltávolíthatja, kivéve, ha ezeket a szabályzat megköveteli.

A fiókszabályzatok minimális számú felülvizsgálótigényelhetnek, vagy automatikusan bizonyos választható vagy kötelező felülvizsgálókat vonhatnak be a pull kérelmekbe. A fiókszabályzat által megkövetelt véleményezők nem távolíthatók el. Megváltoztathatja a fiókellenőrzési politika választható véleményezőit kötelezővé, vagy eltávolíthatja őket.

A lekéréses kérelem Áttekintés oldalon található Véleményezők szakaszban tekintheti meg az ágra vonatkozó politikát, amely automatikusan hozzáadta a véleményezőt. Ehhez kattintson jobb gombbal a véleményező melletti További lehetőségek lehetőségre.

A fiókszabályzat által automatikusan belefoglalt felülvizsgáló házirendjének megtekintése képernyőképe.

Ha a felülvizsgálni kívánt PR felhasználója vagy csoportja nem tagja a projektnek, hozzá kell adnia őket a projekthez, mielőtt véleményezőként felveheti őket.

Új PR-hez véleményezők hozzáadása:

  1. Az Új lekéréses kérelem lapon, a Véleményezőkterületen válassza Felhasználók és csoportok keresése elemet, hogy véleményezőként.
  2. 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.
  3. 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.

Pillanatkép egy új PR-hez való korrektúrázó hozzáadásáról.

Véleményezők hozzáadása egy meglévő pull requesthez:

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

    lekéréses kérelmek áttekintése

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

    P R véleményező hozzáadása.

Ha módosítani szeretné a véleményezőt a kötelező és a választható lehetőségek között, vagy el szeretne távolítani egy véleményezőt, válassza További lehetőségek a véleményező neve mellett. 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 új lekéréses kérelemhez:

  1. 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.
  2. Kezdje el beírni a munkaelem azonosítóját vagy címét, majd 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; Az állapotkategóriákkal rendelkező összes munkaelem ki van zárva Befejezett és Eltávolított. Ezek a munkaelemek dátum és felhasználó szerint is szűrve vannak, és csak az elmúlt 30 napban létrehozott vagy frissített elemek jelennek meg, és azokat az aktuális felhasználónak kell létrehoznia, hozzárendelnie vagy engedélyeznie.

Munkaelemek kapcsolása meglévő Pull Requesthez:

  1. A pr Áttekintés lap Munkaelemek területén válassza a +lehetőséget.

    Képernyőkép az Áttekintés lap és a munkaelemek szakasz kiválasztásáról.

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

Munkaelemek csatolása a lekéréses kérelemhez:

  1. Válassza a Áttekintés lapot a lekéréses kérelemben.

    Képernyőkép az Áttekintés lap és a hivatkozáselemek gomb kiválasztásáról.

  2. Válassza a Hozzáadás gombot a Munkaelemek területen. Ikont adjon hozzá a PR-ekhez

  3. Adja meg a munkaelem azonosítóját, vagy keressen a szövegnek megfelelő címmel rendelkező munkaelemeket. Jelölje ki a munkaelemet a megjelenő listából. A cím szerinti keresés állapot szerint szűrt munkaelemeket ad vissza; Az állapotkategóriákkal rendelkező összes munkaelem ki van zárva Befejezett és Eltávolított. Ezek a munkaelemek dátum és felhasználó szerint is szűrve vannak, és csak az elmúlt 30 napban létrehozott vagy frissített elemek jelennek meg, és azokat az aktuális felhasználónak kell létrehoznia, hozzárendelnie vagy engedélyeznie.

A munkaelem hivatkozásainak eltávolításához válassza az eltávolítás gombot, amely akkor jelenik meg, amikor rámutat a munkaelemre. eltávolítás gomb A hivatkozás eltávolítása csak a munkaelem és a lekéréses kérelem közötti hivatkozást 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.

Képernyőkép a címkékkel ellátott P RS-ről.

Ha címkét szeretne hozzáadni a lekéréses kérelem létrehozásakor, írja be a címke nevét a Címkék szakaszba. A pr létrehozása után a címkéket a Címkék szakaszban kezelheti.

A P R-címkék szakasz kiemelését bemutató képernyőkép.

Mellékletek hozzáadása lekéréses kérelmekhez

A létrehozás során vagy után fájlokat, köztük képeket is csatolhat a lekéréses kérelemhez. Jelölje 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.

Képernyőkép, amelyen fájlok csatolása látható a P R leírásához a létrehozás során.

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:

  1. 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.
  2. 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.

Lekéréses kérelmek e-mailes értesítései 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:

  1. 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 P R Áttekintés lapján a Lekéréses kérelmek megosztása lehetőség kiválasztását bemutató képernyőkép.

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

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

Ha a beépített e-mail funkciót használja, csak a projekttagok egyéni címére küldheti el az e-mailt. Csapatcsoport vagy biztonsági csoport hozzáadása a Címzett: sorhoz nem támogatott. Ha olyan e-mail-fiókot ad hozzá, amelyet a rendszer nem ismer fel, üzenetet kap arról, hogy az e-mail egy vagy több címzettje nem rendelkezik engedéllyel a levélben küldött lekéréses kérelem olvasásához.

Az e-mail funkció működéséhez az Azure DevOps Server rendszergazdájának kell konfigurálnia egy SMTP-kiszolgálót.

Következő lépések

Lekéréses kérelmek áttekintése