Kanály vydaných verzí

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2015

Poznámka

v Microsoft Team Foundation Server (TFS) 2018 a předchozích verzích se kanály sestavení a vydání nazývají definice, spuštění se nazývají sestavení, připojení služby se nazývají koncové body služby, fáze se nazývají prostředía úlohy se nazývají fáze.

Poznámka

Tento článek se věnuje klasickým kanálům pro vydávání verzí. Pokud chcete k vytváření kanálů CI/CD používat YAML, přečtěte si téma Vytvoření prvního kanálu.

kanály vydaných verzí v Azure Pipelines pomůžou vašemu týmu průběžně dodávat zákazníkům software za rychlejší tempo a s nižším rizikem. Testování a doručování softwaru můžete plně automatizovat v několika fázích až po produkční prostředí. Nebo nastavte částečně automatizované procesy se schváleními a nasazeními na vyžádání.

Přehled kanálu vydaných verzí

v tématu verze Azure Pipelines jsou porozuměly vydání a nasazení a podívejte se na následující video, kde najdete kanály verzí v akci.

Jak kanály vydaných verzí fungují?

Kanály vydaných verzí ukládají data pro vaše kanály, fáze, úlohy, vydání a nasazení v Azure Pipelines.

Komponenty kanálu pro vydání Azure

Azure Pipelines spouští následující postup v rámci každého nasazení:

  1. schválení před nasazením: při aktivaci nové žádosti o nasazení Azure Pipelines před nasazením vydané verze do fáze zkontrolovat, jestli je nutné schválení před nasazením. Pokud je to nutné, pošle jim e-mailová oznámení příslušným schvalovatelům.

  2. úloha nasazení fronty: Azure Pipelines naplánuje úlohu nasazení pro dostupného agenta automatizace. Agent je softwarový software, který může spouštět úlohy v nasazení.

  3. Výběr agenta: Agent Automation si úlohu převezme. Agenti pro kanály vydaných verzí jsou naprosto stejný jako agenti, kteří spouštějí vaše sestavení v Azure Pipelines. Kanál pro vydávání verzí může obsahovat nastavení pro výběr vhodného agenta za běhu.

  4. Stáhnout artefakty: Agent stáhne všechny artefakty, které jsou uvedené v této verzi, a za předpokladu, že jste si ho nerozhodli přeskočit. agent aktuálně rozumí dvěma typům artefaktů: Azure Pipelines artefakty a artefakty jenkinse.

  5. Spustit úlohy nasazení: Agent potom spustí všechny úlohy v úloze nasazení pro nasazení aplikace na cílové servery pro určitou fázi.

  6. Generovat protokoly průběhu: agent při spuštění nasazení vytvoří podrobné protokoly pro každý krok a uloží tyto protokoly zpátky do Azure Pipelines.

  7. schválení po nasazení: po dokončení nasazení do fáze Azure Pipelines zkontroluje, jestli je pro tuto fázi požadováno schválení po nasazení. Pokud není vyžadováno schválení nebo po dokončení požadovaného schválení, pokračuje v aktivaci nasazení do další fáze.

Kanály vydaných verzí a kanály sestavení mají samostatné uživatelská rozhraní. Hlavní rozdíly v kanálech jsou podpora v kanálech vydávání verzí pro různé typy aktivačních událostí a podpora schválení a přijetí.

Návody použít kanál pro vydávání verzí?

můžete začít používat Azure Pipelines vydání vytvořením kanálu vydání pro vaši aplikaci. Chcete-li vytvořit kanál verze, je nutné zadat artefakty , které tvoří aplikaci a kanál vydání.

Artefakt je nasaditelné součásti aplikace. Je obvykle vytvořená prostřednictvím kontinuální integrace nebo kanálu sestavení. verze Azure Pipelines mohou nasazovat artefakty vytvořené v široké škále zdrojů artefaktů. například Azure Pipelines build, jenkinse nebo Team City.

Definujte kanál verze pomocí fází a omezte nasazení do nebo ze fáze pomocí schválení. V každé fázi definujte automatizaci pomocí úloh a úloh. Pomocí proměnných můžete zobecnit automatizaci a triggery a řídit, kdy se mají nasazení automaticky aktivovat.

