Veröffentlichen und Herunterladen von npm-Paketen mit Azure Artifacts

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

mit Azure Artifacts können Entwickler npm-Pakete aus Feeds oder öffentlichen Registrierungen veröffentlichen und herunterladen.

Dieser Artikel führt Sie durch das Erstellen eines Feeds, das Konfigurieren Ihres Projekts und das Veröffentlichen und Herunterladen von npm-Paketen.

Voraussetzungen

Einen Feed erstellen

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

  2. Wählen Sie Artefakte und dann Ihren Feed erstellen aus.

  3. Geben Sie einen Namen für Ihren Feed ein.

  4. Wählen Sie eine Sichtbarkeitseinstellung aus, um zu steuern, wer Pakete im Feed anzeigen kann.

  5. Wählen Sie "Pakete aus allgemeinen öffentlichen Quellen einschließen " aus, wenn Ihr Feed upstream-Pakete aus Quellen wie nuget.org oder npmjs.com verwenden soll.

  6. Wählen Sie für "Bereich" aus, ob der Feed auf das aktuelle Projekt oder die gesamte Organisation festgelegt ist.

  7. Wählen Sie Erstellen, wenn Sie fertig sind.

    Screenshot mit den Auswahloptionen zum Erstellen eines neuen Feeds in Azure DevOps Services.

  1. Melden Sie sich bei Ihrem Azure DevOps-Server an und gehen Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed erstellen aus.

  3. Geben Sie einen Namen für Ihren Feed ein.

  4. Wählen Sie eine Sichtbarkeitseinstellung aus, um zu steuern, wer Pakete im Feed anzeigen kann.

  5. Wählen Sie "Pakete aus allgemeinen öffentlichen Quellen einschließen " aus, wenn Ihr Feed upstream-Pakete aus Quellen wie nuget.org oder npmjs.com verwenden soll.

  6. Wählen Sie für "Bereich" aus, ob der Feed auf das aktuelle Projekt oder die gesamte Organisation festgelegt ist.

  1. Wählen Sie Erstellen, wenn Sie fertig sind.

    Screenshot der Auswahl zum Erstellen eines neuen Feeds in Azure DevOps 2022.

Hinweis

Wenn Sie einen Feed erstellen, wird dem Build Service-Konto des Projekts, z. B. projectName Build Service (orgName), standardmäßig die Rolle Feed and Upstream Reader (Mitwirkender) zugewiesen.

Einrichten der npm-Authentifizierung

Bevor Sie eine Verbindung mit einem Feed herstellen, richten Sie die Authentifizierung für den npm-Client auf Ihrem Computer ein. Die Schritte unterscheiden sich je nach Betriebssystem:

Windows

Installieren Sie vsts-npm-auth, das die Anmeldeinformationen generiert und aktualisiert, die npm verwendet, um eine Verbindung mit Ihrem Azure Artifacts-Feed herzustellen.

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

macOS und Linux

vsts-npm-auth wird unter macOS oder Linux nicht unterstützt. Stattdessen erstellen Sie ein persönlichen Zugriffstoken (PAT) mit dem Bereich Packaging>. Verwenden Sie diesen PAT, wenn Sie ihre NPMRC-Datei auf Benutzerebene im nächsten Abschnitt konfigurieren.

Verbinden mit einem Feed

Azure Artifacts empfiehlt die Verwendung von zwei separaten Konfigurationsdateien. Die erste Datei sollte lokal im $HOME Verzeichnis (Linux/macOS) oder im $env.HOME (Windows) gespeichert werden, damit Ihre Anmeldeinformationen sicher gespeichert werden. Auf diese Weise kann der npm-Client auf Ihre Anmeldeinformationen für die Authentifizierung zugreifen.

Mithilfe dieses Setups können Sie die Projektkonfiguration für Ihr Team freigeben, ohne Anmeldeinformationen in der Quellcodeverwaltung verfügbar zu geben. Weitere Details finden Sie unter Herstellen einer Verbindung mit einem Azure Artifacts Feed – npm.

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

  2. Wählen Sie Artefakte aus, wählen Sie Ihren Feed aus dem Dropdownmenü und dann "Mit Feed verbinden" aus.

  3. Wählen Sie npm aus dem linken Navigationsbereich aus.

  4. Wählen Sie unter Project SetupWindows oder "Sonstige" für Ihr Betriebssystem aus, und folgen Sie dann den bereitgestellten Anweisungen, um Ihre NPMRC-Dateien auf Benutzerebene und project Ebene zu aktualisieren.

    Screenshot, der zeigt, wie Sie ein npm-Projekt einrichten und eine Verbindung mit einem Feed in Azure DevOps Services herstellen.

Hinweis

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

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

  2. Wählen Sie Artefakte aus, wählen Sie Ihren Feed aus dem Dropdownmenü und dann "Mit Feed verbinden" aus.

  3. Wählen Sie npm aus dem linken Navigationsbereich aus.

  4. Wählen Sie unter Project SetupWindows oder "Sonstige" für Ihr Betriebssystem aus, und folgen Sie dann den bereitgestellten Anweisungen, um Ihre NPMRC-Dateien auf Benutzerebene und project Ebene zu aktualisieren.

    Screenshot, der zeigt, wie Sie ein npm-Projekt einrichten und eine Verbindung mit einem Azure Artifacts Feed in Azure DevOps Server 2022 herstellen.

Wichtig

npm unterstützt nur eine einzelne registry Einstellung in Ihrer NPMRC-Datei . Wenn Sie Pakete aus mehreren Quellen benötigen, verwenden Sie upstream-Quellen oder Bereiche , anstatt mehrere registry Einträge hinzuzufügen.

Veröffentlichen von Paketen in Ihrem Feed

Hinweis

Um Pakete in einem Feed zu veröffentlichen, müssen Sie ein Feed-Publisher (Mitwirkender) oder höher sein. Weitere Details finden Sie unter Verwalten von Berechtigungen.

Stellen Sie vor dem Veröffentlichen von Paketen sicher, dass Sie sich bei Ihrem Feed authentifizieren. Wenn Sie dies noch nicht getan haben, führen Sie die Schritte im Abschnitt "Mit einem Feed verbinden " aus, und fahren Sie dann mit den Anweisungen im folgenden Abschnitt fort.

  1. Führen Sie im Projektverzeichnis den folgenden Befehl aus, um das in Ihrer package.json Datei definierte Paket in Ihrem Feed zu veröffentlichen:

    npm publish

Wichtig

Die Verwendung der publishConfig-Eigenschaft zum Überschreiben der Registrierungskonfiguration zur Veröffentlichungszeit wird nicht unterstützt.

Wiederherstellen von Paketen aus Ihrem Feed

Bevor Sie Pakete wiederherstellen, stellen Sie sicher, dass Sie sich bei Ihrem Feed authentifizieren und die NPMRC-Dateien für Ihr Projekt aktualisieren. Wenn Sie dies noch nicht getan haben, führen Sie die Schritte in "Mit einem Feed verbinden" aus, und fahren Sie dann fort.

  1. Führen Sie im Projektverzeichnis den folgenden Befehl aus, um alle in der package.json Datei aufgeführten Pakete wiederherzustellen:

    npm install

  2. Führen Sie den folgenden Befehl aus, um ein bestimmtes Paket aus dem Feed zu installieren und es als Abhängigkeit in Ihrer package.json Datei hinzuzufügen:

    npm install --save <PACKAGE_NAME>

Verwandte Inhalte

  • Last updated on