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

Ágszabályzatok és -beállítások

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

A fiókszabályzatok segítenek a csapatoknak megvédeni fontos fejlesztési ágaikat . A szabályzatok betartatják a csapat kódminőségét és változáskezelési szabványait. Ez a cikk a fiókszabályzatok beállítását és kezelését ismerteti. Az adattár- és ágházirendek és -beállítások áttekintéséért tekintse meg a Git-adattár beállításait és szabályzatait.

A konfigurált kötelező szabályzatokkal rendelkező ág nem törölhető, és lekéréses kérelmeket (PRs) igényel az összes módosításhoz.

Előfeltételek

  • Ágak irányelveinek beállításához legyen tagja a Projektadminisztrátorok biztonsági csoportjának, vagy rendelkezzen repszintű Szabályzatok szerkesztése engedéllyel. További információ: Git-adattárengedélyek beállítása.

  • Ha az Azure DevOps CLI az repos policy parancsaival szeretné kezelni a fiókszabályzatokat, kövesse az Azure DevOps parancssori felület használatának első lépéseit.

  • Ágak irányelveinek beállításához legyen tagja a Projektadminisztrátorok biztonsági csoportjának, vagy rendelkezzen repszintű Szabályzatok szerkesztése engedéllyel. További információ: Git-adattárengedélyek beállítása.

Ágszabályzatok konfigurálása

Az ágszabályzatok kezeléséhez válassza a Tárak>Ágak lehetőséget az Ágak lap megnyitásához a webportálon.

Képernyőkép az Ágak menüelemről.

Az ágazati házirend beállításai a következő útvonalon is elérhetők: Projekt beállítások Projekt beállítások>Tároló>Házirendek>Ágházirendek><Ágneve>.

Azok az ágak, amelyek rendelkeznek szabályzatokkal, egy házirend ikont jelenítenek meg. Az ikont választva közvetlenül az ág házirendbeállításaihoz léphet.

Az ágszabályzatok beállításához keresse meg a kezelni kívánt ágat. A jobb felső sarokban található Keresés ágnév mezőben tallózhat a listában, vagy megkeresheti az ágat.

Válassza az ág melletti További beállítások ikont, majd a helyi menüBen válassza az Ágszabályzatok lehetőséget.

Képernyőkép, amely megmutatja, hogyan lehet megnyitni az ágszabályokat a helyi menüből.

Szabályzatok konfigurálása az ág beállítások lapján. Az egyes szabályzattípusok leírását és utasításait az alábbi szakaszokban találja.

A véleményezők minimális számának megkövetelése

A kód áttekintése fontos a szoftverfejlesztési projektekhez. Annak érdekében, hogy a csapatok felülvizsgálják és jóváhagyják a PR-eket, minimális számú felülvizsgálótól kérhet jóváhagyást. Az alapszintű szabályzat megköveteli, hogy adott számú felülvizsgáló hagyja jóvá a kódot, elutasítás nélkül.

A szabályzat beállításához a Fiókszabályzatok alatt állítsa a Minimális véleményezői szám követelménye opciót Be értékre. Adja meg a szükséges számú véleményezőt, és válasszon az alábbi lehetőségek közül:

