Vytvoření vaší první pipeline

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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.

Další informace o různých částech kanálu YAML najdete v tématu pipeline ve schématu Azure Pipelines YAML a Usměrujte 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 GitHub, kde můžete vytvořit úložiště. Vytvořte si ho zdarma.

  • Organizace Azure DevOps. Vytvořte si ho zdarma. Pokud ho už váš tým má, ujistěte se, že jste správcem Azure DevOps projektu, 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.

Tip

S touto úlohou můžete využít umělou inteligenci dále v tomto článku nebo si můžete projít Povolit asistenci umělé inteligence s Azure DevOps MCP Server začít.

Vytvoření vaší první pipeline

Získání ukázkového kódu Java

Začněte tím, že do svého GitHub účtu forknete následující úložiště.

https://github.com/MicrosoftDocs/pipelines-java

Vytvořte své první Java pipeline

  1. V projektu Azure DevOps vyberte v levé navigační nabídce Pipelines.

  2. Vyberte Nový kanál nebo Vytvořit kanál , pokud je tento kanál první v projektu.

  3. Na obrazovce Where is your code screen, select GitHub.

  4. Můžete být přesměrováni na GitHub pro přihlášení. Pokud ano, zadejte svoje GitHub přihlašovací údaje.

  5. Na obrazovce Výběr úložiště vyberte úložiště, ve které je vaše aplikace .NET.

  6. Možná budete přesměrováni na GitHub pro instalaci aplikace Azure Pipelines. Pokud ano, vyberte Schválit a nainstalovat.

  1. Azure Pipelines bude analyzovat úložiště a doporučí šablonu kanálu Maven.

  2. 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.

  3. 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í.

  4. Až budete chtít kanál změnit, vyberte ho na stránce Pipelines a pak upravteazure-pipelines.yml soubor.

Přečtěte si další informace o práci s Javou ve vašem pipelinu.

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ů.

Snímek obrazovky koncové stránky potrubí.

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 .

Snímek obrazovky s možnostmi zobrazení běhů pipelin na vstupní stránce pipelin.

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.

Snímek obrazovky nedávno spuštěných pipeline.

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.

Snímek obrazovky běhů kanálů.

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í.

Snímek obrazovky kontextové nabídky běhu řetězce

Zobrazení podrobností kanálu

Stránka podrobností kanálu umožňuje zobrazit a spravovat tento kanál.

Snímek obrazovky se stránkou podrobností kanálu

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í.

Snímek obrazovky se souhrnem běhu kanálu

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.

Snímek obrazovky s úlohami a fázemi kanálu

Zvolte úlohu, abyste viděli kroky pro danou úlohu.

Snímek obrazovky s úlohami kanálu

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í.

Snímek obrazovky s nabídkou obsahu úkolů ve frontě

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ý.

Snímek obrazovky zrušení běhu potrubí

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í.

Snímek obrazovky se stránkou souhrnu spuštění kanálu a nabídkou dalších akcí

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.

Statusový odznáček ukazuje, že Azure pipeline byla úspěšná

Zkopírování odznáčku stavu do schránky:

  1. 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.

  2. Vyberte , a poté vyberte Odznáček stavu.

  3. Vyberte stavový odznak.

  4. Zkopírujte ukázkový Markdown z oddílu Ukázka markdownu.

