Verbinden Ihres npm-Projekts mit Azure Artifacts

Artikel
01/03/2025

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

Mit Azure Artifacts können Entwickler ihre Pakete aus verschiedenen Quellen verwalten, einschließlich öffentlicher Registrierungen wie npmjs.com und privaten Feeds. Um sich mit Azure Artifacts zu authentifizieren, müssen Sie Ihre npm-Konfigurationsdatei konfigurieren. Diese Datei enthält Feed-URLs und Anmeldeinformationen, die von npm verwendet werden, und bietet Optionen zum Anpassen des npm-Clientverhaltens, z. B. das Einrichten von Proxys, das Definieren von Standardpaketspeicherorten oder das Konfigurieren privater Paketfeeds. Die .npmrc-Datei befindet sich in der Regel im Home-Verzeichnis des Benutzers, kann aber auch auf Projektebene erstellt werden, um die Standardeinstellungen außer Kraft zu setzen.

Voraussetzungen

Eine Azure DevOps-Organisation. Eines kostenlos erstellen.
Ein Azure DevOps-Projekt. Erstellen Sie ein neues Projekt, wenn Sie noch keines haben.
Ein Azure Artifacts-Feed. Kostenlos eine erstellen.
Node.js und npmherunterladen und installieren.

Verbindung mit Feed herstellen

Azure Artifacts empfiehlt die Verwendung von zwei separaten Konfigurationsdateien. Der erste dient der Authentifizierung mit Azure Artifacts, während die zweite lokal aufbewahrt werden sollte, um Ihre Anmeldeinformationen zu speichern. Mit diesem Ansatz können Sie Ihre Konfigurationsdatei freigeben, während Ihre Anmeldeinformationen sicher bleiben.

Um die zweite Datei einzurichten, platzieren Sie sie einfach in Ihrem Startverzeichnis auf Ihrem Entwicklungscomputer, und fügen Sie alle Ihre Registrierungsanmeldeinformationen ein. Dadurch kann der npm-Client auf einfache Weise auf Ihre Anmeldeinformationen für die Authentifizierung zugreifen.

Die folgenden Schritte führen Sie durch das Einrichten der ersten Konfigurationsdatei. Wählen Sie die Registerkarte aus, die Ihrer Entwicklungsumgebung entspricht:

Anmerkung

vsts-npm-auth wird in Azure DevOps Server nicht unterstützt.

Windows
Linux/MacOS

Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.
Wählen Sie Artefakte, und wählen Sie dann Verbinden mit Feed.
Wählen Sie npm in der linken Seitenleiste. Wenn Sie azure Artifacts mit npm zum ersten Mal verwenden, stellen Sie sicher, dass Sie die erforderlichen Komponenten installiert haben.
Befolgen Sie die Anweisungen in der Einrichtung des Projekts Abschnitt, um eine Verbindung zu Ihrem Feed herzustellen.

Hinzufügen einer .npmrc Datei im Verzeichnis Ihres Projekts, im selben Verzeichnis wie Ihre package.json und fügen Sie den folgenden Textausschnitt ein.
```
registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 

always-auth=true
```

Anmeldeinformationen einrichten

Kopieren Sie das folgende Snippet und fügen Sie es in Ihre Benutzerebene ein npmrc Datei:

Organisationsspezifischer Feed:

; 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

Projektbezogener 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

Erzeugen einer persönliches Zugangs-Token mit Verpackung lesen und schreiben Geltungsbereiche.
Führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster aus, und fügen Sie dann Ihr persönliches Zugriffstoken ein, wenn Sie dazu aufgefordert werden. Kopieren Sie anschließend den generierten Base64-codierten Wert.
```
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(); })"
```
Wenn Sie Linux/Mac verwenden, können Sie alternativ den folgenden Befehl verwenden, um Ihr persönliches Zugriffstoken in Base 64 zu konvertieren. Kopieren Sie den resultierenden Base64-codierten Wert.
```
echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
```
Ersetzen Sie die Platzhalter [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] in Ihrem Benutzer .npmrc Datei mit dem verschlüsselten persönlichen Zugangstoken aus dem vorherigen Schritt.