Képernyőkép a Kódellenőrzési kötelezettség szabályzat engedélyezéséről.

  • Válassza az Engedélyezés a kérelmezőknek, hogy jóváhagyják saját módosításaikat lehetőséget, hogy a PR létrehozója szavazhasson annak jóváhagyásáról. A létrehozó ettől függetlenül szavazhat jóváhagyásra a PR-en, de szavazata nem számít bele a bírálók minimális számába.

  • Válassza a Legutóbbi leküldőtől a saját módosítások jóváhagyásának tiltása a feladatok szétválasztásának kikényszerítéséhez. Alapértelmezés szerint bárki, aki leküldéses engedéllyel rendelkezik a forráságon, hozzáadhat elkötelezéseket, és szavazhat a PR-jóváhagyásra. Ha ezt a lehetőséget választja, az azt jelenti, hogy a legutóbbi leküldő szavazata nem számít, még akkor is, ha általában saját módosításaikat jóvá tudják hagyni.

  • Válassza a Befejezés engedélyezése lehetőséget, még akkor is, ha egyes véleményezők várakozásra vagy elutasításra szavaznak a pr befejezésének engedélyezéséhez, még akkor is, ha egyes véleményezők a jóváhagyás ellen szavaznak. Továbbra is a véleményezők minimális számának kell jóváhagynia.

  • Az új módosítások leküldésének helye alatt:
    • Válassza a Legalább egy jóváhagyás megkövetelése az utolsó iterációhoz , hogy legalább egy jóváhagyási szavazatot igényeljen az utolsó forráság-módosításhoz.
    • Válassza az Összes jóváhagyási szavazat alaphelyzetbe állítása lehetőséget (ami nem állítja vissza az elutasításra vagy várakozásra adott szavazatokat), hogy eltávolítsa az összes jóváhagyási szavazatot, de tartsa meg az elutasításra vagy várakozásra adott szavazatokat a forráság minden változásakor.
    • Ha a forráság változik, válassza a minden kód ellenőr szavazatának visszaállítása lehetőséget az összes szavazat, beleértve a jóváhagyási, elutasítási vagy várakozási szavazatokat is, eltávolításához.
  • Az új módosítások leküldésének helye alatt:
    • Válassza a Legalább egy jóváhagyás megkövetelése minden iterációban , hogy legalább egy jóváhagyási szavazatra legyen szükség az utolsó forráság-módosításra. A felhasználó jóváhagyása nem számít bele a felhasználó által leküldett korábbi nem jóváhagyott iterációkba. Ennek eredményeképpen egy másik felhasználónak az utolsó iterációra vonatkozó jóváhagyást kell elvégeznie. Minden iterációhoz legalább egy jóváhagyás szükséges az Azure DevOps Server 2022.1 és újabb verzióiban.
    • Válassza a Legalább egy jóváhagyás megkövetelése az utolsó iterációhoz , hogy legalább egy jóváhagyási szavazatot igényeljen az utolsó forráság-módosításhoz.
    • Válassza az Összes jóváhagyási szavazat alaphelyzetbe állítása lehetőséget (ami nem állítja vissza az elutasításra vagy várakozásra adott szavazatokat), hogy eltávolítsa az összes jóváhagyási szavazatot, de tartsa meg az elutasításra vagy várakozásra adott szavazatokat a forráság minden változásakor.
    • Ha a forráság változik, válassza a minden kód ellenőr szavazatának visszaállítása lehetőséget az összes szavazat, beleértve a jóváhagyási, elutasítási vagy várakozási szavazatokat is, eltávolításához.

Ha az összes többi irányelv megfelel, a létrehozó a szükséges számú véleményező jóváhagyása után lezárhatja a PR-t.

Csatolt munkaelemek keresése

A munkaelem-kezelés nyomon követéséhez társításokat követelhet meg a PR-k és a munkaelemek között. A munkaelemek összekapcsolása több kontextust biztosít a módosításokhoz, és biztosítja, hogy a frissítések végighaladnak a munkaelem-követési folyamaton.

A szabályzat beállításához az Ági szabályzatok területen állítsa a Csatolt munkaelemek ellenőrzése lehetőségetBe. Ez a beállítás megköveteli, hogy a munkaelemek egy PR-hez legyenek csatolva ahhoz, hogy a PR-t egyesíteni lehessen. Állítsa a beállítást Nem kötelezőre annak érdekében, hogy figyelmeztessen, ha nincs csatolt munkaelem, de tegye lehetővé a lekéréses kérelem befejezését.

Képernyőkép a csatolt munkaelemek lekéréses kérelmekben való megköveteléséről.

Megjegyzésfeloldás ellenőrzése

A Megjegyzésfeloldási szabályzat ellenőrzi, hogy az összes pr-megjegyzés feloldva van-e.

Állítsa be az ág megjegyzésfeloldási irányelvét úgy, hogy a Megjegyzésfeloldás ellenőrzése opciót Be állapotra állítja. Ezután válassza ki, hogy kötelezővé vagy nem kötelezővé kívánja tenni a szabályzatot.

Képernyőkép a megjegyzések megoldásának ellenőrzéséről.

