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


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-offmegjegyzé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!