Windows
Linux/MacOS

Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.
Wählen Sie Artefakte, und wählen Sie dann Verbinden mit Feed.
Wählen Sie npm- auf der linken Randleiste aus, und folgen Sie dann den Anweisungen im Abschnitt Project-Setup, um die Konfigurationsdatei einzurichten.

Hinzufügen einer .npmrc Datei im Verzeichnis Ihres Projekts, im selben Verzeichnis wie Ihre package.json und fügen Sie den folgenden Textausschnitt ein.
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/

always-auth=true
```

Anmeldeinformationen einrichten

Kopieren Sie das folgende Snippet und fügen Sie es in Ihre Benutzerebene ein .npmrc Datei:

Einspeisung in die Sammlung:

; 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

Projektbezogener 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

Erzeugen einer persönliches Zugangs-Token mit Verpackung lesen und schreiben Geltungsbereiche.
Führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster aus, und fügen Sie dann Ihr persönliches Zugriffstoken ein, wenn Sie dazu aufgefordert werden. Kopieren Sie anschließend den generierten Base64-codierten Wert.
```
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(); })"
```
Ersetzen Sie die Platzhalter [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] in Ihrem Benutzer .npmrc Datei mit dem verschlüsselten persönlichen Zugangstoken aus dem vorherigen Schritt.

Windows
Linux/MacOS

Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.
Wählen Sie Artefakte, und wählen Sie dann Verbinden mit Futtermittel.
Wählen Sie npm auf der linken Seite aus, und folgen Sie dann den Anweisungen in Project setup, um die Konfigurationsdatei einzurichten.

Hinzufügen einer .npmrc im Verzeichnis Ihres Projekts, im selben Verzeichnis wie Ihre package.json-Datei, und fügen Sie den folgenden Ausschnitt ein:
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/

always-auth=true
```

Anmeldeinformationen einrichten

Kopieren Sie das folgende Snippet und fügen Sie es in Ihre Benutzerebene ein .npmrc Datei:

Einspeisung in die Sammlung:

; 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

Projektbezogener 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

Erzeugen einer persönliches Zugangs-Token mit Verpackung lesen und schreiben Geltungsbereiche.
Führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster aus, und fügen Sie dann Ihr persönliches Zugriffstoken ein, wenn Sie dazu aufgefordert werden. Kopieren Sie anschließend den generierten Base64-codierten Wert.
```
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(); })"
```
Ersetzen Sie die Platzhalter [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] in Ihrem Benutzer .npmrc Datei mit dem verschlüsselten persönlichen Zugangstoken aus dem vorherigen Schritt.

Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.
Wählen Sie Artefakte, und wählen Sie dann Verbinden mit Futtermittel.
Ein neues Fenster wird angezeigt. Wählen Sie im linken Navigationsbereich npm.
Befolgen Sie die mitgelieferten Anweisungen zur Konfiguration Ihres Projekt und user .npmrc-Dateien.

Tipp

Die Verwendung mehrerer Registrierungen in .npmrc-Dateien wird unterstützt durch Geltungsbereiche und vorgelagerte Quellen.

Pipeline-Authentifizierung

Um sich mit Ihrer Pipeline zu authentifizieren, empfiehlt Azure Artifacts die Verwendung der npm authenticate-Aufgabe.

Bei der Verwendung von Task-Runnern wie Gulp oder Grunt, ist es zu priorisieren, die Einstellung Ihrer npm authenticate-Aufgabe am Anfang Ihrer Pipeline. Dieser Schritt garantiert, dass Ihre Anmeldeinformationen in die NPMRC-Datei Ihres Projekts eingefügt und während der gesamten Pipelineausführung aufbewahrt werden, sodass nachfolgende Schritte auf die Anmeldeinformationen in der Konfigurationsdatei zugreifen können.

Klassisch
YAML

Navigieren Sie zu Ihrem Projekt, wählen Sie Rohrleitungen, und wählen Sie dann Ihre Pipeline-Definition aus.
Wählen Sie Bearbeiten aus, um Ihre Pipeline zu bearbeiten.
Wählen Sie + aus, um Ihrer Pipeline eine neue Aufgabe hinzuzufügen.