További információ a lekéréses kérelmek megjegyzéseinek használatáról: Lekéréses kérelmek áttekintése.

Egyesítési típusok korlátozása

Az Azure Repos több egyesítési stratégiával rendelkezik, és alapértelmezés szerint mindegyik engedélyezett. A konzisztens ágelőzmények fenntartása érdekében alkalmazhat egy egyesítési stratégiát a lekérési kérelmek lezárásakor.

Állítsa a megengedett egyesítési típusok korlátozásátBekapcsolt állapotra, hogy korlátozza az engedélyezett egyesítési típusokat a tárhelyén.

Képernyőkép az egyesítési típusok korlátozásáról.

  • Az alapszintű egyesítés (nem gyorsított) egyesítési commitot hoz létre a célágban, amelynek szülei a cél- és forráság.
  • A squash-egyesítés egy lineáris történetet hoz létre egyetlen commit formájában a célágban, a forráság módosításaival. További információ a squash összevonásról és arról, hogy ez hogyan befolyásolja az ágak történetét.
  • A rebase és gyors előrelépés lineáris előzményt hoz létre azáltal, hogy a forrás commit-eket újrajátssza a célágra összeolvasztási véglegesítés nélkül.
  • Az újraalapozás egyesítési committal visszajátssza a forrás committjait a célra, és létrehoz egy egyesítési committet is.

Build érvényesítése

Beállíthat egy szabályzatot, amely megköveteli, hogy a lekéréses kérelem módosítása sikeres legyen, mielőtt a kérelemkérés befejeződik. A szabályzatok kidolgozása csökkenti a hibákat, és biztosítja a teszteredmények kifogástalanságát. A szabályzatok létrehozása akkor is segít, ha folyamatos integrációt (CI) használ a fejlesztési ágakon a problémák korai észleléséhez.

Az építésérvényesítési szabályzat új építést indít, amikor új lekéréses kérelmet (PR) hoznak létre, vagy módosításokat küldenek egy meglévő, az ágat célzó PR-be. A build szabályzat kiértékeli a build eredményeket annak megállapításához, hogy a pull kérés befejezhető-e.

Fontos

A build-érvényesítési szabályzat megadása előtt rendelkeznie kell egy build folyamattal. Ha nincs csővezetéke, lásd Csővezeték létrehozása. Válassza ki a projekttípusnak megfelelő buildtípust.

Építési érvényesítési szabályzat hozzáadása

  1. Válassza a + gombot Build érvényesítése mellett.

    Képernyőkép a Build érvényesítése mellett található Hozzáadás gombról.

  2. Töltse ki az Építési szabályzat beállítása űrlapot:

    Képernyőkép a buildszabályzat beállításairól.

    • Válassza ki a Build folyamatot.

    • Van lehetőség egy elérésiút-szűrő beállítására. Tudjon meg többet a fiókszabályzatok elérésiút-szűrőiről.

    • Az Eseményindító területen válassza az Automatikus (a forráság frissítésekor) vagy a Manuális lehetőséget.

    • A Politikai követelmény alatt válassza a kötelező vagy nem kötelező lehetőséget. Ha a Kötelező lehetőséget választja, a buildeknek sikeresen be kell fejeződniük a PRS-ek elvégzéséhez. Válassza a Választható lehetőséget, ha értesítést szeretne adni a buildelési hibáról, de továbbra is engedélyezi a PRS-ek befejezését.

    • Állítson be egy build lejárati dátumot, hogy a védett ág frissítései ne szegik meg a megnyitott PRS-ek módosításait.

      • Közvetlenül az <ág frissítésekor>: Ez az opció a lekéréses kérelem (PR) build szabályzat állapotát "sikertelen"-re állítja minden alkalommal, amikor az ágat frissítik, és újraindítja a buildet. Ez a beállítás biztosítja, hogy a pr-módosítások akkor is sikeresen létrejönnek, ha a védett ág megváltozik.

        Ez a lehetőség azoknak a csapatoknak ajánlott, amelyek fontos ágai kevés módosítást hajtanak végre. Az elfoglalt fejlesztési ágakban dolgozó csapatok zavarónak találhatják azt, hogy minden alkalommal várniuk kell egy buildre, amikor az ág frissül.

      • Miután <n> óra eltelt, ha <ág neve> frissült: Ez a beállítás lejáratja az aktuális szabályzat állapotát, amikor a védett ág frissül, ha a sikeres build régebbi a megadott küszöbértéknél. Ez a lehetőség kompromisszumot jelent a védelemmel ellátott ág frissítésekkor mindig vagy soha nem igényel buildelést. Ez a választás csökkenti a buildek számát, ha a védett ág gyakran frissül.

      • Soha: A védett ág frissítései nem módosítják a szabályzat állapotát. Ez az érték csökkenti a buildek számát, de problémákat okozhat a nemrég nem frissített PRS-ek végrehajtásakor.

    • Adjon meg egy választható megjelenítendő nevet ehhez a buildelési szabályzathoz. Ez a név azonosítja a szabályzatot a Fiókházirendek lapon. Ha nem ad meg megjelenítendő nevet, a szabályzat a buildelési folyamat nevét használja.

  3. Válassza a Mentés lehetőséget.

