Aan de slag met npm-pakketten in Azure Artifacts

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

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.

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.

   

Notitie

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

Uw NPMRC-bestanden instellen

Notitie

vsts-npm-auth wordt niet ondersteund in 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.

Windows

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 uw npmrc-bestand op gebruikersniveau:

vsts-npm-auth -config .npmrc

Overig

Als u ontwikkelt op een niet-Windows-platform en moet verifiëren met Azure Artifacts, moet u een persoonlijk toegangstoken maken, coderen in Base 64 en het vervolgens toevoegen aan uw npmrc-bestand op gebruikersniveau.

1. Genereer een persoonlijk toegangstoken met lees- en schrijfbereiken voor pakketten.

2. Codeer uw zojuist gegenereerde persoonlijke toegangstoken als volgt:

   1. Voer de volgende opdracht uit in een opdrachtpromptvenster om uw PAT te coderen:

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. Plak uw persoonlijke toegangstoken en druk op Enter.

   3. Kopieer het met Base 64 gecodeerde persoonlijke toegangstoken.

3. Kopieer het volgende codefragment naar uw NPMRC-bestand op gebruikersniveau en vervang de [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] tijdelijke aanduiding door uw persoonlijke base 64-toegangstoken:

   • Feed met organisatiebereik:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Feed met projectbereik:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

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

Verwante artikelen:

• NPM-pakketten publiceren (YAML/Klassiek)
• Pakketten uit npmjs.com gebruiken
• NPM-bereiken gebruiken