Teilen über


Erste Schritte mit npm-Paketen in Azure Artifacts

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

Mithilfe von Azure Artifacts können Sie Ihre npm-Pakete aus Feeds und öffentlichen Registrierungen wie npmjs.com veröffentlichen und herunterladen. Diese Schnellstartanleitung führt Sie durch das Erstellen Ihres Feeds, das Konfigurieren Ihres Projekts und das Verwalten von npm-Paketen mit Ihrem Azure Artifacts-Feed.

Voraussetzungen

Einen Feed erstellen

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

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

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

    Wählen Sie für sichtbarkeit eine Option aus, um anzugeben, wer Pakete innerhalb des Feeds anzeigen kann.

    Wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, aktivieren Sie das Kontrollkästchen unter Upstreamquellen.

    Geben Sie für "Scope" an, ob der Bereich Ihres Feeds das Projekt oder die Organisation ist.

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

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

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

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

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

    Wählen Sie für sichtbarkeit eine Option aus, um anzugeben, wer Pakete innerhalb des Feeds anzeigen kann.

    Wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, aktivieren Sie das Kontrollkästchen unter Upstreamquellen.

    Geben Sie für "Scope" an, ob der Bereich Ihres Feeds das Projekt oder die Organisation ist.

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

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

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

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

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

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

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

    Wählen Sie für sichtbarkeit eine Option aus, um anzugeben, wer Pakete innerhalb des Feeds anzeigen kann.

    Wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, wählen Sie die Option "Pakete aus öffentlichen Quellen verwenden" aus.

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

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

Hinweis

Standardmäßig haben neu erstellte Feeds den Builddienstwert ihres Projekts auf Feed und Upstream Reader (Mitarbeiter) festgelegt.

Herstellen einer Verbindung mit einem Feed

Hinweis

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

Azure Artifacts empfiehlt die Verwendung von zwei NPMRC-Dateien. Der erste sollte im $home Verzeichnis (Linux/macOS) oder $env platziert werden. HOME (Windows), um Ihre Anmeldeinformationen sicher zu speichern. Auf diese Weise kann der npm-Client die Datei suchen und Ihre Anmeldeinformationen für die Authentifizierung abrufen, sodass Sie Ihre Konfigurationsdatei freigeben können, ohne Ihre Anmeldeinformationen verfügbar zu machen. In diesem Abschnitt richten wir die zweite NPMRC-Datei ein, die in demselben Verzeichnis wie Ihre package.json Datei platziert werden sollte.

  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.

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

  4. Befolgen Sie die Anweisungen im Abschnitt "Project-Setup ", um Ihre Konfigurationsdatei einzurichten und eine Verbindung mit Ihrem Feed herzustellen.

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

  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.

  3. Wählen Sie "npm" von links aus, und folgen Sie dann den Anweisungen im Project-Setupabschnitt, um eine Verbindung mit Ihrem Feed herzustellen.

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

  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.

  3. Wählen Sie "npm" von links aus, und folgen Sie dann den Anweisungen im Project-Setup, um Die Konfigurationsdatei einzurichten und eine Verbindung mit Ihrem Feed herzustellen.

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

  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.

  3. Ein neues Fenster wird angezeigt. Wählen Sie im linken Navigationsbereich npm aus, und folgen Sie den Anweisungen, um Ihre Projekt- und Benutzer-NPMRC-Dateien einzurichten.

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

Wichtig

npm unterstützt eine einzelne registry in Ihrer NPMRC-Datei. Mehrere Register sind mit Bereichen und vorgelagerten Quellen möglich.

Veröffentlichen von Paketen

Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus, um Ihre npm-Pakete zu veröffentlichen:

npm publish

Wichtig

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

Pakete wiederherstellen

Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus, um die npm-Pakete wiederherzustellen:

npm install

Führen Sie zum Wiederherstellen eines bestimmten npm-Pakets den folgenden Befehl aus Ihrem Projektverzeichnis aus:

npm install --save <PACKAGE_NAME>