Npm-pakketten publiceren en downloaden met Azure-artefacten

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure-artefacten stelt ontwikkelaars in staat npm-pakketten te publiceren en te downloaden uit feeds of openbare registers.

In dit artikel wordt u begeleid bij het maken van een feed, het configureren van uw project en het publiceren en downloaden van npm-pakketten.

" section is required.)

Een feed maken

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

  2. Selecteer Artefacten en selecteer daarna Feed maken.

  3. Voer een naam in voor uw feed.

  4. Kies een zichtbaarheidsinstelling om te bepalen wie pakketten in de feed kan bekijken.

  5. Selecteer Pakketten opnemen uit algemene openbare bronnen als u wilt dat uw feed upstream-pakketten gebruikt uit bronnen zoals nuget.org of npmjs.com.

  6. Kies voor Bereik of de feed is gericht op het huidige project of de hele organisatie.

  7. Selecteer Maken wanneer u klaar bent.

    Schermopname van selecties voor het maken van een nieuwe feed in Azure DevOps Services.

  1. Meld u aan bij uw Azure DevOps-server en ga vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer daarna Feed maken.

  3. Voer een naam in voor uw feed.

  4. Kies een zichtbaarheidsinstelling om te bepalen wie pakketten in de feed kan bekijken.

  5. Selecteer Pakketten opnemen uit algemene openbare bronnen als u wilt dat uw feed upstream-pakketten gebruikt uit bronnen zoals nuget.org of npmjs.com.

  6. Kies voor Bereik of de feed is gericht op het huidige project of de hele organisatie.

  1. Selecteer Maken wanneer u klaar bent.

    Schermopname van selecties voor het maken van een nieuwe feed in Azure DevOps 2022.

Notitie

Wanneer u een feed maakt, wordt standaard de rol Feed en Upstream Reader (Samenwerker) toegewezen aan het buildserviceaccount van het project, zoals projectName Build Service (orgName).

NPM-verificatie instellen

Voordat u verbinding maakt met een feed, moet u verificatie instellen voor de npm-client op uw computer. De stappen verschillen afhankelijk van uw besturingssysteem:

Windows

Installeer vsts-npm-auth, waarmee de aanmeldingsgegevens worden gegenereerd en vernieuwd die npm gebruikt om verbinding te maken met uw Azure-artefacten-feed.

npm install -g vsts-npm-auth --registry https://registry.npmjs.com

macOS en Linux

vsts-npm-auth wordt niet ondersteund in macOS of Linux. Maak in plaats daarvan een persoonlijk toegangstoken (PAT) met het bereik Pakketten>. Gebruik deze PAT wanneer u het NPMRC-bestand op gebruikersniveau configureert in de volgende sectie.

Verbinding maken met een feed

Azure-artefacten raadt aan twee afzonderlijke configuratiebestanden te gebruiken. De eerste moet lokaal worden bewaard in de $HOME map (Linux/macOS) of $env. HOME (Windows) om uw referenties veilig op te slaan. Hierdoor heeft de npm-client toegang tot uw referenties voor verificatie.

Met deze installatie kunt u projectconfiguratie delen met uw team zonder referenties beschikbaar te maken in broncodebeheer. Zie Verbinding maken met een Azure-artefacten-feed - npm voor meer informatie.

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

  2. Kies Artefacten, kies uw feed uit het vervolgkeuzemenu en kies vervolgens Verbinding maken met feed.

  3. Selecteer npm in het linkernavigatiedeelvenster.

  4. Selecteer onder Project setupWindows of Overig voor uw besturingssysteem en volg vervolgens de instructies om uw npmrc-bestanden op gebruikersniveau en project-niveau bij te werken.

    Schermopname die laat zien hoe u een npm-project instelt en verbinding maakt met een feed in Azure DevOps Services.

Notitie

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

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

  2. Kies Artefacten, kies uw feed uit het vervolgkeuzemenu en kies vervolgens Verbinding maken met feed.

  3. Selecteer npm in het linkernavigatiedeelvenster.

  4. Selecteer onder Project setupWindows of Overig voor uw besturingssysteem en volg vervolgens de instructies om uw npmrc-bestanden op gebruikersniveau en project-niveau bij te werken.

    Schermopname die laat zien hoe u een npm-project instelt en verbinding maakt met een Azure-artefacten feed in Azure DevOps Server 2022.

Belangrijk

npm ondersteunt slechts één registry instelling in uw .npmrc-bestand . Als u pakketten uit meerdere bronnen nodig hebt, gebruikt u upstream-bronnen of registry in plaats van meerdere vermeldingen toe te voegen.

Pakketten publiceren naar uw feed

Notitie

Als u pakketten naar een feed wilt publiceren, moet u een feeduitgever (inzender) of hoger zijn. Zie Machtigingen beheren voor meer informatie.

Voordat u pakketten publiceert, moet u zich verifiëren met uw feed. Als u dit nog niet hebt gedaan, volgt u de stappen in de sectie Verbinding maken met een feed en gaat u verder met de instructies in de volgende sectie.

  1. Voer in uw projectmap de volgende opdracht uit om het pakket te publiceren dat in uw package.json bestand is gedefinieerd in uw feed:

    npm publish

Belangrijk

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

Pakketten herstellen vanuit uw feed

Voordat u pakketten herstelt, moet u zich verifiëren met uw feed en de NPMRC-bestanden voor uw project bijwerken. Als u dit nog niet hebt gedaan, voert u de stappen in Verbinding maken met een feed uit en gaat u verder.

  1. Voer in de projectmap de volgende opdracht uit om alle pakketten in uw package.json bestand te herstellen:

    npm install

  2. Voer de volgende opdracht uit om een specifiek pakket uit de feed te installeren en toe te voegen als een afhankelijkheid in uw package.json bestand:

    npm install --save <PACKAGE_NAME>

Verwante inhoud

  • Laatst bijgewerkt om