Lekéréses kérelem feldolgozása
A lekéréses kérelem (PR) megnyitása után a lekéréses kérelem ellenőrzésekkel és felülvizsgálatokkal ellenőrzi, hogy a javasolt módosítások egyesíthetők-e. A PRS-ekkel kapcsolatos további háttérért tekintse meg a Git és a GitHub alapjait.
Ellenőrzés
Ahhoz, hogy a lekéréses kérelem egyesíthető legyen a célágával, előfordulhat, hogy egy vagy több PR-ellenőrzési folyamaton kell áthaladnia. Miután kiválasztotta a Lekéréses kérelem létrehozása lehetőséget, a GitHub futtatja az adattárhoz konfigurált érvényesítéseket. Amikor az érvényesítési folyamat befejeződik, az eredmények megjelennek a lekéréses kérelemben.
Az ellenőrzési folyamatok a javasolt módosítások hatókörétől és a céladattár szabályaitól függően változnak. A lekéréses kérelem elküldése után az alábbiak közül egy vagy többre számíthat:
- Egyesítési képesség: Először egy alapszintű GitHub-egyesítési teszt következik be annak ellenőrzéséhez, hogy az ág javasolt módosításai ütköznek-e a célággal. Ha a lekéréses kérelem azt jelzi, hogy a teszt sikertelen volt, a feldolgozás folytatása előtt egyeztetnie kell az egyesítési ütközést okozó tartalmat.
- Hozzájárulási licencszerződés (CLA):Nem Microsoft-közreműködőként, ha nyilvános adattárhoz járul hozzá, előfordulhat, hogy a rendszer arra kéri, hogy töltse ki a rövid CLA-t, amikor először küld be egy lekéréses kérelmet az adott adattárba. A CLA-lépés törlése után a lekéréses kérelem feldolgozása történik.
- Címkézés: A rendszer automatikusan alkalmazza a címkéket a lekéréses kérelemre, hogy jelezze a kérelem állapotát, miközben az áthalad az ellenőrzési munkafolyamaton. Előfordulhat például, hogy az új hitelesítő adatok automatikusan megkapják a "do-not-merge" címkét, ami azt jelzi, hogy a kérelem még nem hajtotta végre az érvényesítési, felülvizsgálati és kijelentkezési lépéseket.
- Ellenőrzés és felépítés: A javasolt változtatások megfelelőségét automatikus ellenőrzések vizsgálják meg. Az érvényesítési tesztek figyelmeztetéseket vagy hibákat okozhatnak, ezért a kérelemben egy vagy több fájlt kell szerkesztenie, mielőtt egyesítené azokat. Az érvényesítési teszt eredményei megjegyzésként jelennek meg a felülvizsgálathoz szükséges kérelemben, és e-mailben is elküldhetők Önnek.
- Előkészítés: A sikeres ellenőrzés és létrehozás után a módosított cikkek automatikusan üzembe lesznek helyezve egy előkészítési környezetben felülvizsgálat céljából. Az előnézeti URL-címek megtalálhatók a lekéréses kérelemhez csatolt megjegyzések között.
- Automatikus egyesítés: A lekéréses kérelem automatikusan egyesíthető, ha megfelel az érvényesítési tesztelésnek és bizonyos feltételeknek. Ebben az esetben semmi mást nem kell tennie.
Visszajelzések áttekintése és kezelése
Miután az összes PR-feldolgozás befejeződött, tekintse át az eredményeket (például PR-megjegyzéseket, buildelési eredményeket). Állapítsa meg, hogy további módosításokat kell-e végrehajtania az egyesítésre való kijelentkezés előtt. Előfordulhat, hogy az alábbi okok valamelyike miatt módosítania kell a tartalmat:
- PR-megjegyzések a véleményezőktől. Ha egy pr-felülvizsgáló áttekintette a lekéréses kérelmet, megjegyzésekkel küldhet visszajelzést, ha az egyesítés előtt megoldandó problémák vagy kérdések merülnek fel.
- Visszajelzés a társ-véleményezőktől.
- Formázási javítások a megjelenítési problémák miatt.
- Érvényesítési hibák vagy figyelmeztetések.
- Ütközések egyesítése.
Ha módosításokat kell végeznie, szerkesztheti a tartalmat közvetlenül a lekéréses kérelemben, vagy visszatérhet a VS Code-hoz a módosítások elvégzéséhez. Ha végzett, véglegesítse a módosításokat a munkaágban. A kérelem automatikusan frissül a módosításokkal.
Minden alkalommal, amikor ugyanahhoz a munkaághoz ad hozzá véglegesítést, a rendszer automatikusan hozzáadja a véglegesítést a kérelemhez. Minden véglegesítésnél a közzétételi rendszer automatikusan újrafuttatja az ellenőrzési és felülvizsgálati folyamatokat.
Kijelentkezés és megjegyzés automatizálása
Amikor elhárította az összes visszajelzési és érvényesítési hibát, és készen áll a módosítások egyesítésére, ideje bejelentkeznie a lekéréses kérelemre egy új, olvasható #sign-off
megjegyzés létrehozásával. A módosítások egyesítése érdekében meg kell adnia a #sign-off
megjegyzést. Még akkor is, ha minden ellenőrzés és ellenőrzés sikeres, ön felelős azért, hogy ezzel a megjegyzéssel tájékoztassa a pr-felülvizsgálókat és az adattárgazdákat arról, hogy a módosítások készen állnak az egyesítésre.
Amikor a véleményezők úgy ítélik meg, hogy a lekéréses kérelem problémamentes és kijelentkeztetve van, a rendszer egyesíti a módosításokat az alapértelmezett ágban, és bezárja a lekéréses kérelmet.
A megjegyzések automatizálása lehetővé teszi, hogy azok a felhasználók, akik nem rendelkeznek írási engedélyekkel az adattárban, írási szintű műveletet hajtsanak végre a megfelelő címke lekéréses kérelemhez való hozzárendelésével. Ha olyan adattárban dolgozik, ahol a megjegyzések automatizálása megtörtént, használja az alábbi táblázatban felsorolt hashtag megjegyzéseket címkék hozzárendeléséhez, címkék módosításához vagy lekéréses kérelem bezárásához. A Microsoft-szerzők e-mailben is értesítést kapnak véleményezésre és kijelentkezésre, amikor módosításokat javasolnak a cikkeikben.
Hashtag-megjegyzés | Művelet |
---|---|
#sign-off |
Automatikusan hozzárendeli az egyesítésre kész címkét, hogy a tárházban lévő véleményezők tudják, hogy a lekéréses kérelem készen áll a felülvizsgálatra/egyesítésre. Ha nem Ön a listában szereplő szerző, és megpróbál bejelentkezni egy nyilvános adattár pr-jára a #sign-off megjegyzés használatával, a kérelem frissítve lesz, jelezve, hogy csak a szerző rendelheti hozzá a címkét. |
#hold-off |
Eltávolítja az egyesítésre kész címkét, ha meggondolja magát, vagy hibát követ el. A privát tárházban ez hozzárendeli a do-not-merge (nem egyesítendő) címkét. |
#please-close |
Bezárja a lekéréses kérelmet, ha úgy dönt, hogy nem egyesíti a módosításokat. |
#please-open |
Bezárt lekéréses kérelem vagy probléma újbóli megnyitása. |
Közzététel
A lekéréses kérelemnek egyesítenie kell egy pr-felülvizsgálóval, mielőtt a módosítások belefoglalhatók a következő ütemezett közzétételi futtatásba. A PRS-eket általában a beküldés sorrendjében vizsgálják felül és egyesítik.
A hozzájárulások jóváhagyása és egyesítése után a közzétételi folyamat felveszi őket. Attól függően, hogy melyik csapat kezeli azt az adattárat, amelyhez hozzájárul, a közzétételi idő változhat, de általában minden hétköznap legalább egyszer előfordulnak. A cikk online megjelenése a közzétételt követően akár 45 percet is igénybe vehet.
A módosítások közzététele után a Microsoft Learn élőben is elérhető lesz, hogy mások is elkezdhessenek tanulni!
Következő lépések
Ennyi az egész! Ön hozzájárult a Microsoft Learn-tartalmakhoz!