Delen via


Npm-pakketten publiceren en downloaden met Azure Artifacts

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

Met Azure Artifacts kunt u npm-pakketten publiceren en downloaden vanuit zowel uw eigen feeds als openbare registers, zoals npmjs.com. In deze quickstart wordt u begeleid bij het maken van een feed, het configureren van uw project en het beheren van NPM-pakketten met behulp van Azure Artifacts.

" section is required.)

Product Eisen
Azure DevOps - Een Azure DevOps organisatie.
- Een Azure DevOps--project.
- Download en installeer Node.js en npm.

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. Geef een Naam op voor uw feed, kies de optie Zichtbaarheid waarmee wordt gedefinieerd wie uw pakketten kan bekijken, controleer Pakketten opnemen uit gemeenschappelijke openbare bronnen als u pakketten uit bronnen zoals nuget.org of npmjs.comwilt opnemen, en voor Bereik, bepaalt u of de feed moet worden afgestemd op uw project of de hele organisatie.

  4. 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. Geef een Naam op voor uw feed, kies de optie Zichtbaarheid waarmee wordt gedefinieerd wie uw pakketten kan bekijken, controleer Pakketten opnemen uit gemeenschappelijke openbare bronnen als u pakketten uit bronnen zoals nuget.org of npmjs.comwilt opnemen, en voor Bereik, bepaalt u of de feed moet worden afgestemd op uw 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

Standaard wordt aan de buildservice voor het project (bijvoorbeeld projectName Build Service (orgName)) de rol Feed en Upstream Reader (Samenwerker) toegewezen wanneer er een nieuwe feed wordt gemaakt.

Verbinding maken met een feed

Azure Artifacts 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.

In deze sectie configureert u het tweede npmrc-bestand dat in dezelfde map moet worden geplaatst als uw package.json-bestand .

Met deze installatie kunt u uw configuratiebestand delen zonder uw referenties beschikbaar te maken.

  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. Als dit de eerste keer is dat u Azure Artifacts met npm gebruikt, controleert u of u de vereisten hebt geïnstalleerd.

  4. Selecteer In de sectie Project-installatieWindows of Overig , afhankelijk van uw besturingssysteem, volgt u de instructies voor het configureren van uw configuratiebestand en maakt u verbinding met uw Azure Artifacts-feed.

    Een schermopname waarin wordt weergegeven 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. Als dit de eerste keer is dat u Azure Artifacts met npm gebruikt, controleert u of u de vereisten hebt geïnstalleerd.

  4. Selecteer In de sectie Project-installatieWindows of Overig , afhankelijk van uw besturingssysteem, volgt u de instructies voor het configureren van uw configuratiebestand en maakt u verbinding met uw Azure Artifacts-feed.

    Een schermopname die laat zien hoe u een NPM-project instelt en verbinding maakt met een Azure Artifacts-feed in Azure DevOps Server 2022.

Belangrijk

Npm ondersteunt slechts één registry instelling in uw npmrc-bestand . Als u meerdere registers wilt gebruiken, moet u upstream-bronnen of -bereiken gebruiken.

Pakketten publiceren naar uw feed

Als u de publicatieopdracht wilt uitvoeren, moet u zich eerst verifiëren bij 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 onderstaande instructies.

  • Voer in de projectmap de volgende opdracht uit om het npm-pakket te publiceren dat is gedefinieerd in uw package.json:

    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

Als u de herstelopdracht wilt uitvoeren, moet u zich eerst verifiëren bij 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 onderstaande instructies.

  1. Voer in uw projectmap de volgende opdracht uit om alle NPM-pakketten te herstellen:

    npm install
    
  2. Als u een specifiek NPM-pakket wilt herstellen, voert u de volgende opdracht uit vanuit uw projectmap:

    npm install --save <PACKAGE_NAME>