Navigieren Sie zu Ihrem Projekt, wählen Sie Rohrleitungen>Baut,und wählen Sie dann Ihre Build-Definition aus.
Wählen Sie bearbeiten um Ihre Build-Pipeline zu ändern.
Wählen Sie + aus, um Ihrer Build-Pipeline eine neue Aufgabe hinzuzufügen.

Suche nach dem npm Authentifizieren Aufgabe, und wählen Sie dann hinzufügen.
Wählen Sie Ihr .npmrc Datei, und wählen Sie dann Speichern Sie & Warteschlange wenn Sie fertig sind.

- 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

Anmerkung

Um von Ihrer Pipeline aus auf Ihren Feed zuzugreifen, stellen Sie sicher, dass die Build-Service-Rolle auf Feed und Upstream-Leser (Mitwirkender) in Ihrem Vorschubeinstellungen>Berechtigungen.

Ein Bildschirmfoto zeigt die Build-Service-Rollen in den Feed-Einstellungen.

Anmerkung

Wenn Ihre Organisation eine Firewall oder einen Proxyserver verwendet, stellen Sie sicher, dass Sie die entsprechenden Domänen-URLs zulassen. Siehe Erlaubte IP-Adressen und Domänen-URLs für Einzelheiten.

Problembehandlung

vsts-npm-auth wird nicht erkannt

Dieser Fehler gibt an, dass der Ordner "npm modules" ihrem Pfad nicht hinzugefügt wurde. Führen Sie das Node.js Setup erneut aus, und stellen Sie sicher, dass Sie die Option Add to PATH auswählen. Alternativ können Sie auch den Ordner "npm modules" zu Ihrem Pfad hinzufügen, indem Sie die PATH-Variable in der Eingabeaufforderung auf %APPDATA%\npm oder in PowerShell auf $env:APPDATA\npm ändern.

Screenshot, der zeigt, wie node.jseingerichtet wird.

Authentifizierung nicht möglich

Fehler: Code E401 npm ERR!konnte nicht authentifiziert werden: -> Führen Sie den Befehl vsts-npm-auth mit dem -F Flag aus, um sich erneut zu authentifizieren.
```
vsts-npm-auth -config .npmrc -F
```

vsts-npm-auth zurücksetzen

Führen Sie die folgenden Schritte aus, um Ihre vsts-npm-auth-Anmeldeinformationen zurückzusetzen:

Deinstallieren Sie vsts-npm-auth:
```
npm uninstall -g vsts-npm-auth
```
Löschen Sie den npm-Cache:
```
npm cache clean --force
```
Löschen Sie Ihre .npmrc Datei.

Installieren Sie vsts-npm-auth neu:

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

Veröffentlichen nicht möglich

Wenn ein 403-Fehler auftritt, kann dies auf einen Namenskonflikt hindeuten. In Azure Artifacts sind Pakete unveränderlich, d. h., nachdem Sie ein Paket in Ihrem Feed veröffentlicht haben, ist die Versionsnummer dauerhaft reserviert. Selbst wenn Sie es löschen, können Sie kein neues Paket mit derselben Versionsnummer veröffentlichen. Um dieses Problem zu beheben, aktualisieren Sie die Paketversion in Ihrer package.json Datei, und versuchen Sie es dann erneut.

Freigeben über

Verbinden Ihres npm-Projekts mit Azure Artifacts

Voraussetzungen

Verbindung mit Feed herstellen

Anmeldeinformationen einrichten

Anmeldeinformationen einrichten

Anmeldeinformationen einrichten

Pipeline-Authentifizierung

Problembehandlung

vsts-npm-auth wird nicht erkannt

Authentifizierung nicht möglich

vsts-npm-auth zurücksetzen

Veröffentlichen nicht möglich

Feedback

Zusätzliche Ressourcen

Freigeben über

Verbinden Ihres npm-Projekts mit Azure Artifacts

Voraussetzungen

Verbindung mit Feed herstellen

Pipeline-Authentifizierung

Problembehandlung

vsts-npm-auth wird nicht erkannt

Authentifizierung nicht möglich

vsts-npm-auth zurücksetzen

Veröffentlichen nicht möglich

Verwandte Artikel

Feedback

Zusätzliche Ressourcen