Skapa en CI/CD-pipeline för IoT Edge med Azure DevOps-projektCreate a CI/CD pipeline for IoT Edge with Azure DevOps Projects

Konfigurera kontinuerlig integrering (CI) och kontinuerlig leverans (CD) för ditt IoT Edge-program med DevOps-projekt.Configure continuous integration (CI) and continuous delivery (CD) for your IoT Edge application with DevOps Projects. DevOps Projects förenklar den initiala konfigurationen av en bygg- och versionspipeline i Azure Pipelines.DevOps Projects simplifies the initial configuration of a build and release pipeline in Azure Pipelines.

Om du inte har en aktiv Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an active Azure subscription, create a free account before you begin.

Logga in på Azure PortalSign in to the Azure portal

DevOps Projects skapar en CI/CD-pipeline i Azure DevOps.DevOps Projects creates a CI/CD pipeline in Azure DevOps. Du kan skapa en ny Azure DevOps-organisation eller använda en befintlig organisation.You can create a new Azure DevOps organization or use an existing organization. DevOps Projects skapar även Azure-resurser i den Azure-prenumeration som du väljer.DevOps Projects also creates Azure resources in the Azure subscription of your choice.

  1. Logga in på Microsoft Azure Portal.Sign in to the Microsoft Azure portal.

  2. I den vänstra fönsterrutan väljer du Skapa en resurs och söker sedan efter DevOps Projects.In the left pane, select Create a resource, and then search for DevOps Projects.

  3. Välj Skapa.Select Create.

Skapa en ny programpipelineCreate a new application pipeline

  1. Dina Azure IoT Edge-moduler kan skrivas i C#, Node.js, Python, C och Java.Your Azure IoT Edge module(s) can be written in C#, Node.js, Python, C and Java. Välj önskat språk för att starta ett nytt program: .NET, Node.js, Python, Celler Java.Select your preferred language to start a new application: .NET, Node.js, Python, C, or Java. Välj Nästa för att fortsätta.Select Next to continue.

    Välj språk för att skapa ett nytt program

  2. Välj Enkel IoT som programramverk och välj sedan Nästa.Select Simple IoT as your application framework, and then select Next.

    Välj enkelt IoT-ramverk

  3. Välj IoT Edge som Azure-tjänst som distribuerar ditt program och välj sedan Nästa.Select IoT Edge as the Azure service that deploys your application, and then select Next.

    Välj IoT Edge-tjänst

  4. Skapa en ny kostnadsfri Azure DevOps-organisation eller använd en befintlig organisation.Create a new free Azure DevOps organization or choose an existing organization.

    1. Ange ett namn för projektet.Provide a name for your project.

    2. Välj din Azure DevOps-organisation.Select your Azure DevOps organization. Om du inte har en befintlig organisation väljer du Ytterligare inställningar för att skapa en ny.If you don't have an existing organization, select Additional settings to create a new one.

    3. Välj din Azure-prenumeration.Select your Azure subscription.

    4. Använd IoT Hub-namnet som genereras av ditt projektnamn eller ange ditt eget.Use the IoT Hub name generated by your project name, or provide your own.

    5. Acceptera standardplatsen eller välj en nära dig.Accept the default location, or choose one close to you.

    6. Välj Ytterligare inställningar för att konfigurera De Azure-resurser som DevOps-projekt skapar för din räkning.Select Additional settings to configure the Azure resources that DevOps Projects creates on your behalf.

    7. Välj Klar om du vill slutföra skapandet av projektet.Select Done to finish creating your project.

    Namnge och skapa program

Efter några minuter visas DevOps Projects-instrumentpanelen i Azure-portalen.After a few minutes, the DevOps Projects dashboard is displayed in the Azure portal. Välj projektnamnet för att se förloppet.Select your project name to see the progress. Du kan behöva uppdatera sidan.You may need to refresh the page. Ett exempel på IoT Edge-program har konfigurerats i en databas i din Azure DevOps-organisation, en version körs och ditt program distribueras till IoT Edge-enheten.A sample IoT Edge application is set up in a repository in your Azure DevOps organization, a build is executed, and your application is deployed to the IoT Edge device. Den här instrumentpanelen ger insyn i kodlagringsplatsen, CI/CD-pipelinen och ditt program i Azure.This dashboard provides visibility into your code repository, the CI/CD pipeline, and your application in Azure.

