Övning – Skapa och köra en grundläggande pipeline

  • 7 minuter

Viktigt!

Du behöver en egen Azure-prenumeration för att utföra den här övningen, och avgifter kan tillkomma. Om du inte redan har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Du vill automatisera distributionen av uppdateringar till leksaksföretagets webbplats. Som ett första steg skapar du en grundläggande pipeline i Azure DevOps.

I den här övningen kommer du att:

  • Skapa en Azure DevOps-organisation och ett projekt.
  • Skapa en grundläggande pipeline.
  • Kör din grundläggande pipeline.

Skapa ett projekt i Azure DevOps

  1. Gå till dev.azure.com i en webbläsare. Logga in eller skapa ett nytt konto.

  2. Om du har skapat ett nytt konto följer du anvisningarna för att skapa en Azure DevOps-organisation. Azure DevOps uppmanar dig sedan att skapa ett nytt projekt. Fortsätt till nästa steg för att konfigurera projektet.

    Om du har loggat in på en befintlig Azure DevOps-organisation väljer du Nytt projekt för att skapa ett nytt projekt.

    Skärmbild av Azure DevOps med knappen Nytt projekt markerat.

  3. I fönstret Skapa ett projekt för att komma igång anger du följande information för ditt nya projekt:

    • Projektnamn: Använd ett beskrivande men kort namn. I den här övningen anger du leksakswebbplatsen.
    • Beskrivning: Ange en beskrivning av projektets syfte. I den här övningen anger du Företagets webbplats för Leksak.
    • Synlighet: Du kan använda Azure DevOps för att skapa offentliga och privata lagringsplatser. I det här fallet bör lagringsplatsen vara privat eftersom företagets webbplatsfiler endast ska nås av personer i din organisation. Du kan bevilja åtkomst till andra användare senare.

    Projektkonfigurationen bör se ut så här:

    Skärmbild av fönstret Skapa ett projekt för att komma igång med Azure DevOps som visar projektnamn och synlighetsalternativ markerade.

  4. Välj Skapa projekt.

Klona lagringsplatsen

  1. I fönstret Välkommen eller på resursmenyn väljer du Lagringsplatser.

    Skärmbild av välkomstfönstret som visar ikonerna För lagringsplatser markerade i fönstret och på resursmenyn.

  2. Om du använder macOS behöver du ett särskilt lösenord för att klona Git-lagringsplatsen. Välj Generera Git-autentiseringsuppgifter och kopiera användarnamnet och lösenordet som visas till en säker plats.

  3. I avsnittet Klona till datorn väljer du Klona i VS Code. Om du uppmanas att tillåta att Visual Studio Code öppnas väljer du Öppna.

    Skärmbild som visar lagringsplatsens inställningar med knappen Klona i VS Code markerad.

  4. Om en dialogruta visas, där du uppmanas att tillåta att ett tillägg öppnar lagringsplatsens URI, väljer du Öppna.

  5. Skapa en mapp på din lokala enhet som ska användas för den här lagringsplatsen och välj sedan Välj som lagringsplats.

  6. Om du använder den här lagringsplatsen för första gången uppmanas du att logga in.

    För Windows anger du samma autentiseringsuppgifter som du använde för att logga in på Azure DevOps tidigare i den här övningen.

    För macOS anger du det Git-användarnamn och lösenord som du genererade för en stund sedan.

  7. Visual Studio Code uppmanar dig att öppna lagringsplatsen. Välj Öppna.

    Skärmbild av dialogrutan Visual Studio Code för att öppna den klonade lagringsplatsen med knappen Öppna markerad.

Installera Azure Pipelines-tillägget

Microsoft publicerar ett Azure Pipelines-tillägg för Visual Studio Code. Tillägget kan hjälpa dig att skriva YAML-filer för pipeline. Det är en bra idé att installera det här tillägget, så dina YAML-filer verifieras när du arbetar.

  1. I Visual Studio Code väljer du Visa>tillägg (genväg är Ctrl+Skift+x).

  2. I rutan Sök anger du Azure Pipelines och väljer sedan Azure Pipelines-tillägget som publicerats av Microsoft. Välj Installera.

    Skärmbild av Visual Studio Code Extensions-menyn med Azure Pipelines-tillägget från Microsoft och knappen Installera markerad.

Skapa en YAML-pipelinedefinition

Nu när du har skapat din organisation, ditt projekt och din lagringsplats är du redo att skapa en grundläggande pipelinedefinition.

  1. Öppna Utforskaren i Visual Studio Code.

  2. Hovra över projektmappen TOY-WEBSITE i Utforskaren och välj ikonen Ny mapp. Namnge mappen som distribueras.

  3. Välj mappen distribuera och välj ikonen Ny fil i projektet TOY-WEBSITE . Namnge filen azure-pipelines.yml.

    Skärmbild av Visual Studio Code Explorer som visar mappen deploy och azure-pipelines dot Y M L-filen som nyss skapades.

  4. YML-filen är öppen i huvudpanelen. Klistra in följande pipelinedefinitionskod i filen:

    trigger: none

pool:
  vmImage: ubuntu-latest

jobs:
- job:
  steps:
  - script: echo Hello world!
    displayName: 'Placeholder step'

  5. Spara ändringarna i filen.

  6. Öppna ett Terminalfönster i Visual Studio Code genom att välja Terminal>Ny terminal.

    Ett terminalfönster öppnas, vanligtvis på den nedre halvan av skärmen.

  7. Om du vill checka in och push-överföra azure-pipelines.yml-filen till din Git-lagringsplats klistrar du in den här koden i terminalpanelen och trycker sedan på Retur.

    git add deploy/azure-pipelines.yml
git commit -m "Add initial pipeline definition"
git push