Amikor a lekéréses kérelem tulajdonosa feltölti a sikeresen megépített módosításokat, az irányelv állapota frissül.

Ha a <ág neve> azonnal frissül, vagy ha <n> óra elteltével frissül az >ág neve<, akkor a szabályzat állapota frissül, amikor a védett ág frissül, ha az előző build már nem érvényes.

Állapotellenőrzések

A külső szolgáltatás a PR Status API használatával részletes állapotot tehet közzé a pull requesteken. A további szolgáltatások ágszabályzata lehetővé teszi, hogy ezek a külső szolgáltatások részt vegyenek a pr munkafolyamatban, és szabályzatkövetelményeket állapítsanak meg.

Képernyőkép a külső szolgáltatások jóváhagyásának megköveteléséről.

A szabályzat konfigurálásával kapcsolatos utasításokért lásd : Ágházirend konfigurálása külső szolgáltatáshoz.

Kód véleményezők automatikus belefoglalása

Automatikusan hozzáadhat véleményezőket az adott könyvtárakban és fájlokban lévő fájlokat módosító lekéréses kérelmekhez, illetve az adattárban lévő összes lekéréses kérelemhez.

  1. Válassza a + gombot az Automatikusan belefoglalt véleményezők mellett.

    Képernyőkép, amelyen a

  2. Töltse ki az Új ellenőrzési szabályzat hozzáadása képernyőt.

    Képernyőkép az Új véleményező hozzáadása szabályzat képernyőről.

    • Személyek és csoportok hozzáadása a véleményezőkhöz.

    • Válassza az Opcionális lehetőséget, ha automatikusan szeretne véleményezőket hozzáadni, de nem igényel jóváhagyást a lekéréses kérelem befejezéséhez.

      Vagy válassza a Kötelező lehetőséget, ha a lekéréses kérelmek csak a következő időpontig hajthatóak végre:

      • Minden véleményezőként hozzáadott személy jóváhagyja a módosításokat.
      • A bírálóként hozzáadott csoportok közül legalább egy személy jóváhagyja a módosításokat.
      • Ha csak egy csoportra van szükség, a megadott minimális számú tag jóváhagyja a módosításokat.

    • Adja meg azokat a fájlokat és mappákat, amelyek automatikusan beillesztett véleményezőket igényelnek. Hagyja üresen ezt a mezőt, ha az ágban lévő összes lekéréses kérelem véleményezőit szeretné megkövetelni.

    • Ha a lekéréses kérelmek tulajdonosai szavazhatnak a saját lekéréses kéréseik jóváhagyására, a szabályzat teljesítéséhez válassza a Kérelmezők jóváhagyásának engedélyezése lehetőséget .

    • Megadhat egy tevékenységfolyam-üzenetet, amely megjelenik a lekéréses kérelemben.

  3. Válassza a Mentés lehetőséget.

Ágazati irányelvek megkerülése

