Ansluta npm-projektet till Azure Artifacts

Artikel
12/27/2024

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Med Azure Artifacts kan utvecklare hantera sina paket från olika källor, inklusive både offentliga register som npmjs.com och privata feeds. Om du vill autentisera med Azure Artifacts måste du konfigurera konfigurationsfilen npm. Den här filen innehåller feed-URL:er och autentiseringsuppgifter som används av npm och erbjuder alternativ för att anpassa npm-klientbeteendet, till exempel konfigurera proxyservrar, definiera standardpaketplatser eller konfigurera privata paketfeeds. Filen .npmrc finns vanligtvis i användarens hemkatalog men kan också skapas på projektnivå för att åsidosätta standardinställningarna.

Förutsättningar

En Azure DevOps-organisation. Skapa ett kostnadsfritt konto.
Ett Azure DevOps-projekt. Skapa ett nytt projekt om du inte redan har ett.
Ett flöde för Azure Artifacts. Skapa ett kostnadsfritt konto.
Ladda ned och installera Node.js och npm.

Anslut till feeden

Azure Artifacts rekommenderar att du använder två separata konfigurationsfiler. Den första är dedikerad till att autentisera med Azure Artifacts, medan den andra ska sparas lokalt för att lagra dina autentiseringsuppgifter. Med den här metoden kan du dela konfigurationsfilen samtidigt som du håller dina autentiseringsuppgifter säkra.

Om du vill konfigurera den andra filen placerar du den i din hemkatalog på utvecklingsdatorn och inkluderar alla dina registerautentiseringsuppgifter. På så sätt kan npm-klienten enkelt komma åt dina autentiseringsuppgifter för autentisering.

Följande steg vägleder dig genom att konfigurera den första konfigurationsfilen. Välj fliken som motsvarar din utvecklingsmiljö:

Not

vsts-npm-auth stöds inte i Azure DevOps Server.

Windows
Linux/MacOS

Logga in på din Azure DevOps-organisation och navigera sedan till projektet.
Välj Artefakteroch välj sedan Anslut till feed.
Välj npm i det vänstra sidofältet. Om det är första gången du använder Azure Artifacts med npm kontrollerar du att du har installerat förutsättningarna.
Följ anvisningarna i avsnittet projektskonfiguration för att ansluta till flödet.

Lägg till en .npmrc- fil i projektets katalog i samma katalog som din package.json-fil och klistra in följande kodfragment i den.

registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 

always-auth=true

Konfigurera autentiseringsuppgifter

Kopiera följande kodfragment och klistra in det i npmrc--fil på användarnivå:

Organisationsspecifikt flöde:

; 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

projektspecifik feed:

; 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

Generera en personlig åtkomsttoken med paketering av läs- och skrivomfattningar.

Kör följande kommando i ett kommandotolkfönster och klistra sedan in din personliga åtkomsttoken när du uppmanas att göra det. När du är klar kopierar du det genererade Base 64-kodade värdet.

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(); })"

Om du använder Linux/Mac kan du också använda följande kommando för att konvertera din personliga åtkomsttoken till Base 64. Kopiera det resulterande Base64-kodade värdet.
```
echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
```
Ersätt platshållarna [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] i din .npmrc-fil med den kodade personliga åtkomsttoken som hämtades från föregående steg.

Windows
Linux/MacOS

Logga in på din Azure DevOps-samling och navigera sedan till projektet.
Välj Artefakteroch välj sedan Anslut till feed.
Välj npm i det vänstra sidofältet och följ sedan anvisningarna i avsnittet Project-konfiguration för att konfigurera konfigurationsfilen.

Lägg till en .npmrc- fil i projektets katalog i samma katalog som din package.json-fil och klistra in följande kodfragment i den.
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/

always-auth=true
```

Konfigurera autentiseringsuppgifter

Kopiera följande kodfragment och klistra in det i .npmrc--fil på användarnivå:

Samlingsbegränsat flöde:

; begin auth token
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

projektomfattande flöde:

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

Generera en personlig åtkomsttoken med paketeringsbehörigheter för läsning och skrivning.

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(); })"

Ersätt platshållarna [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] i användaren .npmrc- fil med den kodade personliga åtkomsttoken som hämtades från föregående steg.

Windows
Linux/MacOS

Logga in på din Azure DevOps-samling och navigera sedan till projektet.
Välj Artefakteroch välj sedan Anslut för att mata.
Välj npm till vänster och följ sedan anvisningarna i Project-konfiguration för att konfigurera konfigurationsfilen.

Lägg till en .npmrc--fil i projektets katalog i samma katalog som din package.json-fil och klistra in följande kodfragment i den:
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/

always-auth=true
```

Konfigurera autentiseringsuppgifter

Kopiera följande kodfragment och klistra in det i .npmrc--fil på användarnivå:

Kollektionsomfattat flöde:

