Skapa din första pipeline
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Det här är en stegvis guide till hur du använder Azure Pipelines för att skapa ett exempelprogram från en Git-lagringsplats. Den här guiden använder YAML-pipelines som konfigurerats med YAML-pipelineredigeraren. Om du vill använda klassiska pipelines i stället kan du läsa Definiera din klassiska pipeline. Vägledning om hur du använder TFVC finns i Skapa TFVC-lagringsplatser.
Förutsättningar – Azure DevOps
Se till att du har följande objekt:
Ett GitHub-konto där du kan skapa en lagringsplats. Skapa en kostnadsfritt.
En Azure DevOps-organisation. Skapa en kostnadsfritt. Om ditt team redan har ett kontrollerar du att du är administratör för det Azure DevOps-projekt som du vill använda.
En möjlighet att köra pipelines på Microsoft-värd-agenter. Om du vill använda agenter som är värdbaserade hos Microsoft måste din Azure DevOps-organisation ha åtkomst till parallella jobb värdbaserade hos Microsoft. Du kan antingen köpa ett parallellt jobb eller begära ett kostnadsfritt bidrag.
Skapa din första pipeline
Hämta Java-exempelkoden
Kom igång genom att förgrena följande lagringsplats till ditt GitHub-konto.
https://github.com/MicrosoftDocs/pipelines-java
Skapa din första Java-pipeline
Logga in på din Azure DevOps-organisation och gå till projektet.
Gå till Pipelines och välj sedan Ny pipeline eller Skapa pipeline om du skapar din första pipeline.
Utför stegen i guiden genom att först välja GitHub som plats för källkoden.
Du kan omdirigeras till GitHub för att logga in. I så fall anger du dina GitHub-autentiseringsuppgifter.
När du ser listan över lagringsplatser väljer du din lagringsplats.
Du kan omdirigeras till GitHub för att installera Azure Pipelines-appen. I så fall väljer du Godkänn och installera.
Azure Pipelines analyserar lagringsplatsen och rekommenderar Maven-pipelinemallen .
När den nya pipelinen visas kontrollerar du YAML-filen för att se vad den gör. När du är klar väljer du Spara och kör.
Du uppmanas att ladda upp en ny
azure-pipelines.ymlfil till lagringsplatsen. När du är nöjd med meddelandet väljer du Spara och kör igen.Om du vill se din pipeline i praktiken väljer du byggjobbet.
Du har precis skapat och kört en pipeline som vi skapade automatiskt åt dig, eftersom koden verkade vara en bra matchning för Maven-mallen .
Nu har du en fungerande YAML-pipeline (
azure-pipelines.yml) på din lagringsplats som är redo att anpassas!När du är redo att göra ändringar i din pipeline väljer du den på Pipelines-sidan och sedan redigerar du den
azure-pipelines.ymlfilen.
Läs mer om att arbeta med Java i din pipeline.
Visa och hantera dina pipelines
Du kan visa och hantera dina pipelines genom att välja Pipelines på den vänstra menyn för att gå till landningssidan för pipelines.
Från landningssidan för pipelines kan du granska pipelines och pipelinekörningar, skapa och importera pipelines, hantera säkerhet och närmare granska detaljer i pipelines och körningar.
Välj Senaste för att visa pipelines som nyligen körts (standardvyn) eller välj Alla för att visa alla pipelines.
Välj en pipeline för att hantera pipelinen och visa körningarna. Välj versionsnumret för den senaste körningen för att visa resultatet av bygget, välj grennamnet för att visa grenen för den körningen eller välj snabbmenyn för att köra pipelinen och utföra andra hanteringsåtgärder.
Välj Körningar för att visa alla pipeline-körningar. Du kan valfritt filtrera de visade körningarna.
Välj en pipelinekörning för att visa information om den körningen.
Du kan välja att behålla eller ta bort en körning från snabbmenyn. Mer information om körningskvarhållning finns i Skapa och släppa kvarhållningsprinciper.
Visa pipeline detaljer
På informationssidan för en pipeline kan du visa och hantera pipelinen.
Välj Redigera för att redigera din pipeline. Mer information finns i YAML-pipelineredigeraren. Du kan också redigera din pipeline genom att ändra azure-pipelines.yml-filen direkt på lagringsplatsen som är värd för pipelinen.
Visa information om pipelinekörning
I sammanfattningen av pipelinekörningen kan du se över statusen för din körning, både när den körs och när den är klar.
I sammanfattningspanelen kan du se jobb- och steguppgifter, ladda ner artefakter och navigera till relaterade åtaganden, testresultat och arbetsobjekt.
Jobb och faser
Fönstret Jobb visar en översikt över statusen för dina steg och jobb. Det här fönstret kan ha flera flikar beroende på om din pipeline har faser och jobb, eller bara jobb. I det här exemplet har pipelinen två steg med namnet Build och Deploy. Du kan fördjupa dig i stegen i pipelinen genom att välja jobbet från antingen Steg eller Jobb-fönstret.
Välj ett jobb för att se stegen för jobbet.
Från stegvyn kan du granska status och information om varje steg. Från Fler åtgärder
kan du växla tidsstämplar eller visa en rålogg med alla steg i pipelinen.
Avbryt och kör en pipeline igen
Om pipelinen körs kan du avbryta den genom att välja Avbryt. Om körningen har slutförts kan du köra pipelinen igen genom att välja Kör ny.
Menyn Pipeline kör fler åtgärder
På menyn Fler åtgärder kan du ladda ned loggar, lägga till taggar, redigera pipelinen, ta bort körningen och konfigurera kvarhållning för körningen.
Anteckning
Du kan inte ta bort en körning om den bevaras. Om du inte ser Ta bort väljer du Sluta spara körningen och tar sedan bort den. Om du ser både Ta bort och Visa kvarhållningsversioner, gäller fortfarande en eller flera konfigurerade kvarhållningsprinciper för din körning. Välj View retention releases (Visa kvarhållningsversioner), ta bort principerna (endast principerna för den valda körningen tas bort) och ta sedan bort körningen.
Lägga till ett statusmärke på lagringsplatsen
Många utvecklare vill visa att de håller kodkvaliteten hög genom att visa ett statusmärke på lagringsplatsen.
Så här kopierar du statusmärket till urklipp:
I Azure Pipelines går du till sidan Pipelines för att visa listan över pipelines. Välj den pipeline som du skapade i föregående avsnitt.
Välj
och välj sedan Statusmärke.Välj Status-märke.
Kopiera markdown-exemplet från avsnittet Exempelmarkering.
Nu när du har märket Markdown i ditt urklipp, följ dessa steg i GitHub:
Gå till listan med filer och välj
Readme.md. Välj pennikon för att redigera.Klistra in statusmärket Markdown i början av filen.
Utför ändringen på grenen
main.Observera att statusikonen visas i beskrivningen av lagringsplatsen.
Så här konfigurerar du anonym åtkomst till märken för privata projekt:
Gå till Projektinställningar i det nedre vänstra hörnet på sidan
Öppna fliken Inställningar under Pipelines
Växla skjutreglaget Inaktivera anonym åtkomst till märken under Allmänt
Kommentar
Även i ett privat projekt är anonym märkesåtkomst aktiverad som standard. När anonym märkesåtkomst är aktiverad kan användare utanför organisationen kanske fråga efter information som projektnamn, grennamn, jobbnamn och byggstatus via api:et för aktivitetsstatus.
Eftersom du precis har ändrat den här Readme.md filen i lagringsplatsen, bygger Azure Pipelines automatiskt din kod enligt konfigurationen i azure-pipelines.yml filen i roten av lagringsplatsen. Gå tillbaka till Azure Pipelines och observera att en ny körning visas. Varje gång du redigerar startar Azure Pipelines en ny körning.
Vi visar hur du använder den klassiska redigeraren i Azure DevOps Server 2019 för att skapa ett build och en version som skriver ut "Hello world".
Förutsättningar
Initiera lagringsplatsen
Om du redan har en lagringsplats i projektet kan du gå vidare till nästa steg: Hoppa till att lägga till ett skript på lagringsplatsen
Gå till Azure Repos. (Den Code-hubben i föregående navigering)
Om projektet är tomt får du en skärm som hjälper dig att lägga till kod på lagringsplatsen. Välj det nedre valet för att initiera lagringsplatsen med en
readmefil:
Gå till Azure Repos.
Lägg till en fil.
I dialogrutan namnger du den nya filen och skapar den.
HelloWorld.ps1Kopiera och klistra in det här skriptet.
Write-Host "Hello world"Checka in (spara) filen.
I den här handledningen fokuserar vi på CI/CD, så vi håller koddelen enkel. Vi arbetar på en Azure Repos Git-lagringsplats direkt i webbläsaren.
När du är redo att börja skapa och distribuera en riktig app kan du använda ett brett utbud av versionskontrollklienter och tjänster med Azure Pipelines CI-versioner. Läs mer.
Skapa en build pipeline
Skapa en byggpipeline som skriver ut "Hello world".
Välj Azure Pipelines, så bör det automatiskt ta dig till Byggen-sidan.
Skapa en ny pipeline.
För nya användare av Azure DevOps kommer detta automatiskt att leda dig till skapandeprocessen för YAML-pipelins. För att komma till den klassiska redigeraren och slutföra den här guiden måste du inaktivera förhandsgranskningsfunktionen för den nya YAML-pipeline-skapande erfarenheten:
Kontrollera att käll-, projekt-, lagringsplatsen och standardgrenen matchar den plats där du skapade skriptet.
Börja med ett tomt jobb.
Till vänster väljer du Pipeline och anger vilket namn du vill använda. För agentpoolen ska du välja Hosted VS2017.
Till vänster väljer du plustecknet ( + ) för att lägga till en uppgift i Jobb 1. Till höger väljer du kategorin Verktyg , väljer PowerShell-aktiviteten i listan och väljer sedan Lägg till.
Välj den nya PowerShell-skriptuppgiften till vänster.
För argumentet Skriptsökväg väljer du
knappen för att bläddra i lagringsplatsen och väljer det skript som du skapade.
Välj Spara & kö, och sedan välj Spara.
En byggpipeline är den entitet genom vilken du definierar din automatiserade bygg-pipeline. I bygg-pipelinen skapar du en uppsättning uppgifter som var och en utför ett steg i bygget. Aktivitetskatalogen innehåller en omfattande uppsättning uppgifter som du kan komma igång med. Du kan också lägga till PowerShell- eller shell-skript i bygg-pipelinen.
Publicera en artefakt från din version
En typisk version skapar en artefakt som sedan kan distribueras till olika steg i en version. För att demonstrera funktionen på ett enkelt sätt publicerar vi helt enkelt skriptet som artefakt.
På fliken Uppgifter väljer du plustecknet ( + ) för att lägga till en aktivitet i Jobb 1.
Välj kategorin Verktyg, välj aktiviteten Publicera byggartefakter och välj sedan Lägg till.
Sökväg att publicera: Välj
knappen för att bläddra och välj det skript som du skapade.Artefaktnamn: Ange
drop.Artefaktpubliceringsplats: Välj Azure Artifacts/TFS.
Artefakter är de filer som du vill att bygget ska producera. Artefakter kan vara nästan vad som helst som ditt team behöver för att testa eller distribuera din app. Du har till exempel en .DLL och .EXE körbara filer och . PDB-symbolfilen för en C#- eller C++ .NET Windows-app.
För att du ska kunna skapa artefakter tillhandahåller vi verktyg som kopiering med mönstermatchning och en mellanlagringskatalog där du kan samla in artefakter innan du publicerar dem. Se Artefakter i Azure Pipelines.
Aktivera kontinuerlig integrering (CI)
Välj fliken Utlösare .
Aktivera kontinuerlig integration.
En utlösare för kontinuerlig integrering på en byggpipeline anger att systemet automatiskt ska köa en ny version när en kodändring genomförs. Du kan göra utlösaren mer allmän eller mer specifik och även schemalägga ditt bygge (till exempel per natt). Se Skapa utlösare.
Spara och ställ bygget i kö
Spara och köa ett bygge manuellt och testa byggpipelines.
Välj Spara & kö och välj Spara & kö.
I dialogrutan väljer du Spara och köa igen.
Detta köar en ny kompilering på den Microsoft-värd agenten.
Du ser en länk till det nya bygget överst på sidan.
Välj länken för att se den nya versionen när det händer. När agenten har allokerats kan du börja se liveloggarna för kompileringen. Observera att PowerShell-skriptet körs som en del av bygget och att "Hello world" skrivs ut till konsolen.
Gå till byggsammanfattningen. Observera att skriptet publiceras som en artefakt på fliken Artefakter i bygget.
Lägg till några variabler och genomför en ändring i skriptet
Vi skickar några byggvariabler till skriptet för att göra pipelinen lite mer intressant. Sedan genomför vi en ändring av ett skript och ser ci-pipelinen köras automatiskt för att verifiera ändringen.
Redigera byggpipeline.
På fliken Uppgifter väljer du PowerShell-skriptaktiviteten.
Lägg till dessa argument.
Argument
-greeter "$(Build.RequestedFor)" -trigger "$(Build.Reason)"
Slutligen, spara pipelinen.
Därefter lägger du till argumenten i skriptet.
Gå till dina Filer i Azure Repos (Code-hubben i den tidigare navigeringen och TFS).
Välj filen HelloWorld.ps1 och sedan Redigera filen.
Ändra skriptet på följande sätt:
Param( [string]$greeter, [string]$trigger ) Write-Host "Hello world" from $greeter Write-Host Trigger: $triggerChecka in (spara) skriptet.
Nu kan du se resultatet av dina ändringar. Gå till Azure Pipelines och välj Köad. Observera under avsnittet Köad eller aktiv att en build automatiskt utlöses av den ändring som du har begått.
Välj den nya versionen som skapades och visa loggen.
Observera att personen som ändrade koden har skrivit ut sitt namn i hälsningsmeddelandet. Du ser också utskrivet att det här var en CI-kompilering.
Vi har precis introducerat begreppet byggvariabler i de här stegen. Vi printade värdet för en variabel som automatiskt fördefinierades och initierades av systemet. Du kan också definiera anpassade variabler och använda dem antingen i argument till dina uppgifter eller som miljövariabler i skripten. Mer information om variabler finns i Skapa variabler.
Du har en byggkedja. Vad händer härnäst?
Du har skapat en byggpipeline som automatiskt skapar och validerar den kod som kontrolleras av ditt team. Nu kan du fortsätta till nästa avsnitt för att lära dig mer om utgivningspipelines. Eller, om du vill, kan du gå vidare för att skapa en bygg-pipeline för din app.
Skapa en versionspipeline
Definiera processen för att köra skriptet i två steg.
Gå till fliken Pipelines och välj sedan Versioner.
Välj åtgärden för att skapa en ny pipeline. Om en versionspipeline redan har skapats väljer du plustecknet ( + ) och väljer sedan Skapa en versionspipeline.
Välj åtgärden för att börja med ett tomt jobb.
Namnge fasen QA.
I artefaktpanelen väljer du + Lägg till och anger en källa (byggpipelin). Markera Lägga till.
Välj blixten för att utlösa kontinuerlig distribution och aktivera sedan utlösaren för kontinuerlig distribution till höger.
Välj fliken Uppgifter och välj din QA-fas .
Välj plustecknet ( + ) för jobbet för att lägga till en uppgift i jobbet.
I dialogrutan Lägg till aktiviteter väljer du Verktyg, letar upp PowerShell-aktiviteten och väljer sedan knappen Lägg till.
Välj den nya PowerShell-skriptuppgiften till vänster.
För argumentet Skriptsökväg väljer du
knappen för att bläddra bland artefakterna och väljer skriptet som du skapade.Lägg till följande argument:
-greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"På fliken Pipeline väljer du QA-fasen och väljer Klona.
Byt namn på den klonade fasen Produktion.
Byt namn på versionspipelinen Hello World.
Spara utgivningspipen.
En release-pipeline är en samling steg som artefakter från applikationsbygget distribueras till. Den definierar också den faktiska distributionspipelinen för varje steg, samt hur artefakterna befordras från en fas till en annan.
Observera också att vi använde vissa variabler i våra skriptargument. I det här fallet använde vi release-variabler i stället för de byggvariabler som vi använde för bygg-pipelinen.
Lansera en utgåva
Kör skriptet i varje steg.
Skapa en ny version.
När Skapa ny version visas väljer du Skapa.
Öppna den version som du skapade.
Visa loggarna för att hämta realtidsdata om versionen.
Du kan spåra förloppet för varje version för att se om den har distribuerats till alla faser. Du kan spåra incheckningar som ingår i varje version, tillhörande arbetsobjekt och resultaten av alla testkörningar som du har lagt till i versionspipelinen.
Ändra din kod och se den distribueras automatiskt till produktion
Vi gör ytterligare en ändring i skriptet. Den här gången skapas den automatiskt och distribueras sedan hela vägen till produktionsfasen.
Gå till fliken Kodhubb, Filer, redigera Filen HelloWorld.ps1 och ändra den på följande sätt:
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."Kommittera (spara) skriptet.
Välj fliken Bygg för att se bygg som är köade och körda.
När bygget är klart väljer du fliken Versioner, öppnar den nya versionen och går sedan till loggarna.
Den nya koden distribueras automatiskt i QA-fasen och sedan i produktionsfasen .
I många fall skulle du förmodligen vilja redigera versionspipelinen så att produktionsdistributionen bara sker efter att vissa tester och godkännanden har införts. Se Översikt över godkännanden och grindar.
Nästa steg
Du har lärt dig hur du skapar din första pipeline i Azure. Läs nu mer om hur du konfigurerar pipelines på valfritt språk:
Eller så kan du fortsätta att anpassa pipelinen som du skapade.
Information om hur du kör din pipeline i en container finns i Containerjobb.
Mer information om hur du skapar GitHub-lagringsplatser finns i Skapa GitHub-lagringsplatser.
Information om hur du publicerar pipelineartefakter finns i Publicera pipelineartefakter.
Mer information om vad du kan göra i YAML-pipelines finns i YAML-schemareferens.
Rensa
Om du har skapat några testpipelines är det enkelt att ta bort dem när du är klar med dem.
Om du vill ta bort en pipeline går du till sammanfattningssidan för pipelinen och väljer Ta bort från menyn ... längst upp till höger på sidan. Skriv namnet på pipelinen för att bekräfta och välj Ta bort.
Du har lärt dig grunderna i att skapa och köra en pipeline. Nu är du redo att konfigurera bygg-pipelinen för det programmeringsspråk som du använder. Gå vidare och skapa en ny build-pipeline och använd den här gången någon av följande mallar.
| Språk | Mall som ska användas |
|---|---|
| .NET | ASP.NET |
| .NET Core | ASP.NET Core |
| C++ | .NET-skrivbord |
| Kör | Kör |
| Java | Gradle |
| JavaScript | Node.js |
| Xcode | Xcode |
Vanliga frågor
Var kan jag läsa artiklar om DevOps och CI/CD?
Vad är kontinuerlig integrering?
Vilket versionskontrollsystem kan jag använda?
När du är redo att komma igång med CI/CD för din app kan du använda det versionskontrollsystem du väljer:
Klienter
Tjänster
- Azure Pipelines
- Git-tjänstleverantörer som Azure Repos Git, GitHub och Bitbucket Cloud
- Subversion
Klienter
Tjänster
- Azure Pipelines
- Git-tjänstleverantörer som GitHub och Bitbucket Cloud
- Subversion
Hur gör jag för att replikera en pipeline?
Om din pipeline har ett mönster som du vill replikera i andra pipelines klonar du den, exporterar den eller sparar den som en mall.
När du har klonade en pipeline kan du göra ändringar och sedan spara den.
När du har exporterat en pipeline kan du importera den från fliken Alla pipelines .
När du har skapat en mall kan dina teammedlemmar använda den för att följa mönstret i nya pipelines.
Dricks
Om du använder Nya byggredigeraren, visas dina anpassade mallar längst ned i listan.
Hur gör jag för att arbeta med utkast?
Om du redigerar en bygg-pipeline och vill testa några ändringar som ännu inte är klara för produktion kan du spara den som ett utkast.
Du kan redigera och testa ditt utkast efter behov.
När du är redo kan du publicera utkastet för att sammanfoga ändringarna i bygglinjen.
Om du väljer att ta bort utkastet kan du ta bort det från fliken All Pipeline som visas ovan.
Hur tar jag bort en pipeline?
Om du vill ta bort en pipeline går du till sammanfattningssidan för pipelinen och väljer Ta bort från menyn ... längst upp till höger på sidan. Skriv namnet på pipelinen för att bekräfta och välj Ta bort.
Du kan köa byggningar automatiskt eller manuellt.
När du köar en kompilering manuellt kan du för en enda omgång av bygget:
Ange den pool som bygget ska användas i.
Lägg till och ändra vissa variabler.
Lägg till krav.
På en Git-lagringsplats
På en TFVC-lagringsplats
Ange källversionen som en etikett eller ändringsuppsättning.
Kör en privat version av en hyllor. (Du kan använda det här alternativet på antingen en Microsoft-värdbaserad agent eller en lokalt installerad agent.)
Du kan köa byggen automatiskt eller manuellt.
När du köar en version manuellt kan du för en enda körning av bygget:
Var kan jag lära mig mer om pipelineinställningar?
Mer information om pipelineinställningar finns i:
Hur gör jag för att skapa en byggpipeline programmatiskt?
REST API-referens: Skapa en byggpipeline
Anteckning
Du kan också hantera byggen och skapa pipelines från kommandoraden eller skripten med hjälp av Azure Pipelines CLI.