NPM-pakketten publiceren met Azure Pipelines (YAML/Klassiek)

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

Met Azure Pipelines kunt u uw NPM-pakketten publiceren naar Azure Artifacts-feeds binnen uw organisatie en in andere organisaties. In dit artikel wordt u begeleid bij het publiceren van npm-pakketten naar interne en externe feeds met behulp van YAML- en klassieke pijplijnen.

Vereisten

• Maak een Azure DevOps-organisatie en een project als u dat nog niet hebt gedaan.

• Maak een nieuwe feed als u er nog geen hebt.

• Als u een zelf-hostende agent gebruikt, moet u ervoor zorgen dat deze Node.js en npm bevat.

Pakketten publiceren naar een feed in dezelfde organisatie

Notitie

Als u uw pakketten wilt publiceren naar een feed met behulp van Azure Pipelines, moet u ervoor zorgen dat zowel de buildservice voor projectverzamelingen als de buildservice-identiteit van uw project zijn geconfigureerd als een feeduitgever (inzender). Zie Nieuwe gebruikers/groepen toevoegen voor meer informatie.

YAML

steps:
- task: NodeTool@0
  inputs:
    checkLatest: true

- task: npmAuthenticate@0
  displayName: 'Authenticate to Azure Artifacts feed'
  inputs:
    workingFile: .npmrc

- script: |
   npm publish
  displayName: Publish

Klassiek

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Pijplijnen en selecteer vervolgens uw pijplijndefinitie.

3. Selecteer Bewerken en selecteer vervolgens het + teken om een nieuwe taak toe te voegen. Voeg het Node.js hulpprogramma-installatieprogramma, npm-verificatie en opdrachtregeltaken toe aan uw pijplijndefinitie. U kunt de Node.js hulpprogrammainstallatietaak met de standaardinstellingen laten staan en de taken npm-verificatie en opdrachtregel als volgt configureren:

   1. npm-verificatietaak: selecteer het pad naar het NPMRC-bestand .

   2. Opdrachtregeltaak:

      • Weergavenaam: Publiceren.
      • Script:

        npm publish
        

Pakketten publiceren naar een feed in een andere organisatie

Als u uw pakketten wilt publiceren naar een feed in een andere Azure DevOps-organisatie, moet u eerst een persoonlijk toegangstoken maken in de doelorganisatie.

Navigeer naar de organisatie die als host fungeert voor uw doelfeed en maak een persoonlijk toegangstoken met het lees- en schrijfbereik voor pakketten>. Kopieer uw persoonlijke toegangstoken, omdat u dit nodig hebt in de volgende sectie.

Een serviceverbinding maken

1. Meld u aan bij de Azure DevOps-organisatie waar uw pijplijn wordt uitgevoerd en navigeer vervolgens naar uw project.

2. Navigeer naar uw Project settings>Service-verbindingen.

3. Selecteer Nieuwe serviceverbinding, selecteer npm en selecteer vervolgens Volgende.

4. Selecteer Gebruikersnaam en wachtwoord als verificatiemethode en voer vervolgens de register-URL in. Voer uw gebruikersnaam in (een tijdelijke aanduiding, omdat Azure Pipelines uw .npmrc configuratiebestand en het persoonlijke toegangstoken gebruikt dat u eerder hebt gemaakt om te verifiëren). Voor Wachtwoord plakt u uw persoonlijke toegangstoken. Geef een naam op voor uw serviceverbinding en schakel het selectievakje Toegang verlenen aan alle pijplijnen in.

5. Kies Opslaan wanneer u klaar bent.

Pakketten publiceren

YAML

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Pijplijnen en selecteer vervolgens uw pijplijndefinitie.

3. Selecteer Bewerken en voeg vervolgens het volgende fragment toe aan uw YAML-pijplijn.

   - task: NodeTool@0
     inputs:
       checkLatest: true
   
   - task: npmAuthenticate@0
     displayName: 'Authenticate to Azure Artifacts feed'
     inputs:
       workingFile: .npmrc
       customEndpoint: <SERVICE_CONNECTION_NAME>
   
   - script: |
      npm publish  
     displayName: Publish  
   

Klassiek

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Pijplijnen en selecteer vervolgens uw pijplijndefinitie.

3. Selecteer Bewerken en selecteer vervolgens het + teken om een nieuwe taak toe te voegen. Voeg het Node.js hulpprogramma-installatieprogramma, npm-verificatie en opdrachtregeltaken toe aan uw pijplijndefinitie. U kunt de installatietaak van het Node.js hulpprogramma met de standaardinstellingen laten staan en de taken npm-verificatie en opdrachtregel als volgt configureren:

   1. npm-verificatietaak:

      1. Selecteer het pad naar het NPMRC-bestand .
      2. Selecteer de serviceverbinding die u eerder hebt gemaakt vanuit de referenties voor registers buiten deze vervolgkeuzelijst voor organisatie/verzameling .

   2. Opdrachtregeltaak:

      • Weergavenaam: Publiceren.
      • Script:

        npm publish
        

Gerelateerde inhoud

• Pijplijnartefacten publiceren en downloaden
• Het .artifactignore-bestand gebruiken
• Implementeer artefacten voor pull-aanvragen.