Visa program i Azure-portalen

Genomför ändringar i koden och kör CI/CDCommit code changes and execute CI/CD

DevOps-projekt har skapat en Git-databas för ditt projekt i Azure Repos.DevOps Projects created a Git repository for your project in Azure Repos. I det här avsnittet kan du visa databasen och göra kodändringar i ditt program.In this section, you view the repository and make code changes to your application.

  1. Om du vill navigera till den repo som skapats för projektet väljer du Databaser på menyn på projektinstrumentpanelen.To navigate to the repo created for your project, select Repositories in the menu of your project dashboard.

    Visa databas som genereras i Azure Repos

  2. Följande steg går igenom med hjälp av webbläsaren för att göra kodändringar.The following steps walk through using the web browser to make code changes. Om du vill klona databasen lokalt i stället väljer du Klona längst upp till höger i fönstret.If you want to clone your repository locally instead, select Clone from the top right of the window. Använd den angivna webbadressen för att klona Git-databasen i Visual Studio-kod eller önskat utvecklingsverktyg.Use the provided URL to clone your Git repository in Visual Studio Code or your preferred development tool.

  3. Databasen innehåller redan kod för en modul som heter FilterModule baserat på det programspråk som du valde i skapandeprocessen.The repository already contains code for a module called FilterModule based on the application language that you chose in the creation process. Öppna modulen/FilterModule/module.json-filen.Open the modules/FilterModule/module.json file.

    Öppna module.json-filen i Azure Repos

  4. Observera att den här filen använder Azure DevOps-byggvariabler i versionsparametern. versionNotice that this file uses Azure DevOps build variables in the version parameter. Den här konfigurationen säkerställer att en ny version av modulen skapas varje gång en ny version körs.This configuration ensures that a new version of the module will be created every time a new build runs.

Granska CI/CD-pipelinenExamine the CI/CD pipeline