Bizonyos esetekben előfordulhat, hogy meg kell kerülnie a szabályzat követelményeit. A megkerülési engedélyek lehetővé teszik a módosítások közvetlen leküldését egy ágra, vagy olyan lekéréses kérelmek teljesítését, amelyek nem felelnek meg az ágszabályzatoknak. Kivétel engedélyeket adhat egy felhasználónak vagy csoportnak. Beállíthatja az engedélyek hatókörének megkerülését egy teljes projektre, tárházra vagy egyetlen ágra.

Két engedély lehetővé teszi, hogy a felhasználók különböző módokon megkerüljék az ágpolitikát:

  • A lekéréses kérelmek végrehajtásakor a szabályzatok megkerülése csak a lekéréses kérelmek befejezésére vonatkozik. Az ezzel az engedéllyel rendelkező felhasználók akkor is végrehajthatják a lekéréses kérelmeket, ha a lekéréses kérelmek nem felelnek meg a szabályzatoknak.

  • A házirendek megkerülése a helyi tárházakból történő leküldésekre és a weben végzett módosításokra vonatkozik. Az ezzel az engedéllyel rendelkező felhasználók közvetlenül leküldhetik a módosításokat a védett ágakra a szabályzat követelményeinek teljesítése nélkül.

Képernyőkép a szabályzatvégrehajtás megkerülésének engedélyeiről.

Az engedélyek kezelésével kapcsolatos további információkért tekintse meg a Git-engedélyeket.

Fontos

Körültekintően járjon el, ha lehetővé teszi a szabályzatok megkerülését, különösen az adattár és a projekt szintjén. A szabályzatok a biztonságos és megfelelő forráskódkezelés sarokkövei.

Elérésiút-szűrők

Számos ágpolitika kínál elérési útvonal szűrőket. Ha be van állítva egy elérésiút-szűrő, a szabályzat csak az elérésiút-szűrőnek megfelelő fájlokra vonatkozik. Ha üresen hagyja ezt a mezőt, az azt jelenti, hogy a szabályzat az ágban lévő összes fájlra vonatkozik.

Megadhat abszolút elérési utakat (az elérési útnak vagy helyettesítő karakterrel / kell kezdődnie) és helyettesítő karaktereket. Példák:

  • /WebApp/Models/Data.cs
  • /WebApp/*
  • */Models/Data.cs
  • *.cs

Több elérési utat is megadhat, elválasztóként használva a ; jelet. Példa:

  • /WebApp/Models/Data.cs;/ClientApp/Models/Data.cs

Az ! előtaggal ellátott elérési utak ki vannak zárva, ha egyébként belefoglalták volna őket. Példa:

  • /WebApp/*;!/WebApp/Tests/* tartalmazza az összes fájlt a /WebApp mappában, kivéve a /WebApp/Tests mappában lévő fájlokat.
  • !/WebApp/Tests/* nem ad meg fájlokat, mivel először semmi sem szerepel a fájlban

A szűrők sorrendje jelentős. A szűrők balról jobbra vannak alkalmazva.

Kérdések és válaszok

Leküldhetem a módosításokat közvetlenül a fiókszabályzatokkal rendelkező ágakra?

A módosításokat csak akkor küldheti le közvetlenül a szükséges ágszabályzatokkal rendelkező ágakra, ha rendelkezik az ágszabályzatok megkerülésére vonatkozó engedélyekkel. Ezeknek az ágaknak a módosítása csak lekéréses kérelmeken keresztül végezhető el. Ha nem kötelező ágszabályzatokkal rendelkeznek, közvetlenül leküldheti a módosításokat az opcionális ágszabályzatokkal rendelkező ágakra.

Mi az automatikus kiegészítés?

A pull requestek esetében az ágszabályzatokkal konfigurált ágak rendelkeznek az Automatikus kiegészítés gombbal. Ezt a lehetőséget választva automatikusan végrehajthatja a lekéréses kérelmet, miután az minden szabályzatot teljesített. Az automatikus kiegészítés akkor hasznos, ha nem számít a módosításokkal kapcsolatos problémákra.

Mikor vannak ellenőrizve a fiókszabályzat feltételei?

A fiókszabályzatok újraértékelődnek a kiszolgálón, amikor a lekéréses kérelmek tulajdonosai leküldéses módosításokat hajtanak végre, és amikor a véleményezők szavaznak. Ha egy szabályzat elindít egy buildet, a build állapota várakozási állapotot állít be, amíg a build befejeződik.

Használhatok XAML build definíciókat a fiókszabályzatokban?

Nem, az XAML-builddefiníciók nem használhatók ágszabályzatokban.

Milyen helyettesítő karaktereket használhatok a szükséges kód véleményezőihez?

Az egyszeres csillag * bármennyi karaktert helyettesíthet, beleértve az előre perjeleket / és a visszaperjeleket \ is. A kérdőjelek ? bármely egyetlen karakter helyett állhatnak.

Példák:

  • *.sqla .sql kiterjesztésű összes fájlnak megfelel.
  • /ConsoleApplication/* egyezik a ConsoleApplication nevű mappában lévő összes fájllal.
  • /.gitattributes megegyezik az adattár gyökerében található.gitattributes* fájllal.
  • */.gitignore megegyezik az adattárban található . gitignore fájllal.