Podívejte se na následující příklad kanálu vydaných verzí, který se dá modelovat prostřednictvím kanálu vydávání verzí:

definice verze

V tomto příkladu je vydaná verze webu vytvořená shromážděním konkrétních verzí dvou sestavení (artefakty), z nichž každý má jiný kanál sestavení. Vydaná verze se nejdřív nasadí do vývojové fáze a pak se paralelně rozvětví na dvě fáze pro QA. Pokud se nasazení v obou fázích zdaří úspěšně, verze se nasadí do produkčního okruhu 1 a potom do produkčního okruhu 2. Každý provozní prstenec představuje více instancí stejného webu nasazeného v různých umístěních po celém světě.

Podívejte se na následující příklad, jak může být automatizace nasazení modelovaná v rámci fáze:

definice nasazení

V tomto příkladu se úloha používá k nasazení aplikace na weby na celém světě paralelně v rámci produkčního okruhu 1. Po úspěšném dokončení všech těchto nasazení se k přepnutí provozu z předchozí verze do novější verze použije druhá úloha.

Poznámka

Tfs 2015: nasazení úlohy a rozvětvení/spojování nejsou k dispozici v TFS 2015.

Generace

V následujících článcích se dozvíte, jak:

Co je koncept verze?

verze konceptu jsou v Azure Pipelines zastaralé, protože při vytváření vydánímůžete měnit proměnné.

Vytvořením konceptu vydaných verzí můžete upravit některá nastavení pro vydání a úlohy v závislosti na oprávněních role před zahájením nasazení. Změny se týkají pouze této verze a neovlivňují nastavení původního kanálu.

Vytvoření konceptu verze pomocí "..." odkaz na tři tečky v seznamu verzí:

Vytvoření konceptu verze v seznamu vydaných verzí

... nebo v rozevíracím seznamu release (vydaná verze ) na stránce definice kanálu:

Vytvoření konceptu verze na stránce definice kanálu

Po dokončení úprav konceptu verze klikněte na tlačítko Start z panelu nástrojů verze koncept.

Spustit koncept verze

Návody určete proměnné, které chcete upravit, když se vytvoří vydaná verze?

Na kartě proměnné v kanálu verze, když přidáváte nové proměnné, nastavte nastavitelné v době vydání pro proměnné, které chcete upravit, když se vydaná verze vytvoří a zařadí do fronty.

Určení proměnných, které se mají upravit při vytvoření vydané verze a zařazení do fronty

Když pak vytvoříte novou verzi, můžete upravit hodnoty těchto proměnných.

Úprava proměnných při vytvoření vydané verze a zařazení do fronty

Návody integraci a stav verze sestav?

Díky integraci s kanály vydaných verzí můžete nahlásit stav nasazení na více zdrojů, jako je například hostitel úložiště, vaše pracovní položky (odkazy nebo nasazení) nebo JIRA problémy.

Pokud chcete nakonfigurovat integraci kanálu vydaných verzí, vyberte kartu Možnosti a pak vyberte integrace z definice kanálu verzí.

Snímek obrazovky ukazující, jak získat přístup k integrací k vydaným verzím v kanálu pro vydávání verzí

Stav nasazení sestavy na hostitele úložiště

pokud je váš zdrojový kód v Azure Repos, tato možnost zobrazí na Azure Repos stránkách stavovou visačku. Označení označuje, kde bylo provedeno nasazení konkrétního potvrzení a zda je nasazení úspěšné nebo neúspěšné. Ve výchozím nastavení je stav nasazení publikovaný pro všechny fáze kanálu vydání. Můžete také vybrat konkrétní fáze pro zobrazení stavu nasazení.

Stav nasazení se zobrazí v následujících oblastech Azure Repos:

  • Soubory: Určuje stav posledního nasazení pro vybranou větev.

    Snímek obrazovky znázorňující stav kanálu pro soubory

  • Potvrzení: označuje stav nasazení pro každé potvrzení (vyžaduje povolení triggeru průběžné integrace).

    Snímek obrazovky znázorňující stav kanálu pro potvrzení.

  • Větve: označuje stav nejnovějšího nasazení pro každou větev.

    Snímek obrazovky znázorňující stav kanálu pro větve.