Teď s odznáčkem Markdown ve schránce na GitHubu proveďte následující kroky:

  1. Přejděte do seznamu souborů a vyberte Readme.md. Vyberte ikonu tužky pro úpravy.

  2. Na začátek souboru vložte statusový odznak Markdown.

  3. Potvrďte změnu ve větvi main.

  4. 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:

  1. V levém dolním rohu stránky přejděte na Nastavení projektu.

  2. Otevřete kartu Nastavení v části Kanály

  3. 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 soubor Readme.md v tomto úložišti, Azure Pipelines kód automaticky sestaví podle konfigurace v souboru azure-pipelines.yml v kořenovém adresáři úložiště. Zpátky v Azure Pipelines sledujte, ž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 Server 2019 vytvořit build a verzi, která vytiskne "Hello world".

  1. Přejděte na Azure Repos. Centrum kódu v předchozí navigaci

    Repos soubory

  2. 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:

    Inicializace úložiště

  1. Přejděte na Azure Repos.

  2. Přidejte soubor.

    Na kartě Soubory v uzlu úložiště vyberte možnost Nový soubor.

  3. V dialogovém okně pojmenujte nový soubor a vytvořte ho.

    HelloWorld.ps1

  4. Zkopírujte a vložte tento skript.

    Write-Host "Hello world"

  5. Potvrďte (uložte ) soubor.

  1. Vyberte Azure Pipelines, měl by vás automaticky převést na stránku Builds.

    Přejít na kartu Sestavení

  2. Vytvořte nový pipeline.

    Vyberte tlačítko karty sestavení

    U nových uživatelů Azure DevOps se tím automaticky dostanete do prostředí pro vytváření kanálů 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:

    Klikněte na nastavení v pravém horním rohu obrazovky a klikněte na funkce náhledu.

    Kliknutím na přepínač vypnete funkci yaml Preview.

  3. 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.

  4. Začněte s prázdnou úlohou.

  5. Na levé straně vyberte Kanál a zadejte název, který chcete použít. Ve fondu agentů vyberte Hosted VS2017.

  6. 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.

    Přidejte úkol sestavení do procesu

  7. Na levé straně vyberte novou úlohu skriptu PowerShellu .

  8. Jako argument Cesta ke skriptu vyberte tlačítko pro procházení úložiště a vyberte skript, který jste vytvořili.

    Výběr skriptu

  9. Vyberte Uložit a zařadit do fronty a pak vyberte Uložit.

  1. Na kartě Úkoly vyberte znaménko plus (+) a přidejte úkol do úlohy 1.

  2. Vyberte kategorii Utility, zvolte úlohu Publikování artefaktů sestavení a poté klikněte na Přidat.

    Přidejte úlohu publikování artefaktu

    Cesta k publikování: Vyberte tlačítko , abyste mohli procházet a zvolit skript, který jste vytvořili.

    Název artefaktu: Zadejte drop.

    Lokace publikováníArtifact: Vyberte Azure Artifacts/TFS.

  1. Vyberte Uložit a zařadit do fronty a pak vyberte Uložit a zařadit do fronty.

  2. 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.

  3. V horní části stránky se zobrazí odkaz na nový build.

    konzola sestavení

    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".

    Sledujte v konzole sestavení

  4. Přejděte na souhrn sestavení. Na kartě Artefakty sestavení si všimněte, že skript je publikován jako artefakt.

    Otevření konzoly sestavení a zobrazení artefaktu

Otevření úlohy PowerShellu v konzole sestavení

Teď uvidíte výsledky změn. Přejděte na Azure Pipelines a vyberte Queued. 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.

Sestavení souhrnného protokolu skriptů PowerShellu

  1. Přejděte na kartu Pipelines (Kanály) a pak vyberte Releases (Vydané verze).

  2. 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í.

  3. Vyberte akci, která má začínat prázdnou úlohou.

  4. Pojmenujte fázi kontroly kvality.

  5. Na panelu Artefakty vyberte + Přidat a zadejte zdroj (kanál buildu). Vyberte Přidat.

  6. Vyberte bleskový symbol, abyste spustili průběžné nasazování, a pak na pravé straně povolte spouštěč průběžného nasazování.

    Výběr blesku pro aktivaci průběžného nasazování

  7. Vyberte kartu Úkoly a vyberte fázi kontroly kvality.

  8. Vyberte znaménko plus (+) pro přidání úkolu k pracovní úloze.

  9. V dialogovém okně Přidat úkoly vyberte Nástroj, vyhledejte úlohu PowerShellu a pak vyberte tlačítko Přidat .

  10. Na levé straně vyberte novou úlohu skriptu PowerShellu .

  11. Pro argument Cesta ke skriptu stiskněte tlačítko pro procházení vašich artefaktů a vyberte skript, který jste vytvořili.

  12. Přidejte tyto argumenty:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"

  13. Na kartě Pipeline vyberte fázi QA a vyberte Klonovat.

    Naklonujte provozní prostředí v QA

  14. Přejmenujte klonovanou fázi Production.

  15. Přejmenujte vydávací kanál Hello world.

    Přejmenujte vydavatelský kanál Hello World

  16. Uložte vydávací pipeline.

  1. Vytvořte novou verzi.

    Vytvořit verzi – DevOps 2019 a 2020

    Po zobrazení možnosti Vytvořit novou verzi vyberte Vytvořit.

  2. Otevřete verzi, kterou jste vytvořili.

    Vytvořeno vydání – DevOps 2019 a 2020

  3. Prohlédněte si protokoly a získejte data o vydané verzi v reálném čase.

    Protokoly vydaných verzí – DevOps 2019 a 2020