I föregående avsnitt konfigurerade Azure DevOps Projects automatiskt en fullständig CI/CD-pipeline för ditt IoT Edge-program.In the previous sections, Azure DevOps Projects automatically configured a full CI/CD pipeline for your IoT Edge application. Nu, utforska och anpassa rörledningen efter behov.Now, explore and customize the pipeline as needed. Följ följande steg för att bekanta dig med Azure DevOps-bygg- och utgivningspipelines.Use the following steps to familiarize yourself with the Azure DevOps build and release pipelines.

  1. Om du vill visa byggpipelines i ditt DevOps-projekt väljer du Skapa pipelines på menyn på projektinstrumentpanelen.To view the build pipelines in your DevOps project, select Build Pipelines in the menu of your project dashboard. Länken öppnar en webbläsarflik och Azure DevOps-bygg-pipelinen för det nya projektet.This link opens a browser tab and the Azure DevOps build pipeline for your new project.

    Visa build-pipelines i Azure Pipelines

  2. Välj Redigera.Select Edit.

    Redigera byggpipeline

  3. På panelen som öppnas kan du undersöka de aktiviteter som uppstår när byggpipelinen körs.In the panel that opens, you can examine the tasks that occur when your build pipeline runs. Build-pipelinen utför olika uppgifter, till exempel hämtar källor från Git-databasen, skapar IoT Edge-modulavbildningar, skickar IoT Edge-moduler till ett behållarregister och publicerar utdata som används för distributioner.The build pipeline performs various tasks, such as fetching sources from the Git repository, building IoT Edge module images, pushing IoT Edge modules to a container registry, and publishing outputs that are used for deployments. Mer information om Azure IoT Edge-uppgifter i Azure DevOps finns i Konfigurera Azure Pipelines för kontinuerlig integrering.To learn more about Azure IoT Edge tasks in Azure DevOps, see Configure Azure Pipelines for continuous integration.

  4. Välj pipeline-huvudet högst upp i byggpipelinen för att öppna pipeline-informationen.Select the Pipeline header at the top of the build pipeline to open the pipeline details. Ändra namnet på din bygg-pipeline till något mer beskrivande.Change the name of your build pipeline to something more descriptive.

    Redigera pipelineinformation

  5. Välj Spara & köoch välj sedan Spara.Select Save & queue, and then select Save.

  6. Välj Utlösare på byggpipeline-menyn.Select Triggers from the build pipeline menu. DevOps Projects skapade automatiskt en CI-utlösare, och varje incheckning till lagringsplatsen startar en ny version.DevOps Projects automatically created a CI trigger, and every commit to the repository starts a new build. Du kan välja att inkludera eller exkludera grenar från CI-processen.You can optionally choose to include or exclude branches from the CI process.

  7. Välj Kvarhållning.Select Retention. Beroende på ditt scenario kan du ange principer för att behålla eller ta bort ett visst antal versioner.Depending on your scenario, you can specify policies to keep or remove a certain number of builds.

  8. Välj Historik.Select History. Historikpanelen innehåller en granskningskedja över de senaste ändringarna i byggnaden.The history panel contains an audit trail of recent changes to the build. Azure Pipelines spårar alla ändringar som görs av bygg-pipelinen, vilket innebär att du kan jämföra versioner.Azure Pipelines keeps track of any changes that are made to the build pipeline, and it allows you to compare versions.

  9. När du är klar med utforska byggpipelinen navigerar du till motsvarande versionspipeline.When you're done exploring the build pipeline, navigate to the corresponding release pipeline. Välj Versioner under Pipelinesoch välj sedan Redigera om du vill visa pipelineinformationen.Select Releases under Pipelines, then select Edit to view the pipeline details.

    Visa utgivningspipeline

  10. Under Artefakter väljer du Släpp.Under Artifacts, select Drop. Källan som denna artefakt klockor är resultatet av bygga pipeline du undersökt i föregående steg.The source that this artifact watches is the output of the build pipeline you examined in the previous steps.

  11. Bredvid ikonen Släpp väljer du den kontinuerliga distributionsutlösaren som ser ut som en blixt.Next to the Drop icon, select the Continuous deployment trigger that looks like a lightning bolt. Den här versionspipelinen har aktiverat utlösaren, som kör en distribution varje gång det finns en ny versionsartefakt tillgänglig.This release pipeline has enabled the trigger, which runs a deployment every time there is a new build artifact available. Du kan även inaktivera utlösaren så att dina distributioner kräver manuell körning.Optionally, you can disable the trigger so that your deployments require manual execution.

  12. På menyn för versionspipelinen väljer du Uppgifter och väljer sedan utvecklingsstadiet i listrutan.In the menu for your release pipeline, select Tasks then choose the dev stage from the dropdown list. DevOps Projects skapade en versionsfas för dig som skapar en IoT-hubb, skapar en IoT Edge-enhet i den hubben, distribuerar exempelmodulen från byggpipelinen och etablerar en virtuell dator för att köras som din IoT Edge-enhet.DevOps Projects created a release stage for you that creates an IoT hub, creates an IoT Edge device in that hub, deploys the sample module from the build pipeline, and provisions a virtual machine to run as your IoT Edge device. Mer information om Azure IoT Edge-uppgifter för CD finns i Konfigurera Azure Pipelines för kontinuerlig distribution.To learn more about Azure IoT Edge tasks for CD, see Configure Azure Pipelines for continuous deployment.

    Visa aktiviteter för kontinuerlig distribution

  13. Till höger väljer du alternativet för att visa versioner.On the right, select View releases. Den här vyn visar en historik över versioner.This view shows a history of releases.

  14. Välj namnet på en version om du vill visa mer information om den.Select the name of a release to view more information about it.

Rensa resurserClean up resources

Du kan ta bort Azure App Service och andra relaterade resurser som du skapade när de inte längre behövs.You can delete Azure App Service and other related resources that you created when you don't need them anymore. Använd funktionen Ta bort på DevOps Projects-instrumentpanelen.Use the Delete functionality on the DevOps Projects dashboard.

Nästa stegNext steps