Kontrola a odeslání žádosti o přijetí změn
Žádost o přijetí změn je váš lístek pro získání znalostí na platformu Learn. Vytvořili jste žádost o přijetí změn, ale ještě nebyla odeslána do fronty žádostí o přijetí změn v cílovém úložišti. Stejně jako u mnoha opensourcových projektů existuje řada kontrol a kontrol, které se provádějí k ověření změn před publikováním.
Anatomie žádosti o přijetí změn
Žádost o přijetí změn zobrazuje uživatele GitHubu, který vytvořil žádost o přijetí změn, cílové úložiště a větev, ve které byla žádost o přijetí změn vytvořena. Žádosti o přijetí změn obsahují v horní části několik karet, mezi které patří:
- Karta Konverzace: Řídicí panel, na kterém můžete zobrazit komentáře od ostatních spolupracovníků a odpovídat na něj, zobrazit seznam oznámení v průběhu procesu sestavení a kontroly a používat automatizaci komentářů k provádění akcí.
- Karta Potvrzení: Záznam změn provedených v této větvi.
- Karta Změněné soubory: Porovnání změněných souborů v žádosti o přijetí změn s předchozím stavem.
Věnujte pozor na kartu Konverzace, kde se zobrazují všechny aktualizace nebo oznámení a všechny diskuze mezi vámi, revidujícím a dalšími spolupracovníky. Tady můžete také přidat komentáře hashtagů k provádění akcí, jako je například odhlášení k žádosti o přijetí změn, abyste označili, že je připravená k ověření a sloučení, nebo pokud potřebujete proces pozastavit.
Žádosti o přijetí změn často obsahují popisky, které označují jejich stav, například draft určení konceptů žádostí o přijetí změn, které nejsou připravené ke kontrole, nebo do-not-merge pro žádosti o přijetí změn, které jsou nové nebo nerevidované.
Ověřování
Před sloučením žádosti o přijetí změn do cílové větve může být nutné projít jedním nebo více procesy ověření žádosti o přijetí změn. Jakmile vyberete Vytvořit žádost o přijetí změn, GitHub spustí ověření nakonfigurovaná pro vaše úložiště. Po dokončení procesu ověření se výsledky zobrazí v žádosti o přijetí změn.
Procesy ověřování se liší v závislosti na rozsahu navrhovaných změn a pravidlech cílového úložiště. Po odeslání žádosti o přijetí změn můžete očekávat, že dojde k jedné nebo několika z následujících akcí:
- Sloučitelnost: Nejprve se provede základní test sloučení GitHubu, který ověří, jestli jsou navrhované změny ve vaší větvi v konfliktu s cílovou větví. Pokud žádost o přijetí změn indikuje, že tento test selhal, musíte před pokračováním zpracování odsouhlasit obsah, který způsobuje konflikt při sloučení.
- Licenční smlouva s příspěvkem (CLA):Pokud přispíváte do veřejného úložiště a nejste zaměstnancem Microsoftu, v závislosti na rozsahu navrhovaných změn můžete být požádáni o dokončení krátké smlouvy CLA při prvním odeslání žádosti o přijetí změn do tohoto úložiště. Po vymazání kroku CLA se vaše žádost o přijetí změn zpracuje.
-
Popisky: Popisky se na vaši žádost o přijetí změn automaticky použijí, aby označily její stav při průchodu ověřovacím pracovním postupem. Nové žádosti o přijetí změn můžou například automaticky obdržet
do-not-mergepopisek, který značí, že žádost o přijetí změn ještě nedokončila kroky ověření, kontroly a odhlášení. - Ověření a sestavení: Automatizované kontroly ověřují, zda vaše změny projdou ověřovacími testy. Ověřovací testy můžou přinést upozornění nebo chyby, které vyžadují, abyste před sloučením udělali změny v jednom nebo více souborech v žádosti o přijetí změn. Výsledky ověřovacího testu se přidají jako komentář do žádosti o přijetí změn pro vaši recenzi a můžou se vám také poslat e-mailem.
- Příprava: Stránky článku ovlivněné vašimi změnami se po úspěšném ověření a sestavení automaticky nasadí do přípravného prostředí pro posouzení. V komentáři k žádosti o přijetí změn se zobrazí adresy URL náhledu.
- Automatické sloučení: Žádost o přijetí změn se může automaticky sloučit, pokud projde ověřovacím testováním a určitými kritérii. V takovém případě nemusíte dělat nic jiného.
Kontrola a odhlášení
Už to skoro máte! Po dokončení veškerého zpracování žádosti o přijetí změn je osvědčeným postupem zkontrolovat výsledky (například komentáře k žádosti o přijetí změn, adresy URL náhledu), abyste zjistili, jestli se před odhlášením ke sloučení vyžadují další změny. Pokud kontrolor žádosti o přijetí změn vaši žádost o přijetí změn zkontroloval, může také prostřednictvím komentářů poskytnout zpětnou vazbu v případě, že dojde k nevyřešeným problémům nebo otázkám, které brání sloučení.
K provádění důležitých akcí v žádosti o přijetí změn použijte automatizaci komentářů. Automatizace komentářů umožňuje uživatelům přiřadit odpovídající popisek k žádosti o přijetí změn, aby aktualizovali svůj stav nebo ho kategorizovali. Pokud pracujete v úložišti, kde byla implementována automatizace komentářů, použijte komentáře hashtagu k přiřazení nebo změně popisků, zavření žádosti o přijetí změn nebo pozastavení sloučení. Když třeba uděláte změny, napište komentář#sign-off, ze které chcete změnit popisek žádosti o přijetí změn.do-not-mergeready-for-review.
Pomocí komentářů v následující tabulce proveďte klíčové akce v žádosti o přijetí změn:
| Komentář hashtagu | Co to dělá |
|---|---|
#sign-off |
Automaticky přiřadí ready-to-merge popisek, aby kontroloři v úložišti věděli, že žádost o přijetí změn je připravená ke kontrole nebo sloučení. Pokud nejste uvedený autor a zkuste se přihlásit k žádosti o přijetí změn veřejného úložiště pomocí #sign-off komentáře, žádost o přijetí změn se aktualizuje a indikuje, že popisek může přiřadit jenom autor. |
#hold-off |
Odebere ready-to-merge štítek pro případ, že změníte názor nebo uděláte chybu. |
#please-close |
Zavře žádost o přijetí změn, pokud se rozhodnete, že změny nebudou sloučeny. |
#please-open |
Znovu otevře uzavřenou žádost o přijetí změn nebo problém. |
Pokud chcete sloučit změny, musíte zadat #sign-off komentář. I když všechny kontroly kontrol a ověření proběhnou úspěšně, zodpovídáte za použití tohoto komentáře, abyste kontrolorům žádosti o přijetí změn a správcům úložiště řekli, že vaše změny jsou připravené ke sloučení ze strany věcí. Když kontroloři zjistí, že vaše žádost o přijetí změn je bez problémů a odhlásila se, vaše změny se sloučí zpět do nadřazené větve a žádost o přijetí změn se zavře.
Publikování
Nezapomeňte, že žádost o přijetí změn musí sloučit kontrolor žádosti o přijetí změn, aby bylo možné změny zahrnout do dalšího naplánovaného spuštění publikování. Za normálních okolností se žádosti o přijetí změn kontrolují a slučují v pořadí odeslání.
Po schválení a sloučení příspěvků je proces publikování vybere. V závislosti na týmu, který spravuje úložiště, ke kterému přispíváte, se časy publikování můžou lišit, ale obvykle se vyskytují alespoň jednou týdně. Po publikování může trvat až 45 minut, než se články zobrazí online.
Jakmile budou vaše změny publikovány, přejdou na Microsoft Learn, aby se ostatní mohli učit.
Scénář: Publikování změn ve službě Aplikace Azure Service
V minulosti jste si všimli příležitosti přidat některé užitečné informace na stránku dokumentace ke službě App Service a vytvořili jste žádost o přijetí změn pro přidání změn. Teď jste připraveni zkontrolovat a odhlásit se k žádosti o přijetí změn a publikovat úpravy.