Poslední protokol kroku uvolňovacího skriptu – DevOps 2019 a 2020

Použijte AI k vytvoření svého prvního pipeline

Pokud nakonfigurujete Azure DevOps MCP Server, můžete získat pomoc s vytvářením, porozuměním a řešením potíží s prvním kanálem pomocí přirozeného jazyka.

Začínáme

Úkol Příklad výzvy
Vytvořte počáteční pipelinu Create a basic pipeline YAML for this repo in project <Contoso>
Minimální kanál buildu What's the smallest pipeline that will build this project in <Contoso>?
Vysvětlení YAML kanálu Explain each section of this pipeline YAML in <Contoso>
Vyberte pool agentů Which agent pool should I use for this project in <Contoso>?
Pomoc s lešením Help me create my first pipeline for this repo in <Contoso>

Ověření oprávnění a přístupu

Úkol Příklad výzvy
Kontrola přístupu k úložišti Can this pipeline access the repo in project <Contoso>?
Ověřte oprávnění pro službu sestavení Does the build service have permission to run pipelines in project <Contoso>?
Přístup k publikování artefaktů Will this pipeline be able to publish artifacts in <Contoso>?
Požadavky na agenta Does this repo require a Microsoft-hosted or self-hosted agent in <Contoso>?
Výběr operačního systému What OS should the pipeline run on for this project in <Contoso>?

Řešení potíží se selháními při prvním spuštění

Úkol Příklad výzvy
Ladění selhání při prvním spuštění Why did my first pipeline fail in project <Contoso>?
Vysvětlení chyby Explain this pipeline error in plain English for project <Contoso>
Identifikace neúspěšného kroku What step failed and why in the latest run for <Contoso>?
Nápověda k chybě oprávnění Why would a new pipeline fail with a permission error in <Contoso>?
Zaměřená oprava How do I fix this error without changing the entire pipeline in <Contoso>?

Optimalizace a rozšíření

Úkol Příklad výzvy
Připravenost na produkční prostředí What's missing from this pipeline for a production repo in <Contoso>?
Ověření PR Should I add PR validation to this pipeline in <Contoso>?
Kontroly zabezpečení What security scans are recommended for first pipelines in <Contoso>?
Běžné další kroky What steps are commonly added after the initial pipeline in <Contoso>?
Doporučení pro spouštěče What triggers should I use for my first pipeline in <Contoso>?
Možnosti agenta Do we already have custom agent capabilities this pipeline needs in <Contoso>?
Navrhnout vylepšení Suggest improvements to this pipeline in <Contoso>

Tip

Pokud používáte Visual Studio Code, je režim agenta užitečný hlavně pro generování nových kanálů a řešení potíží se selháními při prvním spuštění.

Další kroky

Naučili jste se, jak vytvořit svůj první pipeline 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 sestavení úložišť GitHub najdete v tématu Sestavení ú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.

Odstranit potrubí

časté otázky

Kde si můžu přečíst články o DevOps a CI/CD?

Co je kontinuální integrace?

Co je průběžné doručování?

Co je DevOps?

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:

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.

všechny-definice-sestavení-akční-menu-replikovat-akce

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.

uložit jako koncept

Upravit koncept – DevOps 2019 a 2020

Zveřejnit koncept – DevOps 2019 a 2020

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.

Co dalšího můžu dělat, když zařadím sestavení do fronty?

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í:

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 spravovat buildy a sestavovací kanály z příkazového řádku nebo skriptů.

  • Last updated on