Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Toto je podrobný průvodce používáním Azure Pipelines k vytvoření ukázkové aplikace z úložiště Git. Tato příručka používá kanály YAML nakonfigurované v editoru kanálů YAML. Pokud chcete místo toho použít klasické kanály, přečtěte si téma Definování klasického kanálu. Pokyny k používání TFVC najdete v tématu Sestavení úložišť TFVC.
Požadavky – Azure DevOps
Ujistěte se, že máte následující položky:
Účet GitHubu, kde můžete vytvořit úložiště. Vytvořte si ho zdarma.
Organizace Azure DevOps. Vytvořte si ho zdarma. Pokud už ho váš tým má, ujistěte se, že jste správcem projektu Azure DevOps, který chcete použít.
Možnost spouštět procesy na agentech hostovaných Microsoftem. Pokud chcete používat agenty hostované Microsoftem, musí mít vaše organizace Azure DevOps přístup k paralelním úlohům hostovaným Microsoftem. Můžete si buď koupit paralelní úlohu, nebo můžete požádat o bezplatný grant.
Vytvoření vaší první pipeline
Získání ukázkového kódu v Javě
Začněte tím, že do svého účtu GitHubu forknete následující úložiště.
https://github.com/MicrosoftDocs/pipelines-java
Vytvořte svůj první Java pipeline
Přihlaste se ke své organizaci Azure DevOps a přejděte do svého projektu.
Přejděte na Kanály a pak vyberte Nový kanál nebo Vytvořit kanál , pokud vytváříte první kanál.
Kroky průvodce proveďte tak, že nejprve vyberete GitHub jako umístění zdrojového kódu.
Můžete být přesměrováni na GitHub kvůli přihlášení. Pokud ano, zadejte svoje přihlašovací údaje GitHubu.
Až se zobrazí seznam úložišť, vyberte úložiště.
K instalaci aplikace Azure Pipelines můžete být přesměrováni na GitHub. Pokud ano, vyberte Schválit a nainstalovat.
Azure Pipelines bude analyzovat vaše úložiště a doporučí šablonu kanálu Maven .
Jakmile se zobrazí vaše nové potrubí, prohlédněte si YAML, abyste zjistili, co dělá. Až budete připraveni, vyberte Uložit a spustit.
Zobrazí se výzva k potvrzení nového
azure-pipelines.yml
souboru do úložiště. Až budete se zprávou spokojeni, vyberte Uložit a spusťte znovu.Pokud chcete sledovat pipeline v akci, vyberte úlohu sestavení.
Právě jste vytvořili a spustili kanál, který jsme pro vás automaticky vytvořili, protože se zdá, že váš kód odpovídá šabloně Maven .
Teď máte v úložišti funkční YAML sestavu
azure-pipelines.yml
, která je připravená k přizpůsobení.Až budete chtít kanál změnit, vyberte ho na stránce Pipelines a pak upravte
azure-pipelines.yml
soubor.
Přečtěte si další informace o práci s Javou ve vašem pipeline.
Zobrazení a správa procesů
Kanály můžete zobrazit a spravovat tak, že v nabídce vlevo zvolíte Kanály a přejdete na cílovou stránku kanálů.
Na úvodní stránce kanálů můžete zobrazit kanály a běhy kanálu, vytvářet a importovat kanály, spravovat nastavení zabezpečení a podrobně prozkoumat detaily kanálu a běhu.
Pokud chcete zobrazit kanály naposledy spuštěné (výchozí zobrazení), zvolte Možnost Poslední . Pokud chcete zobrazit všechny kanály, zvolte Vše .
Vyberte procesní řetězec pro správu tohoto procesního řetězce a prohlédněte si spuštění. Vyberte číslo sestavení pro poslední spuštění a zobrazte výsledky tohoto sestavení, vyberte název větve a zobrazte větev pro dané spuštění, nebo vyberte kontextovou nabídku pro spuštění kanálu a provedení dalších akcí správy.
Výběrem možnosti Spuštění zobrazíte všechna spuštění pipeline. Můžete dle vlastního uvážení filtrovat zobrazené běhy.
Výběrem spuštění kanálu zobrazíte informace o daném spuštění.
V místní nabídce můžete zvolit zachování nebo odstranění procesu. Další informace o uchovávání informací o spuštění najdete v tématu Zásady uchovávání informací o sestavení a vydání.
Zobrazení podrobností kanálu
Stránka podrobností kanálu umožňuje zobrazit a spravovat tento kanál.
Zvolte Upravit a upravte kanál. Další informace najdete v editoru kanálů YAML. Kanál můžete také upravit úpravou souboru azure-pipelines.yml přímo v úložišti, které je hostitelem kanálu.
Zobrazení podrobností o běhu kanálu
V souhrnu spuštění potrubí můžete zobrazit stav vašeho spuštění, jak během jeho spuštění, tak i po jeho dokončení.
V panelu souhrnu můžete zobrazit podrobnosti úkolu a fáze, stáhnout artefakty a navigovat k propojeným commitům, výsledkům testů a pracovním položkám.
Úlohy a etapy
V podokně úloh se zobrazí přehled stavu fází a úloh. V tomto podokně může být několik karet v závislosti na tom, jestli vaše zpracování obsahuje fáze a úlohy, nebo pouze úlohy. V tomto příkladu má pipeline dvě fáze s názvy Build a Deploy. Do hloubky se můžete podívat na kroky v rouře tak, že vyberete úlohu z podokna Fáze nebo Úlohy.
Zvolte úlohu, abyste viděli kroky pro danou úlohu.
V zobrazení kroků můžete zkontrolovat stav a podrobnosti jednotlivých kroků. V nabídce Další akce můžete přepínat časové značky nebo zobrazit surový záznam všech kroků v potrubí.
Zrušit a znovu spustit potrubí
Pokud je pipeline spuštěný, můžete ho zrušit výběrem možnosti Zrušit. Pokud bylo spuštění dokončeno, můžete potrubí znovu spustit tak, že zvolíte Spustit nový.
Nabídka Další akce spuštění kanálu
V nabídce Další akce si můžete stáhnout protokoly, přidat značky, upravit pipeline, odstranit spuštění a nakonfigurovat uchovávání pro spuštění.
Poznámka:
Pokud je spuštění zachováno, nemůžete ho odstranit. Pokud možnost Odstranit nevidíte, zvolte Zastavit zachování spuštění a pak spuštění odstraňte. Pokud se zobrazí Odstranit i Zobrazit verze uchovávání dat, pro vaše spuštění stále platí jedna nebo více nakonfigurovaných zásad uchovávání dat. Zvolte Zobrazit verze uchovávání dat, odstraňte zásady (odeberou se jenom zásady pro vybrané spuštění) a pak odstraňte spuštění.
Přidat odznak stavu do úložiště
Mnozí vývojáři chtějí ukázat, že mají vysokou kvalitu kódu tím, že v úložišti zobrazují odznáček stavu.
Zkopírování odznáčku stavu do schránky:
V Azure Pipelines přejděte na stránku Pipelines a zobrazte seznam kanálů. Vyberte kanál, který jste vytvořili v předchozí části.
Vyberte
, a poté vyberte Odznáček stavu.
Vyberte stavový odznak.
Zkopírujte ukázkový Markdown z oddílu Ukázka markdownu.
Teď, když máte odznak ve formátu Markdown ve schránce, proveďte následující kroky v GitHubu:
Přejděte do seznamu souborů a vyberte
Readme.md
. Vyberte ikonu tužky pro úpravy.Na začátek souboru vložte statusový odznak Markdown.
Potvrďte změnu ve větvi
main
.Všimněte si, že stavový odznáček se zobrazí v popisu úložiště.
Konfigurace anonymního přístupu k odznákům pro soukromé projekty:
V levém dolním rohu stránky přejděte na Nastavení projektu.
Otevřete kartu Nastavení v části Kanály
Přepnutí posuvníku Zakázat anonymní přístup k odznáčkům v části Obecné
Poznámka:
I v soukromém projektu je ve výchozím nastavení povolen anonymní přístup pomocí odznaků. S povoleným anonymním odznakovým přístupem mohou být uživatelé mimo vaši organizaci schopni vyhledávat informace, jako jsou názvy projektů, názvy větví, názvy úloh a stav sestavení prostřednictvím rozhraní API pro stav odznaku.
Vzhledem k tomu, že jste právě změnili Readme.md
soubor v tomto úložišti, Azure Pipelines automaticky sestaví váš kód podle konfigurace v azure-pipelines.yml
souboru v kořenovém adresáři vašeho úložiště. Vraťte se do Azure Pipelines a všimněte si, že se zobrazí nové spuštění. Pokaždé, když provedete úpravy, azure Pipelines spustí nové spuštění.
Ukážeme vám, jak pomocí klasického editoru v Azure DevOps Serveru 2019 vytvořit build a verzi, která vytiskne "Hello world".
Požadavky
Inicializace úložiště
Pokud už máte v projektu úložiště, můžete přejít k dalšímu kroku: Přeskočte na přidání skriptu do úložiště.
Přejděte do Azure Repos. Centrum kódu v předchozí navigaci
Pokud je projekt prázdný, zobrazí se obrazovka, která vám pomůže přidat kód do úložiště. Zvolte dolní volbu pro inicializaci úložiště pomocí
readme
souboru:
Přejděte do Azure Repos.
Přidejte soubor.
V dialogovém okně pojmenujte nový soubor a vytvořte ho.
HelloWorld.ps1
Zkopírujte a vložte tento skript.
Write-Host "Hello world"
Potvrďte (uložte ) soubor.
V tomto kurzu se zaměřujeme na CI/CD, takže část kódu udržujeme jednoduchou. Pracujeme v úložišti Git Azure Repos přímo ve webovém prohlížeči.
Až budete připraveni začít sestavovat a nasazovat skutečnou aplikaci, můžete pomocí sestavení CI Azure Pipelines používat širokou škálu klientů a služeb správy verzí. Další informace.
Vytvoření sestavovacího potrubí
Vytvořte kanál buildu, který tiskne "Ahoj světe".
Zvolte Azure Pipelines, mělo by vás to automaticky přesměrovat na Builds stránku.
Vytvořte nový pipeline.
Pro nové uživatele Azure DevOps se tím automaticky dostanete do prostředí pro vytváření procesů YAML. Pokud se chcete dostat do klasického editoru a dokončit tuto příručku, musíte vypnout funkci Preview pro nové prostředí pro vytváření kanálů YAML:
Ujistěte se, že zdroj, projekt, úložiště a výchozí větev odpovídají umístění, ve kterém jste vytvořili skript.
Začněte s prázdnou úlohou.
Na levé straně vyberte Kanál a zadejte název, který chcete použít. Ve fondu agentů vyberte Hosted VS2017.
Na levé straně vyberte znaménko plus (+) a přidejte úkol do úlohy 1. Na pravé straně vyberte kategorii Utility , ze seznamu vyberte úlohu PowerShellu a pak zvolte Přidat.
Na levé straně vyberte novou úlohu skriptu PowerShellu .
Jako argument Cesta ke skriptu vyberte
tlačítko pro procházení úložiště a vyberte skript, který jste vytvořili.
Vyberte Uložit a zařadit do fronty a pak vyberte Uložit.
Kanál buildu je entita, prostřednictvím které definujete automatizovaný kanál buildu. V build pipeline vytvoříte sadu úloh, z nichž každá provede etapu v sestavení. Katalog úkolů poskytuje bohatou sadu úkolů, se kterými můžete začít. Do sestavovacího procesu můžete také přidat skripty PowerShellu nebo shell skripty.
Publikujte artefakt ze sestavení
Typický build vytvoří artefakt, který se pak dá nasadit do různých fází ve vydané verzi. Tady si ukážeme možnosti jednoduchým způsobem. Skript jednoduše publikujeme jako artefakt.
Na kartě Úkoly vyberte znaménko plus (+) a přidejte úkol do úlohy 1.
Vyberte kategorii Utility, zvolte úlohu Publikování artefaktů sestavení a poté klikněte na Přidat.
Cesta k publikování: Vyberte tlačítko
, abyste mohli procházet a zvolit skript, který jste vytvořili.
Název artefaktu: Zadejte
drop
.Umístění publikování artefaktů: Vyberte možnost Azure Artifacts/TFS.
Artefakty jsou soubory, které chcete, aby sestavení vytvořilo. Artefakty můžou být téměř cokoli, co váš tým potřebuje k otestování nebo nasazení aplikace. Máte například spustitelné soubory .DLL a .EXE a soubor symbolů PDB pro aplikaci C# nebo C++ .NET pro Windows.
Abychom vám umožnili vytvářet artefakty, poskytujeme nástroje, jako je kopírování pomocí porovnávání vzorů, a pracovní adresář, ve kterém můžete shromáždit artefakty před jejich publikováním. Viz Artefakty ve službě Azure Pipelines.
Povolení kontinuální integrace (CI)
Vyberte kartu Spouštěče.
Povolte kontinuální integraci.
Trigger kontinuální integrace v kanálu buildu označuje, že systém by měl automaticky zařadovat nové sestavení do fronty při každém potvrzení změny kódu. Aktivační událost můžete nastavit obecněji nebo specifičtěji a také naplánovat sestavení (například každou noc). Viz Triggery sestavení.
Uložení a zařaování sestavení do fronty
Uložte a zařaďte sestavení do fronty ručně a otestujte buildovací kanál.
Vyberte Uložit a zařadit do fronty a pak vyberte Uložit a zařadit do fronty.
V dialogovém okně znovu vyberte Uložit a zařadit do fronty.
To zařadí do fronty nový build na agenta, který je hostovaný Microsoftem.
V horní části stránky se zobrazí odkaz na nový build.
Zvolte odkaz, abyste sledovali nové vytváření, jak se to děje. Po přidělení agenta se začnou zobrazovat aktuální záznamy sestavení. Všimněte si, že se skript PowerShellu spouští jako součást sestavení a že se do konzoly vytiskne text "Hello world".
Přejděte na souhrn sestavení. Na kartě Artefakty sestavení si všimněte, že skript je publikován jako artefakt.
Přidání některých proměnných a potvrzení změny do skriptu
Do skriptu předáme několik proměnných sestavení, aby byl náš pipeline trochu zajímavější. Pak provedeme změnu ve skriptu a budeme sledovat automatické spuštění CI pipeline, abychom změnu ověřili.
Upravte kanál buildu.
Na kartě Úkoly vyberte úlohu skriptu PowerShellu.
Přidejte tyto argumenty.
Argumenty
-greeter "$(Build.RequestedFor)" -trigger "$(Build.Reason)"
Nakonec uložte buildovací pipeline.
Dále přidáte argumenty do skriptu.
Přejděte na své soubory v Azure Repos (Centrum kódu v předchozí navigaci a TFS).
Vyberte soubor HelloWorld.ps1 a pak upravte soubor.
Změňte skript následujícím způsobem:
Param( [string]$greeter, [string]$trigger ) Write-Host "Hello world" from $greeter Write-Host Trigger: $trigger
Potvrďte (uložte ) skript.
Teď uvidíte výsledky změn. Přejděte na Azure Pipelines a vyberte Zařazeno do fronty. V části Zařazené do fronty nebo spuštěné si všimněte, že sestavení je automaticky spuštěno změnou, kterou jste commitovali.
Vyberte nový build, který byl vytvořen, a zobrazte jeho protokol.
Všimněte si, že osoba, která změnila kód, má své jméno vytištěné ve zprávě s pozdravem. Také uvidíte vytištěno, že se jedná o sestavení CI.
Právě jsme představili představu proměnných sestavení v rámci těchto kroků. Vytiskli jsme hodnotu proměnné, která je automaticky předdefinována a inicializována systémem. Můžete také definovat vlastní proměnné a použít je buď v argumentech pro vaše úkoly, nebo jako proměnné prostředí v rámci skriptů. Další informace o proměnných viz Proměnné sestavení.
Máte sestavovací proces. Co dále?
Vytvořili jste vývojový kanál, který automaticky sestaví a ověří jakýkoli kód, který váš tým uloží do verzovacího systému. V tomto okamžiku můžete pokračovat do další části, kde se dozvíte o release pipelines. Nebo pokud chcete, můžete přeskočit k vytvoření kanálu buildu pro vaši aplikaci.
Vytvoření vydávacího kanálu
Definujte proces spuštění skriptu ve dvou fázích.
Přejděte na kartu Pipelines (Kanály) a pak vyberte Releases (Vydané verze).
Výběrem akce vytvořte nový kanál. Pokud už je vytvořený kanál vydání, vyberte znaménko plus (+) a poté vyberte Vytvořit kanál vydání.
Vyberte akci, která má začínat prázdnou úlohou.
Pojmenujte fázi kontroly kvality.
Na panelu Artefakty vyberte + Přidat a zadejte zdroj (kanál buildu). Vyberte Přidat.
Vyberte bleskový symbol, abyste spustili průběžné nasazování, a pak na pravé straně povolte spouštěč průběžného nasazování.
Vyberte kartu Úkoly a vyberte fázi kontroly kvality.
Vyberte znaménko plus (+) pro přidání úkolu k pracovní úloze.
V dialogovém okně Přidat úkoly vyberte Nástroj, vyhledejte úlohu PowerShellu a pak vyberte tlačítko Přidat .
Na levé straně vyberte novou úlohu skriptu PowerShellu .
Pro argument Cesta ke skriptu stiskněte tlačítko
pro procházení vašich artefaktů a vyberte skript, který jste vytvořili.
Přidejte tyto argumenty:
-greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
Na kartě Pipeline vyberte fázi QA a vyberte Klonovat.
Přejmenujte klonovanou fázi Production.
Přejmenujte vydávací kanál Hello world.
Uložte vydávací pipeline.
Nasazovací kanál je soubor fází, do kterých se nasazují výsledky sestavení aplikace. Definuje také skutečný nasazovací kanál pro každou fázi a způsob, jakým se artefakty přesouvají z jedné fáze do druhé.
Všimněte si také, že jsme v argumentech skriptu použili některé proměnné. V tomto případě jsme použili proměnné verze místo proměnných sestavení, které jsme použili pro kanál sestavení.
Nasadit verzi
Spusťte skript v každé fázi.
Vytvořte novou verzi.
Po zobrazení možnosti Vytvořit novou verzi vyberte Vytvořit.
Otevřete verzi, kterou jste vytvořili.
Prohlédněte si protokoly a získejte data o vydané verzi v reálném čase.
Průběh jednotlivých verzí můžete sledovat a zjistit, jestli byla nasazena do všech fází. Můžete sledovat commity, které jsou součástí každé verze, přidružené pracovní položky a výsledky všech testovacích spuštění, která jste přidali do potrubí vydání.
Změna kódu a jeho automatické nasazení do produkčního prostředí
Provedeme ještě jednu změnu skriptu. Tentokrát se automaticky sestaví a pak se nasadí až do produkční fáze.
Přejděte do centra Kód, do záložky Soubory, upravte soubor HelloWorld.ps1 a změňte ho následujícím způsobem:
Param( [string]$greeter, [string]$trigger ) Write-Host "Hello world" from $greeter Write-Host Trigger: $trigger Write-Host "Now that you've got CI/CD, you can automatically deploy your app every time your team checks in code."
Potvrďte (uložte ) skript.
Výběrem karty Builds (Sestavení) zobrazte sestavení ve frontě a spusťte.
Po dokončení sestavení vyberte záložku Vydání, otevřete novou verzi, a pak přejděte na záložku Protokoly.
Nový kód se automaticky nasadí ve fázi kontroly kvality a pak ve fázi Produkce .
V mnoha případech byste pravděpodobně chtěli upravit vývojový kanál tak, aby došlo k produkčnímu nasazení až poté, co jsou testování a schválení zajištěny. Viz Přehled schválení a bran.
Další kroky
Dozvěděli jste se, jak vytvořit první kanál v Azure. Teď si přečtěte další informace o konfiguraci kanálů v jazyce podle vašeho výběru:
Nebo můžete pokračovat v přizpůsobení kanálu , který jste vytvořili.
Pokud chcete potrubí spustit v kontejneru, přečtěte si téma Úlohy kontejneru.
Podrobnosti o vytváření úložišť GitHub najdete v tématu Vytváření úložišť GitHub.
Pro informace o publikování artefaktů kanálu se podívejte na Publikování artefaktů kanálu.
Informace o tom, co dalšího můžete dělat v kanálech YAML, najdete v referenčních informacích ke schématu YAML.
Vyčištění
Pokud jste vytvořili nějaké testovací kanály, můžete je po dokončení snadno odstranit.
Pokud chcete kanál odstranit, přejděte na stránku souhrnu kanálu a v nabídce ... v pravém horním rohu stránky zvolte Odstranit. Zadejte název kanálu, který chcete potvrdit, a zvolte Odstranit.
Naučili jste se základy vytváření a spouštění potrubí. Teď jste připraveni nakonfigurovat kanál buildu pro programovací jazyk, který používáte. Pokračujte vytvořením nového kanálu buildu a tentokrát použijte jednu z následujících šablon.
Jazyk | Používaná šablona |
---|---|
.NET | ASP.NET |
.NET Core | ASP.NET Core |
C++ | .NET pro stolní počítače |
Jít | Přejít |
Java | Gradle |
JavaScript | Node.js |
Xcode | Xcode |
Často kladené dotazy
Kde si můžu přečíst články o DevOps a CI/CD?
Jaký systém správy verzí můžu použít?
Až budete připravení začít s CI/CD pro vaši aplikaci, můžete použít systém správy verzí podle vašeho výběru:
Klienti
Služby
- Azure Pipelines
- Poskytovatelé služeb Git, jako je Git Azure Repos, GitHub a Bitbucket Cloud
- Subversion
Klienti
Služby
- Azure Pipelines
- Poskytovatelé služeb Git, jako je GitHub a Bitbucket Cloud
- Subversion
Jak replikovat pipeline?
Pokud má váš kanál vzor, který chcete replikovat v jiných kanálech, naklonujte ho, exportujte ho nebo uložte jako šablonu.
Po naklonování potrubí můžete provést změny a potom jej uložit.
Po exportu kanálu ho můžete importovat z karty Všechny kanály .
Po vytvoření šablony ji členové týmu můžou použít podle daného vzoru v nových pipelinech.
Tip
Pokud používáte Nový Editor Sestavení, vaše vlastní šablony se zobrazují v dolní části seznamu.
Jak pracuji s koncepty?
Pokud upravujete kanál buildu a chcete otestovat některé změny, které ještě nejsou připravené pro produkční prostředí, můžete ho uložit jako koncept.
Podle potřeby můžete koncept upravit a otestovat.
Až budete připraveni, můžete návrh publikovat a změny sloučit do sestavovacího procesu.
Nebo pokud se rozhodnete koncept zahodit, můžete ho odstranit z karty Všechny kanály uvedené výše.
Jak můžu odstranit potrubí?
Pokud chcete potrubí odstranit, přejděte na stránku souhrnu pro toto potrubí a v nabídce ... v pravém horním rohu stránky zvolte Odstranit. Zadejte název kanálu, který chcete potvrdit, a zvolte Odstranit.
Sestavení můžete zařadit do fronty automaticky nebo ručně.
Když sestavení ručně přidáte do fronty, můžete pro jedno spuštění sestavení:
Zadejte pool, do kterého sestavení přejde.
Přidejte a upravte některé proměnné.
Přidejte požadavky.
V úložišti Git
V úložišti TFVC
Zadejte zdrojovou verzi jako popisek nebo sadu změn.
Spusťte privátní sestavení sady shelveset. (Tuto možnost můžete použít buď na agentovi hostovaném Microsoftem, nebo na agentovi v místním prostředí.)
Sestavení můžete zařadit do fronty automaticky nebo ručně.
Když sestavení ručně přidáte do fronty, můžete pro jedno spuštění sestavení:
Zadejte pool, do kterého sestavení přejde.
Přidejte a upravte některé proměnné.
Přidejte požadavky.
V úložišti Git
Kde se dozvím více informací o nastavení pipeline?
Další informace o nastavení pipeline najdete zde:
Jak programově vytvořím linku pro sestavení?
Referenční informace k rozhraní REST API: Vytvoření kanálu buildu
Poznámka:
Pomocí Azure Pipelines CLI můžete také spravovat buildy a kanály sestavení z příkazového řádku nebo skriptů.