Quickstart: Azure Pipelines gebruiken om een Node.js-pakket te bouwen en te publiceren

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

U kunt een Azure DevOps-pijplijn gebruiken om JavaScript-apps te bouwen, implementeren en testen.

In deze quickstart wordt uitgelegd hoe u een pijplijn gebruikt om een Node.js-pakket te maken met Node Pakketbeheer (npm) en een pijplijnartefact te publiceren.

Vereisten

U moet de volgende items hebben in Azure DevOps:

1 - Fork de voorbeeldcode

Fork de volgende voorbeeld Express.js server app op GitHub.

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

2 - Uw pijplijn maken

  1. Meld u aan bij Azure Pipelines. Uw browser gaat naar https://dev.azure.com/my-organization-name en geeft uw Azure DevOps-dashboard weer.

  2. Ga naar uw project en selecteer Pijplijnen>een nieuwe pijplijn maken.

  3. Selecteer GitHub als de locatie van uw broncode.

  4. Als u wordt omgeleid naar GitHub om u aan te melden, voert u uw GitHub-referenties in.

  5. Wanneer de lijst met opslagplaatsen wordt weergegeven, selecteert u uw Node.js voorbeeldopslagplaats.

  6. Azure Pipelines analyseert de code in uw opslagplaats en raadt de Node.js sjabloon voor uw pijplijn aan. Selecteer die sjabloon.

  7. Azure Pipelines genereert een YAML-bestand voor uw pijplijn. Selecteer Opslaan en voer>Doorvoeren rechtstreeks uit naar de hoofdbranch en kies Opslaan en opnieuw uitvoeren.

  8. Er wordt een nieuwe uitvoering gestart. Wacht totdat de uitvoering is voltooid.

Wanneer u klaar bent, hebt u een werkend YAML-bestand azure-pipelines.yml in uw opslagplaats die u kunt aanpassen.

  1. Maak een pijplijn en selecteer de YAML-sjabloon .

  2. Stel de agentgroep en het YAML-bestandspad voor uw pijplijn in.

  3. Sla de pijplijn op en plaats een build in de wachtrij. Wanneer het bericht Build #nnnnnnnn.n in de wachtrij staat, selecteert u de nummerkoppeling om uw pijplijn in actie te zien.

3 - Bouw uw pakket en publiceer een artefact

  1. Bewerk het azure-pipelines.yml bestand.

  2. Werk de taak Node.js hulpprogramma-installatieprogramma bij om Node.js versie 16 LTS te gebruiken.

    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. Voeg nieuwe taken toe aan uw pijplijn om uw npm-pakket, package.json te kopiëren en uw artefact te publiceren. Met de taak Bestanden kopiëren worden bestanden gekopieerd van het lokale pad op de agent waar uw broncodebestanden worden gedownload en worden bestanden opgeslagen in een lokaal pad op de agent waarnaar artefacten worden gekopieerd voordat ze naar hun bestemming worden gepusht. Alleen de src en public mappen krijgen kopieën. De taak Pijplijnartefact publiceren downloadt de bestanden uit de eerdere kopieerbestanden en maakt ze beschikbaar als pijplijnartefacten die worden gepubliceerd met uw pijplijnbuild.

    - 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 - Uw pijplijn uitvoeren

Sla uw pijplijn op en voer deze uit. Nadat de pijplijn is uitgevoerd, controleert u of de taak is uitgevoerd en of u een gepubliceerd artefact ziet.

Schermopname van geslaagde pijplijnuitvoering met een artefact.

  1. Fork de volgende opslagplaats op GitHub.

    https://github.com/Azure-Samples/js-e2e-express-server
    
  2. Nadat u de voorbeeldcode in uw eigen opslagplaats hebt, maakt u uw eerste pijplijn en selecteert u de sjabloon Leeg proces .

  3. Selecteer Proces op het tabblad Taken in de pijplijneditor en wijzig de eigenschappen als volgt:

    • Agentwachtrij:Hosted Ubuntu Latest
  4. Voeg de volgende taken toe aan de pijplijn in de opgegeven volgorde:

    • npm

      • Opdracht:install
    • npm

      • Weergavenaamnpm test:
      • Opdracht:custom
      • Opdracht en argumenten:test
    • Testresultaten publiceren

      • Laat alle standaardwaarden voor eigenschappen staan
    • Bestanden archiveren

      • Hoofdmap of bestand dat u wilt archiveren:$(System.DefaultWorkingDirectory)
      • Naam van de hoofdmap vooraf opgeven voor archiefpaden: Uitgeschakeld
    • Buildartefacten publiceren

      • Laat alle standaardwaarden voor eigenschappen staan
  5. Sla de pijplijn op en zet een build in de wachtrij om deze in actie te zien.

Volgende stappen

Gefeliciteerd, u hebt deze quickstart voltooid.