Poznámka

pokud váš zdrojový kód není v Azure Repos, můžete pomocí funkce povolit označení stavu nasazení zobrazit stav nasazení v externích úložištích.

Stav nasazení sestavy pro práci

Tuto možnost vyberte, pokud chcete propojit kanál verze s pracovními položkami. Stav nasazení se zobrazí na kartě odkazy pracovní položky.

Snímek obrazovky znázorňující propojené verze na kartě úlohy pracovní položky

Stav nasazení sestavy na Boards

Tuto možnost vyberte, pokud chcete propojit kanál verze s pracovními položkami a zobrazit stav nasazení na kartě Podrobnosti pracovní položky.

Snímek obrazovky znázorňující propojené verze na kartě podrobností pracovní položky

Odznak Povolení stavu nasazení

Tuto možnost vyberte, pokud chcete zobrazit stav nasazení na externím webu. Odznáčku fáze můžete zkopírovat a přidat na web, abyste měli vizualizaci stavu nasazení:

  1. Vyberte Odznáčku Povolit stav nasazení.

  2. Vyberte fáze, pro které chcete zobrazit stav. Ve výchozím nastavení jsou vybrány všechny fáze.

  3. Zkopírujte adresu URL odznáčku a přidejte ji na web nebo GitHub soubor Readme a zobrazte stav nasazení.

    Snímek obrazovky s odznáčku stavu verze

Hlášení stavu nasazení do Jiry

Tuto možnost vyberte, pokud chcete propojit kanál verze s problémy s Jira. Musíte nainstalovat aplikaci Azure Pipelines jira a připojit svou organizaci Azure DevOps s účtem Jira. Další podrobnosti najdete v kurzu integrace Jira.

Kdy mám upravit verzi místo kanálu, který ji definuje?

Můžete upravit schválení, úkoly a proměnné dříve nasazené verze. Neupravte tyto hodnoty v kanálu, ze kterého byla verze vytvořena. Tyto úpravy se však vztahují pouze na verzi vygenerované při opětovném nasazení artefaktů. Pokud chcete, aby vaše úpravy platit pro všechny budoucí verze a nasazení, zvolte možnost pro úpravu kanálu verze.

Kdy a proč bychom měli verzi opustit?

Po vytvoření verze můžeteartefakty znovu nasadit do všech fází definovaných v této verzi. To je užitečné, pokud chcete dělat pravidelné ruční verze nebo nastavit aktivační událost fáze kontinuální integrace, která pomocí této verze znovu nasadí artefakty.

Pokud nemáte v plánu znovu použít verzi nebo chcete zabránit tomu, aby se použila k opětovnému nasazení artefaktů, můžete verzi opustit pomocí místní nabídky, která se otevře na ikoně se třemi tečkami (...) v zobrazení kanálu.

Opuštění verze

Verzi nemůžete opustit, když probíhá nasazení, musíte nasazení nejprve zrušit.

Návody souhrny verzí e-mailem?

Po aktivaci a dokončení vydání můžete chtít souhrn poslat e-mailem zúčastněným stranám. V nabídce, která se otevře na ikoně se třemi tečkami (...) v zobrazení Kanál kanálu, použijte možnost Odeslat e-mail.

Odeslání souhrnu verze e-mailem

V okně Poslat e-mail se souhrnem vydání můžete informace odeslané v e-mailu dále přizpůsobit tak, že vyberete jenom některé části souhrnu verze.

Návody spravovat názvy nových verzí?

Názvy verzí pro kanál verze jsou ve výchozím nastavení sekvenčně číslovány. První verze má název Release-1,další verze je Release-2atd. Toto schéma pojmenování můžete změnit úpravou masky formátu názvu verze. Na kartě Možnosti kanálu verze upravte vlastnost Formát názvu verze na stránce Obecné.

Při zadávání masky formátu můžete použít následující předdefinované proměnné.

