Aan de slag met npm-pakketten in Azure Artifacts

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

Met Behulp van Azure Artifacts kunt u npm-pakketten publiceren en downloaden uit feeds en openbare registers, zoals npmjs.com. In deze quickstart wordt u begeleid bij het maken van uw feed, het configureren van uw project en het publiceren en downloaden van npm-pakketten naar en van uw Azure Artifacts-feed.

Licentie voor de Azure Artifacts-extensie

Als de Azure Artifacts-extensie is verwijderd, kunt u deze installeren vanuit Visual Studio Marketplace. Elke organisatie krijgt vijf gratis licenties. Als u meer dan vijf licenties nodig hebt, gaat u naar Visual Studio Marketplace en selecteert u Gratis downloaden.

Als u het niet zeker weet, kunt u de gratis proefversie van 30 dagen starten selecteren. Elke gebruiker in uw organisatie krijgt vervolgens 30 dagen toegang tot Azure Artifacts. Na de proefperiode van 30 dagen keert uw organisatie terug naar vijf rechte gebruikers en moet u licenties toewijzen aan afzonderlijke gebruikers. Als u op dit moment extra licenties nodig hebt, kunt u deze aanschaffen via Visual Studio Marketplace. Als u een licentie voor Visual Studio Enterprise hebt, hebt u al toegang tot Azure Artifacts en hoeft u geen licentie toe te wijzen. Zorg ervoor dat u het toegangsniveau 'Visual Studio Enterprise' hebt toegewezen.

Notitie

Als u een gratis proefversie van 30 dagen start hebt geselecteerd en zich nog in de proefperiode bevindt, krijgt elke gebruiker toegang. Licenties hoeven pas toegewezen te worden nadat de proefperiode is beëindigd.

  1. Plaats in een verzameling in Team Foundation Server de muisaanwijzer op het instellingenmenu en selecteer Gebruikers. Selecteer vervolgens Pakketbeheer.

    Schermopname van de gebruikerspagina in TFS 2018

  2. Selecteer Toewijzen, voer de gebruikers in die u licenties wilt toewijzen en selecteer VERVOLGENS OK.

    • Gebruikers met Visual Studio Enterprise-abonnementen krijgen Gratis Azure Artifacts. Zorg ervoor dat uw Visual Studio Enterprise-abonnees het juiste toegangsniveau hebben. Zie Toegangsniveaus wijzigen voor meer informatie.

    • Gebruikers die een exemplaar van Team Foundation Server gebruiken dat geen verbinding heeft met internet (en dus geen licenties kunnen aanschaffen bij Visual Studio Marketplace), kunnen nog steeds licenties toewijzen die zijn aangeschaft via een Enterprise Agreement.

Een feed maken

Een feed is een organisatieconstructie waarmee gebruikers hun pakketten kunnen opslaan en kunnen bepalen wie er toegang heeft. Azure Artifacts biedt ondersteuning voor het opslaan van verschillende pakkettypen in één feed, zoals NuGet-, npm-, Maven-, Python-, Cargo- en Universal-pakketten.

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

  2. Selecteer Artefacten en selecteer Vervolgens Feed maken om een nieuwe feed te maken.

  3. Voer een beschrijvende naam in voor uw feed en definieer de zichtbaarheid (waarmee wordt aangegeven wie pakketten in de feed kan bekijken). Geef het bereik van uw feed op en als u pakketten uit openbare bronnen wilt opnemen, schakelt u het selectievakje Upstream-bronnen in.

  4. Selecteer Maken wanneer u klaar bent.

    Een schermopname die laat zien hoe u een behoeftefeed maakt.

Notitie

Standaard is voor nieuw gemaakte feeds de buildservice van hun project ingesteld op Feed en Upstream Reader (Samenwerker).

Azure Artifacts is vooraf geïnstalleerd in TFS 2018. Als dit de eerste keer is dat u uw feed gebruikt, wordt u mogelijk gevraagd een licentie toe te wijzen.

  1. Navigeer naar uw project http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Selecteer Build & Release en selecteer Vervolgens Pakketten.

  3. Selecteer + Nieuwe feed om een nieuwe feed te maken.

  4. Geef een betekenisvolle naam en beschrijving op voor uw feed. Geef de machtigingen op voor wie kan lezen en wie kan bijdragen, en bepaal of externe pakketten moeten worden opgenomen.

  5. Selecteer Maken wanneer u klaar bent.

    Een schermopname die laat zien hoe u een nieuwe feed maakt in TFS 2018.

Uw NPMRC-bestanden instellen

Notitie

vsts-npm-auth wordt niet ondersteund in TFS en Azure DevOps Server.

U wordt aangeraden twee NPMRC-bestanden te gebruiken. De eerste moet zich in dezelfde map bevinden als uw package.json-bestand. De tweede moet in de $home map (Linux/macOS) of $env worden geplaatst. HOME (Windows) om uw referenties veilig op te slaan. De npm-client kan dit bestand vervolgens opzoeken en uw referenties voor verificatie ophalen. Hierdoor kunt u uw configuratiebestand delen terwijl uw referenties veilig blijven.

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

  2. Selecteer Artefacten en selecteer vervolgens Verbinding maken die u wilt invoeren.

  3. Selecteer npm in het linkernavigatiedeelvenster. Als dit de eerste keer is dat u Azure Artifacts gebruikt met npm, selecteert u De hulpprogramma's ophalen en volgt u de stappen om Node.js te downloaden en uw computer in te stellen.

  4. Voeg het volgende fragment in uw .npmrc-bestand in, de code in dezelfde map als het package.json-bestand. Vervang de tijdelijke aanduidingen door de juiste waarden.

    • Feed met organisatiebereik:
    registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
    
    always-auth=true
    
    • Feed met projectbereik:
    registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
    
    always-auth=true
    

Referenties instellen

Belangrijk

npm ondersteunt één in registry uw .npmrc-bestand. Er zijn meerdere registers mogelijk met bereiken en upstream-bronnen.

Als u in Windows ontwikkelt, raden we u aan vsts-npm-auth te gebruiken om te verifiëren met Azure Artifacts. Zorg ervoor dat vsts-npm-auth is geïnstalleerd vanuit De hulpprogramma's ophalen en voer vervolgens vsts-npm-auth uit om een Azure Artifacts-token op te halen dat is toegevoegd aan het NPMRC-bestand op gebruikersniveau:

vsts-npm-auth -config .npmrc

Verbinding maken om te voeren

  1. Navigeer naar uw project http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Selecteer Build & Release en selecteer Vervolgens Pakketten.

  3. Selecteer Verbinding maken om te voeren en selecteer vervolgens npm.

  4. Selecteer Npm-referenties genereren. Kopieer de referenties en voeg deze toe aan uw NPMRC-bestand op gebruikersniveau.

    Een schermopname die laat zien hoe u npm-referenties genereert in TFS 2018.

Pakketten publiceren

Als u uw npm-pakket wilt publiceren, voert u de volgende opdracht uit in de projectmap:

npm publish

Belangrijk

Het gebruik van de publishConfig eigenschap om de registerconfiguratieparameter tijdens het publiceren te overschrijven, wordt niet ondersteund.

Pakketten herstellen

Als u een npm-pakket wilt herstellen, voert u de volgende opdracht uit in uw projectmap:

npm install --save <package>

Als u al uw NPM-pakketten wilt herstellen, voert u de volgende opdracht uit vanuit uw projectmap:

npm install