Snabbstart – Använda Azure Pipelines för att skapa och publicera ett Node.js-paket

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Du kan använda en Azure DevOps-pipeline för att skapa, distribuera och testa JavaScript-appar.

Den här snabbstarten beskriver hur du använder en pipeline för att skapa ett Node.js paket med Node Package Manager (npm) och publicera en pipelineartefakt.

Förutsättningar

Du måste ha följande objekt i Azure DevOps:

• Ett GitHub-konto där du kan skapa en lagringsplats. Skapa en kostnadsfritt.
• En Azure DevOps-organisation och ett projekt. Skapa en kostnadsfritt.
• En möjlighet att köra pipelines på Microsoft-värdbaserade agenter. Du kan antingen köpa ett parallellt jobb eller begära en kostnadsfri nivå.

1 – Förgrena exempelkoden

Förgrena följande Express.js-exempelserverapp på GitHub.

https://github.com/Azure-Samples/js-e2e-express-server

2 – Skapa din pipeline

1. Logga in på Azure Pipelines. Webbläsaren går till https://dev.azure.com/my-organization-name och visar din Azure DevOps-instrumentpanel.

2. Gå till projektet och välj Pipelines>Skapa en ny pipeline.

3. Välj GitHub som plats för källkoden.

4. Om du omdirigeras till GitHub för att logga in anger du dina GitHub-autentiseringsuppgifter.

5. När listan över lagringsplatser visas väljer du din Node.js exempellagringsplats.

6. Azure Pipelines analyserar koden på lagringsplatsen och rekommenderar mallen Node.js för din pipeline. Välj mallen.

7. Azure Pipelines genererar en YAML-fil för din pipeline. Välj Spara och kör>Checka in direkt till huvudgrenen och välj sedan Spara och kör igen.

8. En ny körning startar. Vänta tills körningen har slutförts.

När du är klar har du en fungerande YAML-fil azure-pipelines.yml på lagringsplatsen som du kan anpassa.

3 – Skapa paketet och publicera en artefakt

1. Redigera filen azure-pipelines.yml .

2. Uppdatera Node.js Tool Installer-uppgiften så att den använder Node.js version 16 LTS.

   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest'
   
   steps:
   - task: UseNode@1
     inputs:
       version: '16.x'
     displayName: 'Install Node.js'
   
   - script: |
       npm install
     displayName: 'npm install'
   
   - script: |
       npm run build
     displayName: 'npm build'
   

3. Lägg till nya uppgifter i pipelinen för att kopiera npm-paketet, package.json och publicera artefakten. Aktiviteten Kopiera filer kopierar filer från den lokala sökvägen på agenten där dina källkodsfiler laddas ned och sparar filer till en lokal sökväg på agenten där artefakter kopieras till innan de skickas till målet. Endast mapparna src och public får kopior. Aktiviteten Publicera pipelineartefakt laddar ned filerna från tidigare copy files-uppgifter och gör dem tillgängliga som pipelineartefakter som kommer att publiceras med pipelineversionen.

   - task: CopyFiles@2
     inputs:
       sourceFolder: '$(Build.SourcesDirectory)'
       contents: |
          src/*
          public/*
       targetFolder: '$(Build.ArtifactStagingDirectory)'
     displayName: 'Copy project files'
   
   - task: PublishPipelineArtifact@1
     inputs:
       artifactName: e2e-server
       targetPath: '$(Build.ArtifactStagingDirectory)'
       publishLocation: 'pipeline'
     displayName: 'Publish npm artifact'
   

4 – Kör din pipeline

Spara och kör din pipeline. När pipelinen har körts kontrollerar du att jobbet har körts och att du ser en publicerad artefakt.

1. Förgrena följande lagringsplats på GitHub.

   https://github.com/Azure-Samples/js-e2e-express-server
   

2. När du har exempelkoden på din egen lagringsplats skapar du din första pipeline och väljer mallen Tom process .

3. Välj Process under fliken Uppgifter i pipelineredigeraren och ändra egenskaperna enligt följande:

   • Agentkö:Hosted Ubuntu Latest

4. Lägg till följande uppgifter i pipelinen i den angivna ordningen:

   • npm

     • Kommando:install

   • npm

     • Visningsnamnnpm test:
     • Kommando:custom
     • Kommando och argument:test

   • Publicera testresultat

     • Lämna alla standardvärden för egenskaper

   • Arkivera filer

     • Rotmapp eller fil som ska arkiveras:$(System.DefaultWorkingDirectory)
     • Rotmappsnamn för prepend till arkivsökvägar: Avmarkerat

   • Publicera byggartefakter

     • Lämna alla standardvärden för egenskaper

5. Spara pipelinen och köa en version för att se den i praktiken.

Nästa steg

Bra jobbat, du har slutfört den här snabbstarten!

Konfigurera JavaScript