Proměnná Popis
Revize: rr Automaticky narůstá číslo s alespoň zadaným počtem číslic.
Datum/datum: MMddyy Aktuální datum s výchozím formátem MMddyy. Podporují se všechny kombinace M/MM/MMM/MMMM, d/dd/ddd/dddd, y/rrrr/rrrr/rrrr, h/hh/H/HH, m/mm, s/ss.
System.TeamProject Název projektu, ke kterému toto sestavení patří.
Release.ReleaseId ID verze, které je jedinečné ve všech verzích projektu.
Release.DefinitionName Název kanálu verze, ke kterému aktuální verze patří.
Build.BuildNumber Číslo sestavení obsaženého ve verzi. Pokud má verze více sestavení, jedná se o počet primárního buildu.
Build.DefinitionName Název kanálu sestavení obsaženého ve verzi. Pokud má verze více sestavení, je to název kanálu primárního buildu.
Artifact.ArtifactType Typ zdroje artefaktu propojeného s verzí. To může být například Azure Pipelines nebo Jenkins.
Build.SourceBranch Větev primárního zdroje artefaktů. V případě Gitu má tato větev hlavní tvar, pokud je větev refs/heads/main. Například Správa verzí Team Foundation větev formuláře, pokud je cesta ke kořenovému serveru pracovního prostoru $/teamproject/branch. Tato proměnná není nastavená pro Jenkinse ani jiné zdroje artefaktů.
Vlastní proměnná Hodnota vlastnosti globální konfigurace definované v kanálu verze. Název verze můžete aktualizovat vlastními proměnnými pomocí příkazů protokolování verze.

Například formát názvu verze vytvoří verze s názvy, jako je verze Release $(Rev:rrr) for build $(Build.BuildNumber) $(Build.DefinitionName)Release $(Rev:rrr) for build $(Build.BuildNumber) $(Build.DefinitionName)

Návody dobu uchovávání verzí?

Můžete přizpůsobit, jak dlouho se musí uchovávat verze tohoto kanálu. Další informace najdete v tématu uchovávání verzí.

Návody používat a spravovat historii verzí?

Pokaždé, když uložíte kanál verze, Azure Pipelines uloží kopii změn. Tato kopie vám umožní porovnat změny později, zejména při ladění selhání nasazení.

Při navázání sledovatelnosti mezi pracovními položkami a sestaveními/verzemi existují následující dva aspekty:

  • Zobrazí seznam pracovních položek, které byly nově vytvořeny jako součást sestavení. Najdete ho, když se díváte na instanci sestavení.
  • Vypište sestavení, ve které byla tato pracovní položka vytvořena. Seznam najdete v části Vývoj ve formuláři pracovní položky. Nastavení pro automatické propojení nových prací v tomto sestavení nemá nic společného s tím, jak vypočítáme první položku s odrážkami. Ovlivňuje jenom to, jak vypočítáme druhou odrážkovou položku.

Výpočet první odrážky je pro sestavení následující: Řekněme například, že jste zahájili nové sestavení. Bez ohledu na nastavení vypočítáme seznam nových potvrzení sestavení. Budeme provádět následující úlohy:

  • Zjistili jsme potvrzení c2, které se právě sestaví.
  • Zjistili jsme potvrzení c1, které bylo vytvořeno v posledním úspěšném sestavení stejné větve (Build.SourceBranch).
  • Všechna potvrzení najdete mezi c1 a c2 (ve stromu potvrzení).

Může se stát, že ve stejné větvi není žádné poslední známé úspěšné sestavení. Například při prvním spuštění sestavení ve větvi nebo při odstranění všech předchozích sestavení ve větvi (pravděpodobně prostřednictvím zásad uchovávání informací). V těchto případech může být seznam dlouhý.

Jakmile máme seznam potvrzení, vytvoříme výčet všech pracovních položek přidružených ke každému z těchto potvrzení. Toto je seznam, který se zobrazí v sestavení.

Teď můžete začít!

Dokončete následující kroky:

  1. Nastavení vícestupňovového spravovaného kanálu verze

  2. Správa nasazení pomocí schválení a bran