Konfigurera pipelinen i Azure Pipelines

Du har skapat en pipelinedefinition. Registrera sedan pipelinen med Azure Pipelines.

  1. På resursmenyn i Azure DevOps-sessionen väljer du Pipelines och i fönstret Skapa din första pipeline väljer du Skapa pipeline.

    Skärmbild av skapa ditt första pipelinefönster med Pipelines markerade i resursmenyn Knappen Skapa pipeline markerad.

  2. I fönstret Var är din kod på fliken Anslut väljer du Azure Repos Git.

    Skärmbild av var är ditt kodfönster med Git-alternativet Azure Repos valt.

  3. I fönstret Välj en lagringsplats på fliken Välj en lagringsplats väljer du leksakswebbplats.

    Skärmbild som visar fliken Konfigurera din pipeline med den valda lagringsplatsen för leksakswebbplatsen.

  4. På fliken Konfigurera i fönstret Konfigurera pipeline väljer du Befintlig YAML-fil för Azure Pipelines.

    Skärmbild som visar det befintliga YAML-filalternativet för Azure Pipelines markerat.

  5. I listrutan Välj en befintlig YAML-fil väljer du /deploy/azure-pipelines.yml och väljer sedan Fortsätt.

    Skärmbild av fönstret Välj en befintlig YAML-fil i Azure DevOps med sökvägen inställd på pipelinefilen och knappen Fortsätt markerad.

    Fliken Granska yaml-fönstret Granska din pipeline visar din YAML-pipelinedefinition som en ny pipeline.

    Dricks

    Azure Pipelines-webbgränssnittet innehåller ett redigeringsprogram som du kan använda för att hantera din pipelinedefinition. I den här modulen arbetar du med definitionsfilen i Visual Studio Code, men du kan utforska Azure Pipelines-redigeraren för att se hur den fungerar.

  6. Markera Kör.

    Skärmbild som visar steget Skapa pipelineflödesgranskning med knappen Kör markerad.

    Azure Pipelines skapar pipelinen och startar en första körning.

Verifiera pipelinekörningen

Viktigt!

Om det här är första gången du använder pipelines i den här Azure DevOps-organisationen kan du få ett felmeddelande om att:

Ingen värdbaserad parallellitet har köpts eller beviljats.

För att skydda mot missbruk kräver Azure DevOps att nya organisationer godkänns innan de kan använda Microsoft-värdbaserade pipelineagenter utan kostnad.

Om du vill begära att din Azure DevOps-organisation beviljas åtkomst till kostnadsfria pipelineagenter fyller du i det här formuläret.

  1. När pipelinekörningen startar visar en sida information om körningen.

    Skärmbild som visar pipelinen med jobbet i kötillståndet.

    Varje pipelinekörning innehåller en identifierare. Du kan använda den här identifieraren för att hitta en specifik pipelinekörning.

    Jobbstatusen visas ursprungligen som I kö. Din pipeline kanske inte startar omedelbart. Jobbet läggs till i en kö för en agent. När en agent är tillgänglig tilldelar Azure Pipelines agenten och startar jobbet. Jobbstatusen blir sedan Körs.

    Sidan innehåller grennamnet och identifieraren för Git-incheckningen av körningen som används. Den här informationen anger vilken version av lagringsplatsens innehåll som pipelinen använde.

  2. Uppdatera sidan tills jobbstatusen ändras till Lyckades. Välj Sedan Jobb under Jobb.

    Skärmbild som visar pipelinen med jobbet med statusen Lyckades och jobbnamnet markerat.

  3. Jobbinformationssidan visar loggen för de steg som pipelinen körde. Platshållarsteget visas i stegen i den vänstra menyn.

    Skärmbild som visar pipelinejobbloggen med platshållarsteget markerat.

    Listan med steg i jobbet innehåller steg som du inte skapade. De här stegen skapas automatiskt av Azure Pipelines. I vissa organisationer kan du också se steg som din organisation automatiskt inkluderar i alla sina pipelines. Du kan välja valfritt steg för att visa loggfilen för det steget.

  4. Välj checkout-website@main till s.

    Skärmbild som visar pipelinejobbloggen med steget

    Loggen för varje steg innehåller information om exakt vad som hände under pipelinekörningen. Logginformation är användbar om du behöver diagnostisera ett problem med en pipeline. Du har inte direkt åtkomst till agenten som körde dina steg.

    I det här fallet laddades lagringsplatsens innehåll ned från Azure Repos till agentens filsystem.

  5. Välj Platshållarsteg.

    Skärmbild som visar pipelinejobbloggen med steget Platshållarsteg markerat och information som visas.

    Loggen för det här steget innehåller innehållet i skriptet när du skapade det i din pipelines YAML-fil och Hello world! textutdata från att köra skriptet.

Det är bra att förstå hur du korsreferensar en pipelinekörning till incheckningen som körningen innehöll. Genom att länka en pipelinekörning till en incheckning kan du spåra historiken för distributionen och diagnostisera problem. Azure DevOps innehåller flera sätt att länka en pipelinekörning till en incheckning. I den här proceduren kontrollerar du incheckningshistoriken manuellt.

  1. Om du vill återgå till lagringsplatsens översikt går du till DevOps-resursmenyn och väljer Återansluta>incheckningar.

    Skärmbild som visar incheckningsfönstret med incheckningsidentifieraren och tillståndet lyckades markerat.

    Incheckningsidentifieraren är samma som incheckningsidentifieraren som du antecknade från pipelinekörningen. Azure Pipelines visar också status för pipelinekörningen som är associerad med incheckningen.

  2. Välj incheckningen. Listan över filer som har ändrats och ändringarna från incheckningen visas markerade i grönt, vilket visar att all text är ny.