A szükséges kódfelügyelői útvonalak megkülönböztetik a kis- és nagybetűket?

Nem, a fiókszabályzatok nem tesznek különbséget a kis- és nagybetűk között.

Hogyan konfigurálhatok több felhasználót kötelező véleményezőként, de csak egy felhasználót kell jóváhagynom?

Hozzáadhatja a felhasználókat egy csoporthoz, majd véleményezőként hozzáadhatja a csoportot. A csoport bármely tagja jóváhagyhatja, hogy megfeleljen a szabályzatkövetelményeknek.

Jogosult vagyok a házirendek megkerülésére. Miért látom még mindig a szabályzati hibákat a lekérési kérelem állapotában?

A konfigurált szabályzatok mindig kiértékelésre kerülnek a lekéréses kérelmek módosításaihoz. A szabályzatmegkerülési engedéllyel rendelkező felhasználók esetében a jelentett szabályzat állapota csak tájékoztató jellegű. Ha a megkerülési engedélyekkel rendelkező felhasználó jóváhagyja, a hiba állapota nem blokkolja a lekéréses kérelmek befejezését.

Miért nem tudom befejezni a saját lekéréses kéréseimet, ha be van állítva az "A kérelmezők jóváhagyhatják a saját módosításaikat" opció?

Mind a Véleményezők minimális számának megkövetelése, mind az Automatikusan belefoglalt véleményezők házirendje lehetővé teszi a kérelmezők számára a saját módosítások jóváhagyását. Minden szabályzatban a beállítás csak az adott házirendre vonatkozik. A beállítás nincs hatással a másik szabályzatra.

A lekéréses kérelem például a következő szabályzatokkal rendelkezik:

  • A véleményezők minimális számának megkövetelése legalább egy véleményezőt igényel.
  • Az automatikusan belefoglalt véleményezők megkövetelik, hogy Ön vagy egy csapat, amelyhez tartozik, véleményező legyen.
  • Az automatikusan belefoglalt véleményezők engedélyezika kérelmezők számára, hogy jóváhagyják a saját módosításaikat .
  • A véleményezők minimális számának megkövetelése nem teszi lehetővé, hogy a kérelmezők jóváhagyják a saját módosításaikat .

Ebben az esetben a jóváhagyás megfelel az automatikusan belefoglalt véleményezőknek, de nem felel meg a minimális számú véleményező követelményének, ezért nem tudja befejezni a lekéréses kérelmet.

Más szabályzatok is lehetnek, például tiltsák meg a legutóbbi leküldők számára, hogy jóváhagyják a saját módosításaikat, amelyek megakadályozhatják a saját módosítások jóváhagyását még akkor is, ha a kérelmezők engedélyezetté válnak a saját módosításaik jóváhagyására.

Mi történik, ha az elérésiút-szűrők elérési útja nem / vagy helyettesítő karakterrel kezdődik?

Az elérésiút-szűrőkben lévő olyan elérési utaknak, amelyek nem kezdődnek /-vel vagy helyettesítő karakterrel, nincs hatása, és az elérésiút-szűrő úgy értékel, mintha az elérési út nem lett volna megadva. Egy ilyen elérési út nem egyezhet meg az / abszolút fájl elérési útjával.

  • Last updated on