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 | TFS 2018

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 Package Manager (npm) en een pijplijnartefact te publiceren.

Vereisten

U moet de volgende items in Azure DevOps hebben:

  • Een GitHub-account waar u een opslagplaats kunt maken. Maak er gratis een.
  • Een Azure DevOps-organisatie en -project. Maak er gratis een.
  • Een mogelijkheid om pijplijnen uit te voeren op door Microsoft gehoste agents. U kunt een parallelle taak aanschaffen of u kunt een gratis laag aanvragen.

YAML is niet beschikbaar voor TFS 2018.

1 - De voorbeeldcode forken

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>Doorvoer rechtstreeks uit naar de hoofdbranch en kies Opslaan en opnieuw uitvoeren .

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

Wanneer u klaar bent, hebt u een werkend YAML-bestand azure-pipelines.yml in uw opslagplaats dat 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 is geplaatst , selecteert u de nummerkoppeling om de pijplijn in actie te zien.

3 - Bouw uw pakket en publiceer een artefact

  1. Bewerk uw bestand azure-pipelines.yml .

  2. Werk de taakNode.js Hulpprogramma-installatieprogramma bij om Node.js versie 16 LTS te gebruiken.

    trigger:
    - main
    
    pool:
      vmImage: 'ubuntu-latest'
    
    steps:
    - task: NodeTool@0
      inputs:
        versionSpec: '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. Deze bestanden worden opgeslagen in een npm-map . Detaak Pijplijnartefacten Publiceren pijplijnartefacten, downloadt de bestanden uit de eerdere kopieerbestanden en maakt deze beschikbaar als pijplijnartefacten die worden gepubliceerd met uw pijplijnbuild.

    - task: CopyFiles@2
      inputs:
        sourceFolder: '$(Build.SourcesDirectory)'
        contents: '*.tgz' 
        targetFolder: $(Build.ArtifactStagingDirectory)/npm
      displayName: 'Copy npm package'
    
    - task: CopyFiles@2
      inputs:
        sourceFolder: '$(Build.SourcesDirectory)'
        contents: 'package.json' 
        targetFolder: $(Build.ArtifactStagingDirectory)/npm
      displayName: 'Copy package.json'   
    
    - task: PublishPipelineArtifact@1
      inputs:
        targetPath: '$(Build.ArtifactStagingDirectory)/npm'
        artifactName: npm
      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 1604
  4. Voeg de volgende taken toe aan de pijplijn in de opgegeven volgorde:

    • npm

      • Opdracht:install
    • npm

      • Weergavenaam:npm 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)
      • De naam van de basismap vooraf opgeven om paden te archiveren: Ongecontroleerde
    • Buildartefacten publiceren

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

Volgende stappen

Gefeliciteerd, u hebt deze quickstart voltooid.