Freigeben über


Verbinden Ihres npm-Projekts mit Azure Artifacts

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 Startverzeichnis des Benutzers, kann aber auch auf Projektebene erstellt werden, um die Standardeinstellungen außer Kraft zu setzen.

Voraussetzungen

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:

Hinweis

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

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann "Mit Feed verbinden" aus.

    Screenshot, der zeigt, wie Eine Verbindung mit einem Feed in Azure DevOps Services hergestellt wird.

  3. Wählen Sie npm aus der linken Randleiste aus. Wenn Sie azure Artifacts mit npm zum ersten Mal verwenden, stellen Sie sicher, dass Sie die erforderlichen Komponenten installiert haben.

  4. Folgen Sie den Anweisungen im Abschnitt "Project-Setup ", um eine Verbindung mit Ihrem Feed herzustellen.

    Screenshot, der zeigt, wie Sie Ihr npm-Projekt einrichten.

  1. Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann "Mit Feed verbinden" aus.

    Screenshot, der zeigt, wie Sie eine Verbindung mit einem Feed in Azure DevOps Server 2022.1 herstellen.

  3. Wählen Sie npm aus der linken Randleiste aus, und folgen Sie dann den Anweisungen im Project-Setupabschnitt, um Ihre Konfigurationsdatei einzurichten.

    Screenshot, der zeigt, wie Sie Ihr npm-Projekt in Azure DevOps Server 2022.1 einrichten.

  1. Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann "Mit Feed verbinden" aus.

    Screenshot, der zeigt, wie Eine Verbindung mit einem Feed in Azure DevOps Server 2020.1 hergestellt wird.

  3. Wählen Sie "npm" von links aus, und folgen Sie dann den Anweisungen im Project-Setup, um die Konfigurationsdatei einzurichten.

    Screenshot, der zeigt, wie Sie Ihr npm-Projekt in Azure DevOps Server 2020.1 einrichten.

  1. Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann "Mit Feed verbinden" aus.

    Screenshot, der zeigt, wie Sie eine Verbindung mit einem Feed in Azure DevOps Server 2019.1 herstellen.

  3. Ein neues Fenster wird angezeigt. Wählen Sie im linken Navigationsbereich npm aus.

  4. Befolgen Sie die bereitgestellten Anweisungen, um Ihre Projekt - und Benutzer-NPMRC-Dateien zu konfigurieren.

    Screenshot, der zeigt, wie Sie Ihre npmrc-Dateien auf Projektebene und Benutzerebene in Azure DevOps Server 2019.1 einrichten.

Tipp

Die Verwendung mehrerer Registrierungen in NPMRC-Dateien wird mit Bereichen und Upstreamquellen unterstützt.

Pipelineauthentifizierung

Um sich bei Ihrer Pipeline zu authentifizieren, empfiehlt Azure Artifacts die Verwendung der npm-Authentifizierungsaufgabe.

Wenn Sie Aufgabenläufer wie gulp oder Grunt verwenden, müssen Sie die Festlegung Ihrer npm-Authentifizierungsaufgabe am Anfang Ihrer Pipeline priorisieren. 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.

  1. Navigieren Sie zu Ihrem Projekt, wählen Sie "Pipelines" aus, und wählen Sie dann Ihre Pipelinedefinition aus.

  2. Wählen Sie Bearbeiten aus, um Ihre Pipeline zu bearbeiten.

  3. Wählen Sie diese Option + aus, um Ihrer Pipeline eine neue Aufgabe hinzuzufügen.

    Screenshot, der zeigt, wie Sie der Pipeline die npm-Authentifizierungsaufgabe hinzufügen.

  1. Navigieren Sie zu Ihrem Projekt, wählen Sie "Pipelines>Builds" aus, und wählen Sie dann Ihre Builddefinition aus.

  2. Wählen Sie "Bearbeiten" aus, um Die Buildpipeline zu ändern.

  3. Wählen Sie diese Option + aus, um Ihrer Buildpipeline eine neue Aufgabe hinzuzufügen.

    Screenshot, der zeigt, wie Sie der Pipeline die npm-Authentifizierungsaufgabe hinzufügen.

  1. Suchen Sie nach der npm-Authentifizierungsaufgabe, und wählen Sie dann "Hinzufügen" aus.

    Screenshot der npm-Authentifizierungsaufgabe, die der Pipeline hinzugefügt wurde.

  2. Wählen Sie Ihre NPMRC-Datei aus, und wählen Sie dann "Speichern und Warteschlange " aus, wenn Sie fertig sind.

    Screenshot, der zeigt, wie Sie Ihre Datei *.npmrc* hinzufügen.

Hinweis

Um von Ihrer Pipeline aus auf Ihren Feed zuzugreifen, stellen Sie sicher, dass die Builddienstrolle auf Feed und Upstream Reader (Mitwirkender) in den Feedeinstellungen>Berechtigungen festgelegt ist.

Screenshot der Builddienstrollen in Feedeinstellungen.

Hinweis

Wenn Ihre Organisation eine Firewall oder einen Proxyserver verwendet, stellen Sie sicher, dass Sie die entsprechenden Domänen-URLs zulassen. Details finden Sie unter Zulässige IP-Adressen und Domänen-URLs .

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 Add to PATH Option auswählen. Alternativ können Sie den Ordner "npm modules" zu Ihrem Pfad hinzufügen, indem Sie die PATH-Variable %APPDATA%\npm in der Eingabeaufforderung oder $env:APPDATA\npm in PowerShell ändern.

Screenshot, der zeigt, wie node.js eingerichtet werden.

Die Authentifizierung kann nicht ausgeführt werden.

  • Fehler: Code E401 npm ERR! Authentifizierung nicht möglich: -> Führen Sie den vsts-npm-auth Befehl mit -F-Flag aus, um die Authentifizierung erneut zu authentifizieren:

    vsts-npm-auth -config .npmrc -F
    

Zurücksetzen der vsts-npm-auth

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

  1. Deinstallieren Sie vsts-npm-auth:

    npm uninstall -g vsts-npm-auth
    
  2. Löschen Sie den npm-Cache:

    npm cache clean --force
    
  3. Löschen Sie die NPMRC-Datei .

  4. Erneutes Installieren von vsts-npm-auth:

    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 ein Namenskonflikt angezeigt werden. 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.