; begin auth token
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Projektskopierad feed:

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

Generera en personlig åtkomsttoken med paketering av läs- och skrivomfattningar.

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(); })"

Ersätt platshållarna [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] i användaren .npmrc- fil med den kodade personliga åtkomsttoken som hämtades från föregående steg.

Logga in på din Azure DevOps-samling och navigera sedan till projektet.
Välj Artefakteroch välj sedan Anslut för att mata.
Ett nytt fönster visas. I det vänstra navigeringsfönstret väljer du npm.
Följ de angivna anvisningarna för att konfigurera dina .npmrc-filer för projektet och användaren .

Tips

Du kan använda flera register i .npmrc-filer med omfång och överordnade källor.

Pipelineautentisering

För att autentisera mot din pipeline rekommenderar Azure Artifacts att du använder uppgiften npm-autentisera.

När du använder aktivitetslöpare som gulp eller Grunt är det att prioritera att ange din npm-autentisera uppgift i början av pipelinen. Det här steget garanterar att dina autentiseringsuppgifter matas in i projektets .npmrc-fil och behålls under hela pipelinekörningen, vilket gör det möjligt för efterföljande steg att komma åt autentiseringsuppgifterna i konfigurationsfilen.

klassiska
YAML

Gå till projektet, välj Pipelinesoch välj sedan din pipelinedefinition.
Välj Redigera för att ändra pipelinen.
Välj + för att lägga till en ny aktivitet i pipelinen.

Gå till projektet, välj Pipelines>Buildsoch välj sedan versionsdefinitionen.
Välj Redigera för att modifiera din bygg-pipeline.
Välj + och lägg till en ny uppgift i byggflödet.

Sök efter uppgiften npm Authenticate och välj sedan Lägg till.
Välj filen .npmrc och välj sedan Spara & kö när du är klar.

- task: npmAuthenticate@0
  inputs:
    workingFile: .npmrc                ## Path to the npmrc file
    customEndpoint: #Optional          ## Comma-separated list of npm service connection names for registries from external organizations. For registries in your org, leave this blank

Not

Om du vill komma åt ditt flöde från pipelinen kontrollerar du att byggtjänstrollen är inställd på Feed och Uppströmsläsare (Deltagare) i Feed-inställningarna >Behörigheter.

En skärmbild som visar rollerna för byggtjänsten i flödesinställningarna.

Obs

Om din organisation använder en brandvägg eller en proxyserver kontrollerar du att du tillåter lämpliga domän-URL:er. Mer information finns i Tillåtna IP-adresser och domän-URL:er.

Felsöka

vsts-npm-auth är inte igenkänt

Det här felet anger att mappen npm-moduler inte har lagts till i sökvägen. Kör konfigurationen av Node.js igen och välj alternativet Add to PATH. Du kan också lägga till mappen npm-moduler i sökvägen genom att ändra PATH-variabeln till %APPDATA%\npm i Kommandotolken eller $env:APPDATA\npm i PowerShell.

En skärmbild som visar hur du konfigurerar node.js.

Det går inte att autentisera

Fel: kod E401 npm ERR! Det går inte att autentisera: –> Kör kommandot vsts-npm-auth med flaggan -F för att autentisera igen:
```
vsts-npm-auth -config .npmrc -F
```

Återställ vsts-npm-auth

Följ dessa steg för att återställa dina vsts-npm-auth-autentiseringsuppgifter:

Avinstallera vsts-npm-auth:
```
npm uninstall -g vsts-npm-auth
```
Rensa npm-cachen:
```
npm cache clean --force
```
Ta bort filen .npmrc.

Installera om vsts-npm-auth:

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

Det går inte att publicera

Om du stöter på ett 403-fel kan det tyda på en namnkonflikt. I Azure Artifacts är paket oföränderliga, vilket innebär att versionsnumret är permanent reserverat när du publicerar ett paket i flödet. Även om du tar bort det kan du inte publicera ett nytt paket med samma versionsnummer. Åtgärda problemet genom att uppdatera paketversionen i package.json-filen och sedan försöka igen.

Dela via

Ansluta npm-projektet till Azure Artifacts

Förutsättningar

Anslut till feeden

Konfigurera autentiseringsuppgifter

Konfigurera autentiseringsuppgifter

Konfigurera autentiseringsuppgifter

Pipelineautentisering

Felsöka

vsts-npm-auth är inte igenkänt

Det går inte att autentisera

Återställ vsts-npm-auth

Det går inte att publicera

Feedback

Ytterligare resurser

Dela via

Ansluta npm-projektet till Azure Artifacts

Förutsättningar

Anslut till feeden

Pipelineautentisering

Felsöka

vsts-npm-auth är inte igenkänt

Det går inte att autentisera

Återställ vsts-npm-auth

Det går inte att publicera

Relaterade artiklar

Feedback

Ytterligare resurser